Clash 啟動日誌:先分辨視窗關閉還是核心停止

開啟用戶端後視窗消失,先確認系統匣或選單列是否還有圖示。有些用戶端關閉視窗後仍會在背景執行;另一些用戶端的視窗還在,但核心子程序已結束,因此顯示連線失敗。排查時記下點擊啟動的時間,只重試一次,再比對同一時段的介面日誌、核心日誌與系統紀錄。這樣可避免把多次啟動的不同錯誤混在一起。

  • 視窗仍可開啟:如果用戶端提供「日誌」和「核心日誌」兩個入口,先查看核心日誌中最早出現的錯誤,再確認介面日誌是否記錄了啟動的核心路徑及實際載入的設定檔路徑。
  • Windows 視窗一閃即逝:開啟「事件檢視器」→「Windows 記錄」→「應用程式」,依啟動時間尋找相關錯誤。如果有「應用程式錯誤」紀錄,查看發生錯誤的應用程式名稱和模組名稱,判斷結束的是用戶端本身還是核心。一般設定檔載入失敗不一定會出現在這裡。
  • macOS 視窗一閃即逝:前往「應用程式」→「工具程式」→「主控台」,搜尋對應時間的當機報告。若找不到報告,再查看用戶端儲存的啟動日誌;有些程序會在輸出錯誤後自行結束,不會產生當機報告。
日誌片段接下來檢查
yaml: line 12開啟實際載入的 YAML 檔案,從第 12 行往上檢查縮排和清單結構。
address already in use依同一筆日誌中的位址、連接埠和通訊協定,查找監聽中的程序。
no such file or directory先確認遺失的是核心、設定檔還是規則檔,再依錯誤訊息中的完整路徑檢查。
exec format error檢查核心檔案格式,以及安裝套件是否符合目前的作業系統和處理器架構。

YAML 設定錯誤:從錯誤行往前檢查上一個欄位

日誌指出第 12 行,不代表錯的是第 12 行。例如第 11 行的字串引號沒有成對,解析器可能要讀到下一行才報錯。先依日誌提供的路徑開啟檔案,使用純文字編輯器顯示行號和空白字元。支援訂閱合併或覆寫的用戶端,核心讀取的通常是產生後的設定檔,而非訂閱原文。請用產生的檔案定位問題,找到原因後再修改本機覆寫或訂閱來源,避免下次更新時修改內容被覆蓋。

先檢查格式,再確認規則引用

  1. 同一層級的欄位要對齊,縮排使用空格,不要用 Tab。例如 mixed-port: 7890 這類鍵值對,英文冒號後要留一個空格。檢查前兩三行是否有引號未成對,以及清單項目前是否漏了 -。
  2. 如果檔案開頭是 <!doctype html>,下載到的可能是登入頁面或錯誤頁面。請回到訂閱來源確認網址和輸出格式,不要把網頁當成 YAML 修正,也不要將含有存取權杖的訂閱網址貼到公開的求助文章。
  3. 如果日誌指出策略群組或規則集不存在,請確認規則結尾的目標名稱與 proxy-groups 中的名稱一致,並確認 RULE-SET 引用對應到 rule-providers 中的鍵。YAML 格式可解析,不代表其中的引用有效。若將設定從 mihomo 改回舊版 Clash 核心,也要確認該版本支援使用中的欄位和規則類型。

使用本機最小設定隔離訂閱與覆寫

先透過用戶端匯出設定,或在退出用戶端後備份原設定,再將以下幾行另存為 test.yaml,不要覆蓋目前使用的訂閱。此範例只在本機監聽混合代理連接埠,規則比對後一律直連,不會測試代理節點。如果 7890 已遭占用,先依下一節確認可用的連接埠,再進行啟動測試。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

如果手邊有相同版本的獨立 mihomo 執行檔,可以使用 -t 檢查設定。以下範例在 Windows PowerShell 中執行,假設目前目錄已有 mihomo.exe、test.yaml,以及供本次測試使用的空目錄 clash-test-home:

.\mihomo.exe -t -d .\clash-test-home -f .\test.yaml

此處的 -d 用來指定核心工作目錄,-f 用來指定設定檔。測試通過後,仍須實際啟動一次,才能確認連接埠監聽和用戶端啟動流程都正常。測試原設定時,如果設定依賴工作目錄中的規則或其他資源,改用空目錄可能會另外出現檔案遺失錯誤;不要將這類錯誤誤判為 YAML 語法錯誤。

7890 連接埠遭占用:依位址和通訊協定確認程序

