本文是一张速查表：在 Logs 页面看到报错时按图索骥。日志格式随内核版本略有差异，抓关键词即可。

连接类

日志关键词含义与处理
dial tcp ... i/o timeout连目标（或节点）超时。偶发可忽略；集中出现看是哪个节点，换节点或按全超时排查。
connect: connection refused目标端口拒绝连接。节点端口变了（更新订阅）或目标服务本身没开。
EOF / connection reset by peer连接被对端掐断。单个网站如此=该站封了节点 IP，换节点；所有网站如此=节点或线路被干扰。
no such host域名解析失败。查 DNS 配置；也可能就是域名写错/已失效。
use of closed network connection连接切换期间的正常噪音（切节点、断开全部连接时成片出现），无需处理。

启动与配置类

日志关键词含义与处理
bind: address already in use端口被占，见端口冲突。
yaml: line N: mapping values are not allowed配置第 N 行 YAML 语法错误（缩进/冒号后没空格是重灾区）。
proxy N: unsupport proxy type / unknown field配置里有内核不认识的协议或字段（订阅含新协议节点）。该节点被跳过，其余不受影响；节点大量缺失时见内核版本说明。
rule ... error: proxy [X] not found规则指向了不存在的代理组名（改配置时改了组名没改规则），整份配置会加载失败。
start tun interface errorTUN 启动失败，见 TUN 排查。

订阅与 provider 类

日志关键词含义与处理
provider ... initial failed / update failed规则集或节点 provider 下载失败。多为需要代理才能访问其 URL：先连上任一节点，再重载配置。
404 / 403 / 429（更新订阅时）订阅链接失效、被封或请求过频，见订阅失败排查。

阅读日志的三个习惯

  1. 先看时间戳：只看你复现问题那几秒的日志，历史报错会误导判断。
  2. 关注重复模式：同一条错误对同一目标高频重复，比零星一条有诊断价值。
  3. 配合 Connections 页面交叉验证：日志说超时，连接页看它命中的规则和节点，两边一对上，原因就清楚了。
提示：找不到对应条目时，把日志里的英文关键词（去掉 IP 和端口）直接搜索，Clash 系客户端共享同一套内核报错，社区讨论量很大。