SC-04DIAGNOSTICS · EXCLUSIVE

SC-04 · 日志排障为三站统一入口（运维优先读本篇）

Clash Verge Rev 日志诊断 | 三步排查 · 错误码表 · 样本日志

日志诊断

1. 日志来源优先级

  1. 应用内「日志」窗口（实时）
  2. ~/.config/clash-verge/logs/（持久化）
  3. sidecar stderr（高级，与内核日志合并）

外传前脱敏规则 → VR-B06

2. 三步排查法

1

内核是否存活

设置页状态 + 任务管理器/htop 中 mihomo/clash-meta 进程。

正常：进程存在且 CPU 偶发波动
异常：无进程 → 点「重启内核」，仍失败进步骤 3
2

API 健康

curl -v -H "Authorization: Bearer $SECRET" http://127.0.0.1:9097/version
正常：< HTTP/1.1 200 OK + JSON version
401：secret 错误 → 重启内核
连接拒绝：端口未监听 → 步骤 3
3

配置与日志关键字

在最新日志搜：unmarshal、parse、listen tcp、fatal。

3. 错误码 / 关键字对照表

日志片段含义处理
listen tcp 127.0.0.1:9097: bind: address already in useAPI 端口占用结束占用进程或改端口
yaml: unmarshal errors订阅/YAML 语法错误校验上游；clash -t
context deadline exceeded拉订阅超时网络/DNS/代理环
x509: certificate signed by unknown authorityTLS 中间人导入企业根证书
unsupported protocol节点类型内核不支持升级客户端或换节点
Start Mixed http+socks server error7897 等端口占用netstat/ss 排查

4. 样本：正常启动日志特征

[INFO] configuration file ... loaded
[INFO] RESTful API listening at: 127.0.0.1:9097
[INFO] Mixed(http+socks) proxy listening at: 127.0.0.1:7897

缺第二行而 UI 显示运行中 → 典型「托盘正常 API 无响应」，架构原因见 rev-clash 架构解析。

5. 日志级别调整

设置 → 日志级别：排障用 debug，恢复后改 info。debug 下日志量可达数十 MB/日。

6. 重置流程（仍失败时）

  1. 托盘 → 重启内核
  2. 设置 → 恢复默认（注意备份 profiles）
  3. 删除 profiles.yaml 缓存后重新导入订阅
  4. 自 Release 重装

7. 平台专项委派