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

先記錄现象，再按層排除

記錄發生時间、准確错誤文字、当前版本、系統版本和最近一次改动。先復现一次，再從最接近现象的一層開始，不要同時更换程式、設定和網路。

1. 記錄准確现象和發生時间
2. 確認用戶端、核心、系統和設定版本
3. 读取日誌中的第一条明確错誤
4. 一次只改變一個變量
5. 保存每次成功或失败结果
6. 復原後再清理临時設定

無法安裝或無法啟動

檢查下載是否完整、架构是否匹配、系統權限和安全提示是否明確。便携版还要確認压缩包已完整解压，旧進程没有占用檔案。

設定匯入、登錄或復原异常

確認输入内容未被聊天軟體折行、没有多余空格，並且格式確實适用于当前用戶端。帳號復原类應用程式應先確認復原資訊完整，再处理旧設備。

顯示正常但功能不可用

依次核對当前設定、目标節點或服務状態、系統代理、DNS 與 TUN。每次只修改一層並復测，保留日誌中第一条明確错誤。 把核心日誌、用戶端界面状態和操作系統代理状態分開記錄。核心啟動成功不代表應用程式流量已经被系統正確转發。

只有部分程式或功能异常

若浏览器正常而某個程式异常，优先檢查该程式是否使用独立代理、QUIC、虚拟机、容器或自身 DNS。先做同一網路下的對照测試。

DNS、系統代理與 TUN 冲突

系統代理负责愿意遵循代理設定的程式，TUN 负责更广泛的流量接管，DNS 决定域名解析。三者同時修改会让問題难以定位，應從預設值逐項启用。

怎样读取日誌並安全求助

日誌中最有价值的是故障發生時附近的第一条明確错誤。求助時提供版本、系統、復现步驟和已做测試，但必须遮盖订阅連結、令牌、復原码、私钥和節點凭證。

復原到最近可用状態

撤销最後一次改动，復原已確認可用的設定或版本，再驗證最小功能。確認復原後再清理临時檔案，避免把唯一可用的備份一起删除。

敏感資訊與隱私保护

订阅連結、復原码、私钥、節點凭證和完整调試日誌可能包含敏感資訊。截图前遮盖，不要上传到来源不明的在線检测網站。

相关頁面