client/desktop · 集群 B · 桌面进阶配置 · 6/6

读懂客户端日志：日志级别、连接面板与常见错误信息解读

两个排障工具：连接面板与日志

桌面代理客户端一般提供两个用于排障的界面：连接面板和日志面板。它们回答的问题不同，配合使用效果最好。

两者的名称和位置可能随客户端版本变化，例如“连接”“Connections”“日志”“Logs”等，以实际界面为准。如果想了解日志与抓包在更底层排障中的分工，可以参考技术专题中的 抓包与日志分析入门。

读懂连接面板

连接面板中的每一行代表一条连接，常见字段包括：

使用方法：

1. 在搜索框中输入目标域名的一部分进行过滤；
2. 查看该连接的规则与链路，确认是否符合预期；
3. 如果规则不对，参考 Clash 规则分流配置 调整；
4. 如果根本找不到该连接，说明流量没有进入客户端。

调整日志级别

日志级别决定记录的详细程度。常见级别从简到详大致为：静默、错误、警告、信息、调试。名称可能因客户端而异。

日志详细程度：
静默 ─ 错误 ─ 警告 ─ 信息 ─ 调试
 少 ◀─────────────────────────▶ 多

日常使用：警告 / 信息
一般排障：信息
深入排障：调试（结束后调回）

为什么排障结束要调回？ 调试级别会产生大量日志，增加资源占用，并且记录的访问信息更多，从隐私角度看也不宜长期开启。

一条日志的结构

一条典型的连接日志通常包含以下信息，具体格式因内核和客户端而异：

[时间] [级别] [来源地址:端口] --> [目标域名:端口] match [规则] using [策略/节点]

读日志时，按“时间 → 目标 → 规则 → 节点 → 结果”的顺序看。对于失败的连接，日志通常会在后面附上错误信息，下一节解读常见错误。

常见错误信息的一般含义

不同内核的报错措辞不同，下表按含义归类，帮助你判断问题方向。这只是一般性说明，具体以日志原文和项目文档为准。

几个容易被忽视的要点：

• 系统时间错误会导致握手与证书类错误，校准时间成本最低；
• 订阅过期或流量用尽时，节点可能全部失败，先查看用户中心状态；
• 配置解析错误往往来自自定义覆写内容的格式问题，例如缩进或策略组名称写错。

DNS 相关错误的原理见 DNS 污染是什么，订阅相关问题见 桌面客户端订阅更新。

用日志排障的完整流程

把连接面板和日志结合起来，可以形成一套固定的排障流程：

① 复现问题：访问出问题的网站或打开出问题的软件
      │
      ▼
② 连接面板中搜索目标
      ├─ 找不到 → 流量未进入客户端 → 检查系统代理 / 考虑 TUN
      └─ 找到 ↓
③ 看规则与节点
      ├─ 规则不对 → 调整规则
      ├─ 节点不对 → 切换节点
      └─ 都对 ↓
④ 日志中查看该连接的错误信息
      ├─ 超时 / 拒绝 → 节点或网络层
      ├─ 重置 / 握手失败 → 订阅、时间、协议
      └─ 解析失败 → DNS 设置
      │
      ▼
⑤ 只改一个变量，重复①验证

更系统的方法论见 分层排障法。如果问题指向 TUN，参考 桌面端 TUN 模式开启指南。

分享日志前的脱敏

向服务商或他人求助时，附上日志能大大提高效率，但分享前务必脱敏：

建议只截取与问题相关的十几行，而不是整份日志，并通过服务商的正式工单渠道发送。更多隐私建议见 安全与隐私 专题。

小结

连接面板看“去哪了”，日志看“为什么”。排障时先用连接面板确认流量是否进入客户端、规则与节点是否正确，再到日志中找错误原因，并按“只改一个变量”的原则验证。掌握这套方法，大多数客户端问题都能自己定位。

若排查后确认需要更换服务，可以前往 机场品牌库 查看各品牌资料，或使用 对比工具 并排比较，数据来自品牌资料，本站未实测，请以实际测试为准。