本文目錄
先確認是介面失聯，還是核心真的沒有啟動
首頁顯示「核心通訊錯誤」、目前節點為空，通常會讓人以為代理已經完全停止。先不要刪除訂閱，也不要立刻改 DNS。開啟「日誌」和「連線」頁面，再用瀏覽器存取一個新網頁，觀察是否出現剛才的網域和出站記錄。
如果網頁仍能開啟，日誌也持續出現 TCP 或 UDP 連線，說明 Mihomo 可能還在轉發，只是桌面介面沒有讀到代理群組和目前節點。近期官方 issue 就記錄過這種狀態：系統代理指向的本機連接埠仍能工作，執行階段設定也包含節點，但首頁和代理頁無法讀取控制資訊。
先按表現分組
| 你看到的現象 | 更可能的問題 | 本文從哪裡開始 |
|---|---|---|
| 網頁能存取，日誌持續新增，代理頁空白 | 介面與核心的控制通訊異常 | 先更新版本，再檢查服務模式 |
| 網頁不能存取，日誌沒有新連線 | 核心未啟動或請求沒有進入用戶端 | 檢查設定驗證、服務和本機連接埠 |
| 訂閱更新後節點數量為零 | 訂閱內容或解析失敗 | 回到訂閱更新錯誤，不處理控制通道 |
| 只有一個網站失敗 | 規則、DNS 或目標網站相容問題 | 固定節點並查看該網域的命中記錄 |
優先安裝套件含通訊狀態修復的正式版本
Clash Verge Rev v2.5.2 的官方發布說明列出了「修復首頁代理卡片可能錯誤顯示通訊異常」「修復首頁目前代理狀態偶爾不同步」和「修復重新載入 Clash 設定後規則頁面資料未及時重新整理」。如果問題出現在 v2.5.1 或更早版本，更新正式版比修改控制器連接埠更直接。
從專案官方 Release 或本站標明來源的下載頁選擇與 Windows 架構一致的安裝套件。更新前匯出日誌並記下目前訂閱名稱，安裝完成後完整退出一次用戶端，再重新開啟。不要同時改訂閱、TUN、DNS 和服務模式，否則無法判斷是哪一步起效。
一次可核對的更新
記錄目前版本和錯誤
在關於頁面記下版本，截圖首頁提示和代理頁狀態，匯出一份不含訂閱連結的日誌。
下載匹配架構的正式包
大多數 Windows 電腦使用 x64，ARM Windows 裝置才選擇 ARM64；只從可追溯發布來源下載。
關閉用戶端後安裝
先退出系統匣中的 Clash Verge Rev，確認安裝程式完成，再用普通使用者身分啟動。
只測試原來的 Profile
暫時保持原節點、Rule 模式和系統代理設定，查看代理群組是否恢復。
代理頁仍為空時，查有沒有兩份核心搶同一個連接埠
更新後仍發生錯誤，先開啟任務管理器的「詳細資訊」。正常服務模式下會看到桌面程式、服務處理程式和一份 Mihomo 核心；如果同時存在兩份 verge-mihomo.exe，舊處理程式可能佔著 mixed-port 或命名管道，新核心就無法完整啟動。
不要一看到多個帶 Clash 名稱的處理程式就全部強制結束。先從系統匣退出用戶端，等幾秒後再看 verge-mihomo.exe 是否仍有兩份。若日誌出現 bind、Only one usage、Access is denied 或 pipe listen error，才把重點放在殘留處理程式、連接埠佔用和服務狀態。
Get-Process clash-verge, verge-mihomo -ErrorAction SilentlyContinue
Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 7897 |
Select-Object LocalAddress, LocalPort, OwningProcess
Get-Process -Id (Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 7897 |
Select-Object -First 1 -ExpandProperty OwningProcess)命令只用於確認監聽者，不會結束處理程式。Mixed 連接埠可能不是 7897，應以用戶端設定或日誌中的實際值替換。看到單個 verge-mihomo.exe 正常監聽，且日誌已經出現代理請求，就不要繼續把問題當成連接埠衝突。
日誌中的第一條錯誤決定下一步
服務模式啟動時，用戶端會先產生執行階段設定並驗證，再讓服務啟動核心，最後透過控制介面讀取代理群組。只看末尾的「通訊錯誤」會漏掉真正失敗的位置。重新啟動一次後，從日誌頂部往下找第一條 error。
設定驗證失敗、Invalid YAML 或 unsupported field
問題發生在 Profile 或覆寫。切回未修改的訂閱，暫時停用 Merge、指令碼和自訂欄位，再重新驗證。
mixed port bind failed、Only one usage
本機連接埠已被舊核心或其他程式佔用。退出用戶端，確認監聽處理程式，再重啟 Windows 清理殘留狀態。
pipe listen error、Access is denied
服務建立控制通道失敗或權限不一致。先重啟用戶端服務，仍失敗再重新安裝服務模式。
設定驗證成功、連接埠和 pipe 都在監聽，但介面仍發生錯誤
更像桌面介面讀取控制資訊失敗。確認已經更新正式版，並匯出日誌提交給專案 issue，不要繼續改節點。
核心啟動成功，但沒有任何新連線
檢查 Windows 系統代理是否仍指向目前 Mixed 連接埠；若使用 TUN，再確認虛擬網路介面卡是否真正開啟。
Windows 防火牆只做一次可還原的重新整理
Clash Verge Rev 官方 Windows FAQ 把「代理選單空白」歸因到核心通訊失敗，並建議關閉再開啟 Windows 防火牆。這裡的重點是讓防火牆規則重新載入，不是長期關閉防護。
先在 Windows 安全中心開啟「防火牆和網路保護」，記下目前網路類型。短暫關閉對應網路的 Microsoft Defender 防火牆，立即重新開啟，然後退出並重啟 Clash Verge Rev。若公司電腦由管理員策略控制，不要繞過策略，直接把日誌交給管理員檢查應用和本機通訊規則。
防火牆重新整理後確認
- Microsoft Defender 防火牆已經重新開啟
- 沒有為了測試而新增面向公用網路的入站連接埠
- Clash Verge Rev 和服務處理程式沒有被安全軟體隔離
- 重新開啟用戶端後，代理群組能顯示並可切換節點
設定裡有節點，不代表介面一定能讀到
訂閱下載、執行階段設定和代理頁展示是三個不同階段。訂閱頁顯示更新時間，只能證明位址儲存並完成過一次處理；執行階段 YAML 裡出現 proxies 和 proxy-groups，說明核心拿到了節點；代理頁還要透過控制介面讀取這些組。
近期官方診斷記錄中，執行階段設定包含代理與策略群組，Mixed 連接埠也在轉發，但 external-controller 為空，只剩命名管道供桌面介面讀取。這種情況下自行開放 HTTP 控制器並不是首選修復，還可能擴大管理介面暴露。應先完成正式版更新、服務重啟和防火牆重新整理。
三個階段怎麼驗證
| 階段 | 有效證據 | 失敗時不要做什麼 |
|---|---|---|
| 訂閱下載 | 更新成功並顯示實際節點數量 | 不要只看訂閱名稱已經出現 |
| 核心執行 | 日誌顯示設定驗證成功、連接埠監聽和實際連線 | 不要用首頁卡片單獨判斷核心已死 |
| 介面控制 | 代理群組可見、目前節點可讀且切換生效 | 不要為讓介面恢復而公開 external-controller |
確認服務異常後，再重裝服務模式
只有日誌明確指向服務、管道權限或重複核心，並且更新與防火牆重新整理都無效時，才處理服務模式。先關閉系統代理和 TUN，確認普通網路恢復，再從用戶端設定中的服務模式入口卸載服務，重啟 Windows 後重新安裝。
重裝服務不會修復失效訂閱，也不該成為每次代理頁空白的固定動作。若重啟後沒有管理員權限、按鈕被策略停用或服務安裝被安全軟體攔截，應停止反覆嘗試，保留匯出的應用日誌與服務日誌。
安全恢復順序
先恢復 Windows 直連
關閉系統代理和 TUN，用瀏覽器確認退出用戶端後普通網頁仍能開啟。
備份 Profile 與日誌
不要公開訂閱 URL、節點密碼或控制器 secret，問題報告只附脫敏片段。
卸載並重啟
透過用戶端提供的服務模式入口卸載，不手動刪除系統服務檔案；完成後重啟 Windows。
重新安裝服務模式
用用戶端正常入口申請管理員權限，啟動後只啟用原 Profile 做驗證。
仍失敗就停止改設定
附版本、系統架構、第一條 error、處理程式與連接埠結果，提交到官方 issue。
修復完成要同時透過五項檢查
代理頁重新出現並不等於問題徹底結束。最後用同一份 Profile、同一個節點完成一次從介面到實際存取的閉環，才能確認服務、控制通道和轉發都恢復。
完成標準
- 首頁不再顯示核心通訊錯誤，目前代理模式與節點名稱可讀
- 代理頁能看到完整策略群組，切換節點後選中狀態立即更新
- 任務管理器中只有一份正在工作的 verge-mihomo.exe
- 瀏覽器存取測試網站時，連線頁出現對應網域、規則和出站
- 退出用戶端後 Windows 系統代理會關閉，普通網路能夠恢復