Clash Verge Rev(clash-verge-rev 仓库)的日志从应用数据目录查找。排查时先分清问题涉及应用界面还是内核运行,再修改记录级别、退出重启、复现故障,随后复制对应日志。截至 2026-11-08,最新版本为 v2.5.10。

从数据目录找到日志

截至 2026-11-08,隐私说明列出的应用数据目录如下。它们是查找起点,不是具体日志文件的位置。

系统应用数据目录
Windows%APPDATA%\io.github.clash-verge-rev.clash-verge-rev
macOS~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev
Linux$XDG_DATA_HOME/io.github.clash-verge-rev.clash-verge-rev

Linux 的数据目录一般位于 ~/.local/share/ 下,继续查找同名应用目录。

应用日志与服务日志的目录写法,在两份文档中存在差异:

来源文档给出的目录
导出日志说明GUI 日志放在 logs,内核日志放在其下的 service 子目录,即 logs/service
隐私说明应用日志与特权服务日志分别放在 logs/ 和 service-logs/,位置在应用数据目录内

这两种写法应分别保留。目录差异的原因,官方没有说明。查找时可对照本机实际目录,并在反馈中写明文件来自哪个位置,不要把两种服务日志路径当成同一个目录。

按现象选择文件和处理方向

日志的用途是把故障发生时的记录留下来。选择文件前,先用一句话写清楚出现了什么现象。

现象处理方向
问题涉及应用界面查看 logs 中的 GUI 日志
问题涉及内核运行按导出说明查找 logs/service,同时留意隐私说明中的另一种目录写法
日志文件持续变大调整记录级别,并检查自动清理设置
已经复现,准备提交反馈复制当天对应文件,检查敏感内容后再提交

如果还无法描述故障,可以先对照常见报错的排查方向,把发生条件与看到的现象记下来。不要只写“不能用”,也不要仅凭目录名称判断故障原因。

改完级别,要退出重启后再复现

导出日志说明要求修改记录级别后退出软件,再重新启动,让日志覆盖启动过程。

可以按下面的顺序准备文件:

  1. 修改日志级别,退出软件后重新启动。
  2. 重做触发故障的操作,确认问题再次出现。
  3. 到对应目录查找当天的日志。
  4. 同一天有多个文件时,选序号最大的一个。
  5. 将选中的文件复制出来,留作检查和反馈。

不要在重新触发问题之前就导出。否则,准备提交的文件可能尚未包含这次故障。挑选文件时按日期和序号核对;具体命名规则,官方没有说明。

怎样读:先对应故障,再看记录

阅读前先保留三个信息:做了什么、何时发生、看到了什么。把这些信息与复现后取得的文件放在一起,便于说明记录对应哪次操作。

官方没有说明逐行字段的解释、实时日志界面的读法,以及日志级别的完整清单和差异。因此,不能把某个词直接解释成确定原因,也不能把不同页面提到的级别拼成完整列表。

现有说明能确认的用途如下:

出处提到的级别及语境
导出日志说明文件过大时可调回 INFO
常见问题说明磁盘被日志占用时,可设为 Silent 或 Error
配置案例示例中出现 log-level: warning

这些内容来自不同页面,不能据此推导界面中的排列顺序,或认定它们在所有场景下可以互换。

文件太大时,兼顾记录与清理

截至 2026-11-08,导出说明建议在日志过大时改回 INFO;常见问题说明则给出 Silent、Error,并提示设置自动清理间隔。

截至 2026-11-08,隐私说明记载,应用日志预设保存 7 天。保留时间可在“设置 → 杂项设置 → 自动清理日志”调整;选择“不清理”后会持续保留。

准备反馈时,先复制需要的文件,再处理保留设置。清理解决的是已有文件的占用,调整级别影响后续记录,两项需要分别检查。

提交前检查隐私内容

内核日志可能随记录级别包含请求域名、IP 和连接元数据。提交问题前,应同时检查日志与配置,将令牌、连接信息和不便公开的访问域名打码。

反馈说明可附上故障现象、复现操作、所选日志目录,以及是否已退出重启。涉及版本变动的情况,可另看更新与回滚的已知说明;公开文件前,可核对日志与配置的隐私事项。

第三方整理,与项目方无关。