說明中心 / 操作與疑難排解

Clash 常見問題
與故障排除

先確認設定已啟用,再檢查流量入口,最後查看規則與日誌。依問題所在環節展開答案,每次只調整一項設定。

訂閱與設定 系統代理與 TUN DNS 與分流

概念與選擇

基礎知識

分清用戶端、核心與流量入口,再選擇適合的運作方式。

Clash 用戶端、mihomo 核心與訂閱各自負責什麼?

先在用戶端的設定頁匯入訂閱,再啟用設定並選擇策略群組。用戶端提供視窗、選單列與系統整合功能;mihomo 核心負責接收連線、解析 DNS、比對規則及轉送流量;訂閱則提供伺服器參數,有時也包含策略群組與規則。安裝用戶端本身不會建立可用的代理服務。排查時先分辨問題出在視窗設定、核心啟動,還是訂閱內容,避免把三者混為一談而反覆重新安裝。

規則、全域、直連模式該怎麼選?

日常使用建議先選規則模式,再到連線頁查看實際比對到的規則與出口。規則模式會依設定逐條決定直連或代理;全域模式會將進入核心的連線交由全域策略處理,仍須選擇可用出口;直連模式則直接連線至目標。全域模式適合短時間比對測試,無法取代應用程式流量接管。若應用程式根本沒有連進核心,切換模式也不會改變結果。測試結束後切回規則模式,並重新建立連線,避免舊連線影響判斷。

系統代理和 TUN 模式有什麼不同?需要同時啟用嗎?

瀏覽器等會遵循系統代理設定的應用程式,先使用系統代理即可;若要接管不讀取系統代理的應用程式或部分 UDP 流量,再考慮使用 TUN。系統代理會修改作業系統的代理入口;TUN 則透過虛擬網路介面與路由接收流量,並需要相應權限。同時啟用兩者的效果取決於用戶端實作與路由設定。排查時一次只測試一種入口,確認連線記錄出現後再調整組合;也要留意是否有其他 VPN 正在接管預設路由。

下載 Clash 時,如何確認晶片與用戶端相容?

在 macOS 開啟蘋果選單中的「關於這台 Mac」:若顯示 Apple 晶片,請選擇 Apple 晶片安裝檔;若顯示 Intel 處理器,則選擇 Intel 安裝檔。Windows 可在設定的系統資訊中查看系統類型;Android 則依裝置架構與用戶端需求選擇安裝檔。請一併確認下載頁上的用戶端說明與發行方要求,尤其是最低系統版本。mihomo 核心套件主要適用於命令列、伺服器與路由器;需要圖形介面時,請選擇具備視窗與設定管理功能的用戶端。

匯入與授權

安裝與設定

依序檢查訂閱匯入、設定載入、權限授權與連接埠監聽。

訂閱連結要貼在哪裡?本機 YAML 檔又該如何匯入?

開啟用戶端的設定頁,選擇新增或匯入設定,將完整的訂閱 URL 貼到連結欄位;下載完成後,將該設定設為目前使用項目。本機檔案則選擇匯入檔案;若用戶端支援,也可以拖放 config.yaml。匯入後先確認設定名稱與錯誤訊息,再前往代理頁選擇策略群組。不同用戶端的按鈕名稱可能略有差異,但匯入、啟用設定、選擇出口這三個步驟都要依序完成。訂閱 URL 中的存取憑證請完整保留,也不要貼到公開討論區。

匯入訂閱時顯示格式錯誤或 YAML 解析失敗,該怎麼處理?

先查看錯誤訊息是否有標示行號,再確認下載內容是 Clash 或 mihomo 可辨識的 YAML,而非登入頁、錯誤網頁或其他用戶端專用格式。YAML 縮排須使用空格,同層欄位也要對齊;手動編輯時尤其要留意冒號後的空格與清單層級。一般的 Base64 節點清單不一定能直接作為完整設定啟用,請向服務提供者索取相符的訂閱格式。修改前先保留原始檔案,修正後再重新載入設定;不要將含有憑證的完整設定交給不明的轉換網站。

TUN 顯示權限不足、服務未安裝或建立虛擬網卡失敗,該怎麼辦?

先關閉 TUN,在用戶端設定中找到服務模式、輔助服務或權限安裝入口,依照提示完成系統授權後,再重新啟用 TUN。Windows 通常需要安裝並啟動具有系統管理員權限的背景服務;macOS 可能需要授權特權輔助程式,請依用戶端提示操作。若仍然失敗,查看日誌中的權限、裝置或路由錯誤,並暫時關閉其他 VPN 後重試。不要只為了解決權限提示,就長期以高權限執行所有應用程式;受機構管理的裝置,應先確認網路與安全政策允許相關操作。

Clash 連接埠衝突,或終端機沒有走代理,該從哪裡調整?

先在用戶端設定中確認實際監聽的 mixed-port,以及監聽位址是否為本機迴圈位址。若顯示連接埠已被占用,請關閉另一個代理程序,或將監聽連接埠改為未使用的連接埠,再同步修改使用該連接埠的應用程式。終端機工具可能不會讀取系統代理,可用 curl -x http://127.0.0.1:7890 https://example.com 明確測試代理,其中的連接埠請換成目前的實際值。若需要設定環境變數,只在需要的終端機工作階段設定,測試結束後清除;不要為了本機連線而任意開放區域網路監聽。

