找不到日志,先检查捕获开关
遇到订阅更新失败或连接异常,日志能帮助你记录错误发生的时间和应用返回的信息。但 FlClash 的「日志等级」与「日志捕获」不是同一个设置:仅看见或调整日志等级,并不代表日志入口已经显示。
本文适用于仍在维护的 FlClash v0.8.99 正式版、Windows 11、amd64 / arm64、简体中文界面,并附真实英文标签。步骤对照该版本固定源码、界面字典与上游测试核对,未在 Windows 客户端实机点选验证;不套用 Clash Verge Rev、Clash for Windows 或 Android 的日志路径。
前提是 FlClash 能正常打开、进入设置。若程序启动前就崩溃,本文的界面流程不适用,也不能据此推断磁盘上的崩溃日志位置。本次不需要重装客户端、下载补丁或修改 YAML;保留当前配置、代理模式和日志等级,先只检查捕获开关。
打开日志捕获,再返回日志页面
- 在主窗口打开「工具」(Tools),找到「设置」(Settings)分区,点击「常规」(General)。这里的“设置”是分区标题,不是另一个需要先点开的页面。
- 在常规页面找到「日志与诊断」(Logs and diagnostics),记录「日志捕获」(Logcat)原来的开关状态。若已打开,保持不变;若关闭,打开它。该版本的初始默认值为关闭,旧配置可能已改变这一状态。
- 开关即时生效,没有额外的保存按钮,也不会自动跳到日志页。返回主界面,在主导航中打开「日志」(Logs)。不要继续在常规设置里寻找日志正文。
- 记下当前时间,再做一次原本失败的操作,然后回到日志页查看相邻时间的记录。例如排查一次订阅更新失败,就只重试一次更新;不必为了产生日志同时更换订阅、切换节点或开启 TUN。
没有新记录时,先确认捕获仍开启、相关操作确实发生且核心正常运行,并检查有没有搜索条件遮住内容。记录少也可能与当前日志等级有关;不要默认它是 info,本版初始配置的等级是 error,已有配置可能不同。本文不要求先切换到 debug;需要更详细记录时,应按维护者对具体问题的要求另行调整。
日志等级、捕获和搜索分别影响什么?
| 设置或操作 | 作用 | 不能据此认定 |
|---|---|---|
| 日志捕获 Logcat | 显示日志入口,并控制核心日志订阅的开始与停止 | 关闭不等于删除已有记录,也不保证所有应用内部日志停止 |
| 日志等级 Log level | 影响核心输出哪些等级的日志 | 改变等级或记录变少,不代表问题已经消失 |
| 日志页搜索、等级标签筛选 | 帮助从当前列表中找到相关记录;点击等级标签可加入筛选条件 | 筛选后的可见列表不是导出文件的范围 |
日志页可以同时出现核心事件和带 [APP] 标记的应用日志。先看时间、等级和具体错误,再描述你当时做了什么;不要仅凭一条 error 就认定节点失效。本文不逐一解释所有报错,也不把日志页当成完整的历史访问记录。
页面展示的是有限长度的内存缓冲,旧记录可能被挤出;程序重新启动或配置重新加载也可能使这批记录不再保留。复现后及时保存,不要先重启再寻找刚才那一次错误。向上翻看时暂停自动跟随,只是改变列表的滚动与显示,不等于停止采集。
保存一份日志,分享前检查实际文件
需要留存时,在日志页使用提示为「导出日志」(Export logs)的导出按钮。在 Windows 保存对话框中选择你有写入权限的本地目录,确认文件名后保存。默认名称格式为 FlClash_YYYY-MM-DD.log;这是格式示意,实际日期由导出时的系统时间生成。同一天再次保存,优先使用新的文件名,避免覆盖还要保留的记录。
成功后应用会提示「导出成功」(Export successful)。随后用文本编辑器打开实际保存的文件,确认包含这次复现前后的时间与错误。不要只凭文件名判断内容正确;取消保存对话框不算成功保存,出现错误也不要假定目标文件完整。
搜索结果不是脱敏结果:导出读取的是当前日志缓冲区,而不是只保存筛选后看到的几行。文件中可能包含访问域名、IP、节点名称、订阅地址、Token 或本机路径。不要未经检查就把整份文件、截图或完整订阅链接发到公开 Issue、群聊或在线分析站。
在本地副本中仅保留与错误相邻、足以说明问题的片段,遮去凭据和不愿公开的地址,同时保留时间、错误类型及必要上下文。再从文本编辑器复制这段脱敏内容,并附上 FlClash 版本、Windows 版本和复现动作。这里指普通文本编辑器的复制,不是 FlClash 内另有一个“复制全部”按钮。
排查结束后恢复捕获状态
回到 Tools → Settings → General → Logs and diagnostics,把 Logcat 恢复到操作前的状态。如果原本关闭,就关闭它;如果原本开启且仍需观察,可以保持开启。关闭后日志入口会隐藏,核心日志订阅会停止,这不是清空按钮,也不会替你删除已经保存到磁盘的 .log 文件。
带 [APP] 的应用内部日志仍可能写入缓冲,不应把这个开关理解为“彻底禁止任何日志”。本次无需删除配置、清空应用数据或重置所有设置。已经公开的凭据无法靠关闭捕获或删除本地文件收回;若误发了订阅 Token,应到对应服务商处撤销或重置。
最终要留下的是一段能对应具体操作、已经检查并脱敏的记录,而不是越多越好的日志包。若文件中找不到本次问题,重新确认捕获、时间与实际日志等级,再做一次有范围的复现;不要靠补写日志或猜测报错原因填空。
官方来源与版本边界
- FlClash v0.8.99 官方发布
- 固定源码:工具与常规入口
- 固定源码:日志捕获开关
- 上游测试:开启捕获后不自动跳转
- 固定源码:日志列表、筛选与导出按钮
- 固定源码:日志缓冲与导出范围
- 固定源码:文件保存与取消
- 固定源码:核心日志订阅的开始与停止
- 固定源码:独立的应用日志写入
版本号、文件名和界面文字可能随项目更新而变化,操作前请以链接中的项目文档为准。