Clash Verge Rev 與 mihomo 常見錯誤疑難排解

代理用戶端出狀況時，畫面上往往只有一句很短的錯誤訊息，看不出問題出在哪一層。實務上 Clash Verge Rev 與 mihomo 的錯誤來源相當集中：連接埠被占用、設定檔寫錯、訂閱抓不下來、系統代理殘留、TUN 權限不足，這五類幾乎涵蓋了大部分回報。

這篇按照「先看記錄檔 → 依症狀分類 → 逐項處理」的順序整理常見錯誤與對應做法。如果你的狀況是「軟體看起來正常在跑，但就是連不上網」，請直接看分層疑難排解指南，那篇更對症。

先看記錄檔，再動手改設定

不看記錄檔就開始亂調設定，是最浪費時間的做法。Clash Verge Rev 介面裡有專門的記錄頁面，可以即時看到核心輸出；如果你是直接執行 mihomo 核心，訊息會印在終端機裡，Linux 上以 systemd 託管時則用這道指令查看：

journalctl -u mihomo -f

讀記錄檔只要抓三個重點：第一次報錯的關鍵字（常見的有 address already in use、unmarshal、timeout）、發生時間，以及它出現在啟動階段還是連線階段。啟動階段的錯誤幾乎都指向設定檔或連接埠，連線階段的錯誤才需要往節點與規則去查。（介面配置可能隨版本略有差異，以你目前的版本為準。）

連接埠被占用：address already in use

核心啟動時要監聽本機的混合代理連接埠與外部控制連接埠，只要其中一個已被其他程式占用，啟動就會失敗。最常見的原因是舊程序沒有正常結束，或你同時開了兩套代理軟體。

在 Windows 上找出占用者：

netstat -ano | findstr 7897
tasklist | findstr 12345

第一道指令會列出占用該連接埠的程序 PID，把第二道指令裡的數字換成實際 PID，就能看出是哪個執行檔。macOS 與 Linux 可以改用 lsof -i :7897 達到相同效果。確認之後有兩條路：結束占用中的程序，或在用戶端設定裡把混合連接埠換成沒被使用的數字。預設的混合連接埠可以在設定頁面查看（常見為 7890 或 7897），改完記得同步更新瀏覽器或指令列工具裡的連接埠。

核心啟動失敗：多半是設定檔寫壞了

如果記錄檔裡出現 YAML 解析相關的字眼，問題通常不在程式而在設定檔。mihomo 內建校驗參數，可以在正式啟動前先驗一次：

mihomo -t -f config.yaml

校驗訊息通常會附上行號，順著行號往上下各看兩行，多半能找到這幾種老問題：縮排混用空白與 Tab、冒號後面忘了空格、從網頁複製設定時帶進全形冒號或全形空格、同一層出現重複的鍵。對設定檔結構還不熟的話，可以先讀設定檔入門。

注意：手動修改設定檔之前先複製一份備份。訂閱更新時可能覆蓋本機檔案，把你改過的內容洗掉。

訂閱抓不下來怎麼處理

訂閱更新失敗的錯誤訊息通常是逾時或 HTTP 狀態碼。依序確認三件事：

連結本身是否還有效：把訂閱網址貼到瀏覽器開一次，如果拿到的是空白內容或錯誤頁，就得回服務商後台重新取得。
是不是要先有網路才抓得到：部分訂閱位址在直連狀態下存取不到，這時可先切到能連線的節點，或換個網路環境再更新。
格式是否相容：Clash 系用戶端需要 Clash/mihomo 格式的訂閱，拿到只支援其他生態的分享連結時，用戶端會直接判定為無效設定。

三項都排除仍然失敗，就把訂閱內容另存成本機檔案再匯入，藉此確認問題出在抓取還是解析。

系統代理殘留與 TUN 啟動失敗

系統代理設定不上或關不掉

典型症狀是關掉用戶端之後所有網頁都打不開，因為系統仍指向一個已經不存在的本機代理。到作業系統的網路設定裡把手動代理關閉即可復原。若每次開關都失敗，多半是權限問題，或有其他軟體搶著寫同一組設定，此時改用 TUN 模式反而更省事。

TUN 開不起來

三個常見原因：服務模式沒安裝成功、執行權限不足、與其他 VPN 或虛擬網路卡衝突。處理順序是先在用戶端裡重新安裝服務並以系統管理員身分執行一次，再把其他 VPN 軟體完全結束後重試。Windows 上若安裝服務的過程被防毒軟體攔下，請看安全性提示與誤判處理。

求助之前先準備好這些資訊

求助前先整理下面幾項，通常能省下好幾輪來回問答：

作業系統與版本（例如 Windows 11、macOS 15、Ubuntu 24.04）。
用戶端名稱與版本，以及核心版本（本站目前提供 Clash Verge Rev 2.5.2 與 mihomo v1.19.29）。
目前使用的模式：系統代理還是 TUN、規則模式還是全域模式。
記錄檔中報錯那幾行的原文，貼文字而不是貼你的轉述。
你已經試過哪些做法。

另外提醒：貼記錄檔或截圖之前，把訂閱網址、節點位址這類敏感內容遮掉。至於 macOS 上卡在「已損毀，無法打開」的情況，那屬於另一類問題，請直接看對應的解決方法。