日志级别是排查Clash连接异常的核心工具,本文详解Debug/Info/Warning/Error四级区别,提供Windows、macOS及移动端的具体设置路径,并附代理组调试技巧与常见故障分析。
日志级别的作用与选择
Clash日志级别决定系统记录信息的详细程度,日常使用中,Info级别已足够;遇到节点 handshake 失败或规则匹配异常时,需切换至Debug查看完整TCP握手过程。
四级区别如下:
- Debug:记录所有数据包流向,包括DNS解析、TCP连接建立、规则匹配细节,文件体积大,仅用于故障排查。
- Info:记录代理切换、节点延迟测试结果、配置文件加载状态,推荐日常使用。
- Warning:仅记录潜在错误,如节点响应超时、证书验证失败。
- Error:仅记录致命错误,如配置文件语法错误、内核启动失败。
各平台设置步骤
Windows/macOS(Clash Verge Rev)
- 打开客户端,点击左侧「设置」图标
- 找到「日志等级」下拉菜单,选择
debug或info - 点击「重启内核」使配置生效
- 返回主界面,点击右上角「日志」按钮查看实时输出
# 配置文件手动指定(config.yaml) log-level: debug external-controller: 127.0.0.1:9090
Android(FlClash)
- 进入「配置」标签页
- 展开「日志记录」选项
- 选择「详细程度」为
Debug - 返回主界面,通过「日志」功能查看实时连接状态
代理组类型与日志分析
理解日志需先明确代理组工作逻辑:
Select(手动选择)
日志显示[TCP] 127.0.0.1:xxxxx --> target.com:443 using 🔰节点选择/香港节点,若出现dial error,说明该节点TCP层不通。
URL-Test(自动测速)
日志周期性输出url-test: 香港节点: 45ms,当主节点延迟超过阈值,自动切换触发ProxyGroup: 自动选择 => 新加坡节点。
Fallback(故障转移)
日志显示fallback: 主节点 unreachable, switch to 备用节点,适合学术资源访问场景,确保主线路故障时自动切换备用专线。
TUN模式与系统代理的日志差异
系统代理仅处理HTTP/HTTPS流量,日志中显示[TCP] 127.0.0.1:xxxxx,适用于浏览器跨境办公。
TUN模式接管所有流量(含UDP/游戏),日志增加[UDP] 192.168.1.2:xxxxx --> 8.8.8.8:53条目,若游戏延迟高,需在Debug日志中检查UDP包是否被正确转发至节点。
分流规则排查技巧
日志中规则匹配顺序决定流量走向:
# 配置示例 rules: - DOMAIN-SUFFIX,google.com,节点选择 - IP-CIDR,142.250.0.0/16,DIRECT - GEOIP,CN,DIRECT - MATCH,节点选择
当访问google.com时,Debug日志显示Rule matched: DOMAIN-SUFFIX,google.com,节点选择,若错误匹配至GEOIP,CN,需检查规则优先级或DNS解析结果是否被污染。
常见问题排查
现象:日志显示dial tcp i/o timeout
原因:节点TCP连接建立失败,可能是端口被封或节点离线。
解决:切换至url-test自动组,或检查本地防火墙是否拦截Clash进程。
现象:大量DNS resolve failed
原因:本地DNS未指向Clash,或远程DNS解析异常。
解决:确认系统DNS为0.0.1(TUN模式),或在配置中启用enhanced-mode: redir-host。
现象:Debug日志无输出 原因:日志级别未正确应用,或客户端未重启内核。 解决:修改设置后必须点击「重启内核」,部分客户端需完全退出后重新打开。
节点质量与日志的关系
日志中的延迟数据反映节点真实性能,频繁出现timeout或connection reset的节点,即使测速显示低延迟,实际稳定性也不适合4K视频或视频会议,建议通过长期日志观察,选择Error级别记录最少的节点作为主力。
对于需要稳定国际网络加速的用户,建议选择提供专线节点的服务商,并在配置中启用url-test自动剔除异常节点,确保跨境办公与学术资源访问的连续性。