日志级别决定Clash记录信息的详细程度,合理设置能快速定位节点连接与规则匹配问题,本文详解GUI客户端与配置文件两种设置方式,并说明不同场景下的级别选择策略。
日志级别的作用与分类
Clash日志级别控制内核记录诊断信息的粒度,直接影响故障排查效率,级别从低到高分为:silent(静默)、error(仅错误)、warning(警告)、info(常规信息)、debug(调试详情)。
日常使用中,info为推荐基准值,可记录节点切换与规则匹配概况;遇到连接异常或规则失效时,临时切换至debug可捕获DNS解析、TCP握手等底层细节,生产环境长期运行建议保持warning,避免日志文件过度膨胀。
Clash日志级别怎么设置:两种配置路径
GUI客户端可视化设置
以Clash Verge Rev为例:
- 打开客户端,进入「设置」-「应用目录」确认配置路径
- 点击「配置」标签,选择当前生效的订阅文件
- 在右侧编辑区找到
log-level字段,或点击「日志」面板直接切换级别下拉框 - 保存后点击「重启内核」使配置生效
Mac端ClashX Pro用户可通过菜单栏图标→配置→日志级别实时切换,无需重启服务。
配置文件手动修改
在YAML配置文件中添加或修改:
# 基础配置段 log-level: debug # 可选:silent/error/warning/info/debug # 进阶:配合外部控制器实时查看 external-controller: 127.0.0.1:9090 secret: ""
修改后需重载配置文件,Web UI(如yacd-meta)可在「日志」标签页实时过滤不同级别信息。
关联核心概念:日志与代理架构
代理组类型对日志的影响
不同代理组在日志中呈现不同特征:
- Select(手动选择):日志记录
[TCP] 域名:端口 --> 节点名,切换节点时产生明确变更记录 - URL-Test(自动测速):debug级别下可见
url-test: fetch test url与延迟数据,用于排查自动切换异常 - Fallback(故障转移):日志中
fallback: dial error提示触发故障转移的具体原因
TUN模式与系统代理的日志差异
TUN模式接管所有流量(含UDP/游戏流量),日志中可见[UDP] 进程名:端口条目,适合排查DNS泄漏或游戏加速问题;系统代理仅处理HTTP/HTTPS请求,日志相对简洁,但无法记录不遵循系统代理设置的流量。
调试国际网络加速问题时,TUN模式需关注[TUN] hijack dns条目,确认DNS请求被正确拦截。
分流规则调试技巧
日志是验证分流规则的唯一标准,当配置DOMAIN-SUFFIX,google.com,Proxy后,在debug日志中应观察到:
[TCP] 192.168.1.100:xxxx --> www.google.com:443 match DomainSuffix(google.com) using Proxy
若显示using DIRECT,需检查规则优先级(DOMAIN精确匹配优先于DOMAIN-SUFFIX)及配置文件加载顺序。
常见问题排查(FAQ)
现象:日志文件快速增长至数GB
原因:长期开启debug级别记录完整TCP payload
解决方法:定期清理日志目录,或配置log-level: warning配合external-ui仅保留内存日志
现象:节点延迟测试正常但无法访问学术资源
原因:URL-Test仅测试TCP握手,未验证TLS指纹或SNI拦截
解决方法:切换至debug级别查看dial tcp后的TLS握手详情,确认证书链完整
现象:游戏延迟高但日志无UDP记录
原因:系统代理未接管UDP流量,或TUN模式未启用
解决方法:开启TUN模式并设置log-level: info,确认日志出现[UDP] 游戏进程名条目
节点订阅与日志优化建议
对于跨境办公需求,建议选择提供Clash原生YAML格式的服务商,避免频繁转换导致日志中节点名乱码,优质订阅通常支持自动切换的url-test组,配合info级别日志可监控节点稳定性。
若需长期稳定访问国际网络,可考虑具备专线中转的订阅服务,这类节点在日志中表现为稳定的TCP connected而非频繁的dial error。
掌握Clash日志级别怎么设置是网络调优的基础技能,根据使用场景灵活切换级别,结合代理组类型与分流规则分析日志,可快速定位90%以上的连接异常,建议日常保持info级别,问题排查时临时启用debug,调试完成后及时回调避免性能损耗。