mixed-port 是 HTTP 和 SOCKS 代理共用的監聽連接埠;external-controller 則是控制介面的位址。實際錯誤也可能來自 DNS 監聽位址。如果日誌顯示 listen tcp 127.0.0.1:7890,請查詢 TCP 7890;如果錯誤指向控制介面 127.0.0.1:9090,只修改混合連接埠無法解決控制介面衝突。也要留意 0.0.0.0:7890 這類萬用位址,它可能已涵蓋回送位址上的監聽需求。

Windows:先找出監聽紀錄,再確認 PID

netstat -ano -p tcp | findstr ":7890"

查看「本機位址」欄是否剛好以 :7890 結尾,並確認狀態為 LISTENING。篩選結果也可能包含遠端連接埠剛好是 7890 的連線,不能把那一列當成占用端口的程序。最後一欄是 PID,可前往「工作管理員」→「詳細資料」查找對應程序。如果錯誤訊息指出 UDP,請使用 netstat -ano -p udp 查詢對應的本機連接埠;UDP 結果沒有 TCP 的監聽狀態欄。

macOS:直接列出 TCP 監聽程序

lsof -nP -iTCP:7890 -sTCP:LISTEN

查看輸出中的 COMMAND 和 PID 欄確認程序。如果是 UDP 連接埠,改用 lsof -nP -iUDP:7890,並將 7890 換成日誌中的實際連接埠。一般使用者帳號不一定能看到所有程序;沒有結果也可能是占用者已經結束,最好在錯誤剛出現時立即比對。

核心檔案遺失:確認路徑、安裝套件和系統架構

用戶端介面和代理核心是不同部分。應用程式圖示還在,不代表啟動時需要的核心檔案仍然存在。便攜版只把主程式從壓縮檔中拖出,或升級後仍指向舊目錄,都可能讓介面找不到核心。如果日誌指出啟動子程序失敗,先確認錯誤路徑指向的是執行檔;如果路徑指向規則集、地理資料或設定檔,應還原對應資源或修正工作目錄,而不是更換核心。

  1. 確認檔案位置。依日誌所列的完整路徑檢查檔案。便攜套件應完整解壓縮至本機目錄,並保留原有的目錄結構;安裝版應優先使用同一用戶端的發行套件修復,不要隨意將其他用戶端的核心改名後放入。
  2. 確認作業系統與架構。在 Windows「設定」→「系統」→「系統資訊」中查看「系統類型」,分辨 x64 和 ARM64。macOS 可從蘋果選單 →「關於這台 Mac」判斷使用 Apple 晶片或 Intel 處理器。發行頁標示 arm64、x64 或 universal 時,請依專案的作業系統和架構說明選擇。
  3. 確認是否遭系統封鎖。在 Windows「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」中核對時間和路徑。macOS 可在「系統設定」→「隱私權與安全性」查看相關提示。如果套件來源不明,或系統指出具體風險,請先停止執行,再從專案可信任的發行管道重新下載;排查時不要關閉整體防護。
  4. 確認是否為 TUN 啟動失敗。如果日誌已顯示設定載入完成、本機代理開始監聽,之後才出現虛擬介面、路由或權限錯誤,代表核心並未遺失。若能開啟用戶端,先關閉 TUN 選項,再測試一般監聽;若透過本機設定控制,可在測試副本中將現有 tun 區段內的 enable 改為 false,不要另外新增第二個同名區段。關閉後若能啟動,再依用戶端說明單獨檢查服務或權限需求。

最小設定仍會閃退:隔離用戶端狀態,再逐項還原

如果相同版本的獨立核心能以最小設定啟動,但圖形用戶端仍一開就退出,接著要檢查用戶端本身的狀態,例如自動還原上次使用的設定、自動啟用 TUN,或升級後殘留的核心路徑。先正常退出應用程式,並確認背景沒有殘留程序,再依用戶端文件找到資料目錄。如果專案支援重建使用者資料,可先備份,再暫時將舊目錄改名,讓應用程式建立新目錄;不要直接刪除舊目錄,也不要一次混合複製新舊資料。

  1. 先以全新狀態開啟介面,只載入最小設定。退出後再開啟一次,確認不會因還原上次狀態而再次閃退。
  2. 還原訂閱並確認能啟動後,再分別還原覆寫和規則。每新增一項就重新啟動一次;最後才還原系統代理或 TUN。只有最小直連設定能啟動,代表已隔離部分原因,並不能證明訂閱節點可用。
  3. 若仍無法啟動,請記錄作業系統版本、用戶端版本、核心版本、最近一次變更,以及第一則錯誤訊息前後的幾行日誌。提交日誌前,請遮蔽訂閱網址、權杖、節點登入資訊和本機使用者名稱;只保留最後一行結束提示,通常不足以判斷原因。