Mihomo（原 Clash Meta） 故障排查中心：按现象逐层定位

先记录现象，再按层排除

记录发生时间、准确错误文字、当前版本、系统版本和最近一次改动。先复现一次，再从最接近现象的一层开始，不要同时更换程序、配置和网络。

1. 记录准确现象和发生时间
2. 确认客户端、核心、系统和配置版本
3. 读取日志中的第一条明确错误
4. 一次只改变一个变量
5. 保存每次成功或失败结果
6. 恢复后再清理临时设置

无法安装或无法启动

检查下载是否完整、架构是否匹配、系统权限和安全提示是否明确。便携版还要确认压缩包已完整解压，旧进程没有占用文件。

配置导入、登录或恢复异常

确认输入内容未被聊天软件折行、没有多余空格，并且格式确实适用于当前客户端。账号恢复类应用应先确认恢复信息完整，再处理旧设备。

显示正常但功能不可用

依次核对当前配置、目标节点或服务状态、系统代理、DNS 与 TUN。每次只修改一层并复测，保留日志中第一条明确错误。 把核心日志、客户端界面状态和操作系统代理状态分开记录。核心启动成功不代表应用流量已经被系统正确转发。

只有部分程序或功能异常

若浏览器正常而某个程序异常，优先检查该程序是否使用独立代理、QUIC、虚拟机、容器或自身 DNS。先做同一网络下的对照测试。

DNS、系统代理与 TUN 冲突

系统代理负责愿意遵循代理设置的程序，TUN 负责更广泛的流量接管，DNS 决定域名解析。三者同时修改会让问题难以定位，应从默认值逐项启用。

怎样读取日志并安全求助

日志中最有价值的是故障发生时附近的第一条明确错误。求助时提供版本、系统、复现步骤和已做测试，但必须遮盖订阅链接、令牌、恢复码、私钥和节点凭证。

恢复到最近可用状态

撤销最后一次改动，恢复已确认可用的配置或版本，再验证最小功能。确认恢复后再清理临时文件，避免把唯一可用的备份一起删除。

敏感信息与隐私保护

订阅链接、恢复码、私钥、节点凭证和完整调试日志可能包含敏感信息。截图前遮盖，不要上传到来源不明的在线检测网站。

相关页面