FlClash 日志怎么看：各平台日志打开位置与常见报错排查步骤
简答：在 FlClash 中查看日志，只需进入软件主界面左侧或底部的“日志”（Logs）页面即可实时捕获运行信息 <a href="https://github.com/chen08209/FlClash"></a>。若遇到连接失败或订阅无法更新，可优先通过日志中的关键词（如 <code>timeout</code>、<code>403 Forbidden</code>、<code>Handshake failed</code>）判断是网络超时、节点失效还是本地 TUN 虚拟网卡配置问题。
定义：FlClash 日志是客户端在运行代理核心（mihomo/Clash Meta）时记录的底层网络请求、规则匹配、DNS 解析及错误提示的文本记录，是排查网络连接故障的核心工具 <a href="https://github.com/chen08209/FlClash"></a>。
一、 各平台如何打开 FlClash 日志？
FlClash 采用了跨平台统一的 UI 设计（基于 Flutter），不同设备上查看日志的路径基本一致。请根据你当前使用的系统按步骤操作：
- Android / 鸿蒙（模拟或兼容环境）：打开 FlClash 应用，点击侧边栏或底部导航栏的“日志”（或文本/终端图标选项），即可进入实时日志界面。
- Windows / macOS / Linux：在桌面客户端主界面中，点击左侧导航栏的“日志”标签页。在这里你可以看到滚动的运行日志，并支持复制关键文本。
提示：若日志滚动过快，可在界面上方寻找暂停或清空按钮（以当前客户端实际版本界面为准），以便仔细查看某一条特定的报错信息。
二、 FlClash 日志常见报错与排查对照表
当网络不通或配置异常时，FlClash 日志会吐出具体的错误代码。对照下表可以快速定位问题根源：
| 日志关键词 / 现象 | 可能原因 | 排查与处理步骤 |
|---|---|---|
timeout / context deadline exceeded | 网络连接超时，本地无法触达目标节点服务器 | 1. 检查本地 Wi-Fi 或蜂窝网络是否畅通； 2. 尝试切换节点或测试延迟。 |
403 Forbidden / Unauthorized | 订阅链接失效、IP 被拦截或链接填写错误 | 1. 在浏览器直接打开订阅链接核实是否能下载配置； 2. 登录服务后台重新复制订阅链接并在 FlClash 中更新。 |
handshake failed / tls: bad certificate | TLS 握手失败，通常因本地系统时间不正确或证书异常 | 1. 检查电脑或手机的系统日期与时间是否同步； 2. 检查是否开启了本地代理软件冲突。 |
tun device create failed / permission denied | TUN 模式所需的高权限或系统虚拟网卡驱动初始化失败 | 1. Windows 下尝试以管理员身份运行 FlClash； 2. Android 下确保授予了 VPN 权限。 |
三、 进阶：如何调整日志级别获取更多细节
默认情况下，FlClash 可能只记录常规运行级别的日志。如果遇到难以复现的诡异断连，可以尝试调整日志详细程度：
- 进入 FlClash 的“设置”或“高级设置”页面 。
- 找到日志级别（Log Level）选项 。
- 将日志级别从
info修改为debug。 - 返回日志页面，重新触发断连或故障，此时日志会打印出更详细的底层握手与分流匹配过程。
注意：Debug 级别会产生大量的文本记录，排查完成后建议调回默认的 info 级别，以免占用过多内存。
常见问题
FlClash 日志里一直提示 timeout 怎么办？
这通常说明本地网络无法连接到代理节点服务器。请先检查本地网络是否能正常访问常规网页，若网络正常则是节点服务器宕机或被封锁，建议切换其他可用节点或检查本地防火墙设置。
为什么我的 FlClash 日志界面一片空白？
刚打开软件或刚导入配置时可能没有产生网络请求。你可以尝试访问一个网页，或者在设置中检查内核是否成功启动。如果核心崩溃，日志也会停止刷新。
如何把 FlClash 日志导出发送给他人求助？
在客户端的“日志”页面中，通常提供有复制日志或导出文本的按钮。你可以将关键的报错文本复制并发送，但请注意遮挡日志中的节点密码、IP 地址等个人隐私信息。