策略與驗證

使用技巧

將自訂設定放在可保留的位置,並透過連線記錄確認實際效果。

策略群組中的 select、url-test 和 fallback 要怎麼用?

先查看策略群組類型,再決定要手動選擇或等待自動測試。select 會保留手動選擇的結果,適合固定出口;url-test 會依設定的測試網址與檢測週期選擇候選項目;fallback 則按順序選擇測試可用的候選項目,著重於故障切換。測試結果只代表與指定測試網址的連線狀況,不能代表所有服務。若某個網站無法開啟,先手動固定一個出口進行比對,再檢查規則命中的策略群組,避免自動切換讓測試條件不斷改變。

為什麼自訂規則會在訂閱更新後消失?

請先透過用戶端的覆寫、合併設定或擴充規則入口儲存自訂項目,不要直接編輯每次都會重新下載的訂閱檔案。訂閱更新通常會取代遠端內容;用戶端是否保留本機修改,則取決於其實作方式。需要優先比對的自訂規則通常應放在相關通用規則之前,並確認所引用的策略群組名稱確實存在。儲存後查看最終生效的設定,再到連線頁確認比對結果。更換用戶端時,覆寫入口與合併語法可能不同,請依新用戶端的說明遷移。

如何確認某個網站確實走代理,而不只是查看開關狀態?

開啟用戶端的連線頁,重新瀏覽目標網站,找到相應的網域或目標位址,查看命中的規則、策略群組與最終出口。若沒有看到新記錄,先檢查系統代理或 TUN 的流量接管入口,不要急著修改分流規則。修改規則後,應關閉目標應用程式的舊連線再測試,因為已建立的連線通常不會立即改道。瀏覽器快取、應用程式內建代理及加密 DNS 都可能影響觀察結果;必要時可使用獨立測試請求,並搭配 DNS 日誌確認網域是否正確識別。

Fake-IP 導致區域網路裝置或特定應用程式異常,如何排除?

先確認異常只在 Fake-IP 模式下發生,再依據日誌找出受影響的實際網域,將確實需要的網域加入 fake-ip-filter,儲存後重新載入設定並重建應用程式連線。過濾規則的行為也會受到 fake-ip-filter-mode 等設定影響,請一併檢查目前設定。區域網路裝置也須確認私有位址路由與直連規則是否正確。切換 DNS 模式後可能會留下舊的解析快取,可重新啟動相關應用程式並清除系統 DNS 快取;不要直接排除大量公開網域,以免影響網域識別與分流結果。

錯誤與復原

故障排除

先保留可用設定與錯誤記錄,再判斷故障發生在哪個環節。

訂閱突然失效、更新失敗或回傳 401、403,該如何排查?

先檢查裝置時間、網路連線與服務提供者的帳戶狀態,再查看更新日誌中的 HTTP 狀態碼與錯誤內容。401 通常與憑證缺漏或失效有關;403 也可能是存取受到限制,實際原因請以服務提供者的說明為準。若發生逾時,需確認是訂閱網址本身無法連線,還是目前的代理路徑影響下載。若用戶端支援選擇更新所用的網路路徑,可分別測試直連與代理。保留最後可用的設定,不要先刪除所有內容;分享日誌前,請遮蔽訂閱 URL、存取憑證與伺服器驗證資訊。

節點測試逾時,但其他網路功能正常,接下來該檢查什麼?

先固定一個候選出口,查看日誌顯示的是 DNS 解析失敗、連線遭拒、交握失敗,還是單純逾時,再改用其他網路進行比對。若用戶端無法連線到測試網址,也可能出現測試失敗但部分服務仍可用的情況,因此還要實際測試目標網站。確認訂閱仍有效、裝置時間正確,並檢查安全軟體與防火牆是否攔截核心程序。若所有候選項目在同一網路都失敗,應先排查本機與網路路徑;若只有個別項目失敗,再向服務提供者回報已遮蔽敏感資訊的錯誤時間與日誌。

系統代理已啟用,瀏覽器仍直接連線;關閉用戶端後又無法上網,該怎麼辦?

先確認作業系統目前網路連線的代理設定,確保位址與連接埠對應到正在執行的用戶端,再檢查瀏覽器是否有擴充功能或獨立代理設定覆蓋系統設定。若明確指定代理的請求成功,但瀏覽器沒有連線記錄,應優先檢查應用程式的流量入口。關閉用戶端後無法上網,常見原因是系統仍保留指向已停止監聽連接埠的代理設定;可在系統網路設定中關閉殘留代理後重試。macOS 請檢查目前使用的網路服務;Windows 則須區分使用者代理與 WinHTTP 設定,避免修改不相關的入口。

Windows UWP 應用程式無法使用本機代理,如何處理迴圈連線限制?

先確認受影響的應用程式確實在 AppContainer 中執行,並使用指向本機迴圈位址的系統代理。若用戶端提供 UWP 迴圈連線豁免工具,可完成授權後只勾選需要存取代理的應用程式,再將該應用程式完全關閉並重新開啟。也可以在系統管理員終端機中使用 CheckNetIsolation LoopbackExempt -s 查看現有豁免;新增時須提供正確的套件系列名稱。迴圈連線豁免只能解決應用程式存取本機代理的限制,無法修復訂閱或 DNS 故障;TUN 是另一種流量接管方式,也應分開測試。機構管理的裝置須遵守管理政策。