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,同时留意隐私说明中的另一种目录写法 |
| 日志文件持续变大 | 调整记录级别,并检查自动清理设置 |
| 已经复现,准备提交反馈 | 复制当天对应文件,检查敏感内容后再提交 |
如果还无法描述故障,可以先对照常见报错的排查方向,把发生条件与看到的现象记下来。不要只写“不能用”,也不要仅凭目录名称判断故障原因。
改完级别,要退出重启后再复现
导出日志说明要求修改记录级别后退出软件,再重新启动,让日志覆盖启动过程。
可以按下面的顺序准备文件:
- 修改日志级别,退出软件后重新启动。
- 重做触发故障的操作,确认问题再次出现。
- 到对应目录查找当天的日志。
- 同一天有多个文件时,选序号最大的一个。
- 将选中的文件复制出来,留作检查和反馈。
不要在重新触发问题之前就导出。否则,准备提交的文件可能尚未包含这次故障。挑选文件时按日期和序号核对;具体命名规则,官方没有说明。
怎样读:先对应故障,再看记录
阅读前先保留三个信息:做了什么、何时发生、看到了什么。把这些信息与复现后取得的文件放在一起,便于说明记录对应哪次操作。
官方没有说明逐行字段的解释、实时日志界面的读法,以及日志级别的完整清单和差异。因此,不能把某个词直接解释成确定原因,也不能把不同页面提到的级别拼成完整列表。
现有说明能确认的用途如下:
| 出处 | 提到的级别及语境 |
|---|---|
| 导出日志说明 | 文件过大时可调回 INFO |
| 常见问题说明 | 磁盘被日志占用时,可设为 Silent 或 Error |
| 配置案例 | 示例中出现 log-level: warning |
这些内容来自不同页面,不能据此推导界面中的排列顺序,或认定它们在所有场景下可以互换。
文件太大时,兼顾记录与清理
截至 2026-11-08,导出说明建议在日志过大时改回 INFO;常见问题说明则给出 Silent、Error,并提示设置自动清理间隔。
截至 2026-11-08,隐私说明记载,应用日志预设保存 7 天。保留时间可在“设置 → 杂项设置 → 自动清理日志”调整;选择“不清理”后会持续保留。
准备反馈时,先复制需要的文件,再处理保留设置。清理解决的是已有文件的占用,调整级别影响后续记录,两项需要分别检查。
提交前检查隐私内容
内核日志可能随记录级别包含请求域名、IP 和连接元数据。提交问题前,应同时检查日志与配置,将令牌、连接信息和不便公开的访问域名打码。
反馈说明可附上故障现象、复现操作、所选日志目录,以及是否已退出重启。涉及版本变动的情况,可另看更新与回滚的已知说明;公开文件前,可核对日志与配置的隐私事项。
第三方整理,与项目方无关。