Clash 常見問題與故障排除

圖形化用戶端負責匯入訂閱、選單操作、系統代理與顯示記錄；核心則處理協定連線、DNS 與規則比對。ClashX 是 macOS 用戶端的名稱，不能因此認定所有同名或衍生版本都採用 mihomo 核心。排查相容性問題時，先在「關於」頁面或啟動記錄確認實際使用的核心，再查看支援的設定範圍。更換介面不一定會改變核心，換了核心也不代表舊用戶端能管理新增功能。

用戶端提供連線與分流功能，設定檔則包含節點、策略群組、DNS 與規則等實際參數。只有安裝程式而沒有可用設定，通常無法建立代理連線。請準備可信服務提供的訂閱網址，或匯入自行維護的 YAML 檔案；匯入後還要選取該設定並檢查策略群組。訂閱連結可能含有帳戶存取憑證，不應貼到公開論壇、截圖或線上轉換網站。本網站的用戶端安裝說明不等於節點服務。

日常使用建議先選規則模式，讓請求依序比對規則表。全域模式通常會將送入核心的請求交由全域策略群組處理，仍須在該群組選取可用節點；直連模式則讓這些請求直接連線。模式只決定核心如何處理已接收的請求，不代表所有應用程式都已連上代理。若某個應用程式完全沒有出現在連線清單中，應檢查系統代理、應用程式本身的代理設定或 TUN 接管狀態，而不是反覆切換模式。

mixed-port 是用戶端在本機監聽的 HTTP 與 SOCKS 混合連接埠，7890 是常見的範例值，並非所有安裝環境都固定使用這個數字。節點連接埠屬於遠端伺服器，由節點設定決定，兩者不能互換。替瀏覽器或命令列工具設定本機代理時，請使用用戶端目前的監聽位址與連接埠，例如 127.0.0.1 和 7890。若介面設定或覆寫內容蓋過了設定檔，請以執行中的連接埠頁面及啟動記錄為準。

只有格式相容且伺服器仍可使用的節點才能連線；免費不代表可信或能長期使用。公開訂閱可能由多人共用、受到速度限制或隨時遭撤銷，也可能含有目前核心不支援的設定項目。匯入前請確認來源，避免將帳戶訂閱交給陌生的轉換服務；連線後仍應保留網站的 HTTPS 憑證驗證。不要為了使用某個節點安裝來源不明的根憑證，也別把用戶端安裝成功當成節點品質的保證。

在用戶端的設定或訂閱頁面選擇從 URL 匯入，貼上完整網址並儲存；本機檔案則使用匯入檔案的功能。選單名稱依用戶端而異，ClashX 可從選單列的設定入口管理設定。下載完成後選取該設定，確認策略群組中有節點，再開啟系統代理並瀏覽已知網站測試。若只有下載記錄卻看不到節點，先檢查目前選取的設定及回應格式，不要立刻更改連接埠或啟用 TUN。

先查看記錄中的行號與錯誤類型，再檢查該行及前後幾行的縮排、冒號和清單符號。YAML 縮排須使用空格，不要混用定位字元；含特殊字元的字串也要適當加上引號。若回應開頭是網頁標籤、登入提示或拒絕存取訊息，表示取得的不是設定檔，調整縮排也無濟於事。修改前先保留原始檔案，每次只改一處並重新載入；也要確認訂閱輸出的設定格式與目前核心相容。

先確認目前的用戶端確實支援 TUN，再依設定頁面的指示安裝或修復服務元件。Windows 用戶端通常需要以系統管理員權限安裝服務；macOS 可能需要授權輔助元件；Linux 則需要相應的網路管理權限。不要直接放寬所有檔案的權限。授權後查看記錄，確認虛擬網卡已建立且路由設定成功；若仍失敗，先關閉其他 VPN 或 TUN 用戶端，保留記錄中的具體錯誤再繼續排查。

開機啟動通常只代表啟動用戶端，不等於自動啟用系統代理或 TUN。請分別檢查用戶端的登入時啟動、啟動後啟用代理、服務模式及設定選取狀態。Windows 可查看工作管理員中的啟動應用程式；macOS 可查看系統設定中的登入項目與延伸功能。若首次啟動時網路尚未就緒，訂閱更新可能會失敗；建議保留一份可在本機使用的設定，待網路恢復後再手動更新，不要依賴每次開機重新下載設定。

建議優先搬移訂閱網址、自建節點與已確認相容的規則，不要直接複製整個應用程式資料夾。系統代理狀態、服務元件、TUN 網卡與介面覆寫通常屬於用戶端本身，無法只靠複製 YAML 搬移。先關閉舊用戶端及其系統代理，再於新用戶端匯入設定，核對連接埠與策略群組名稱後測試連線。確認新環境穩定後再清除舊資料，避免兩個用戶端同時修改路由或搶用同一個監聽連接埠。

規則會由上而下依序比對，自訂規則應放在可能先比對成功的廣泛規則或 MATCH 之前。例如 DOMAIN-SUFFIX,example.com,DIRECT 表示該網域及其子網域直連。目標策略必須是內建策略或已存在的策略群組名稱，大小寫也要核對。建議使用用戶端的覆寫或持久化規則功能；直接修改遠端訂閱產生的檔案，可能在下次更新時遺失。儲存後重新載入，並在連線詳細資訊中確認命中的規則。

先讓裝置連上彼此可互通且可信任的區域網路，在電腦用戶端開啟允許區域網路連線，並確認監聽位址允許其他裝置存取。接著在手機或電視的代理設定中填入電腦的區域網路 IP 與實際混合連接埠，不要填 127.0.0.1。電腦防火牆只應允許必要的本機網段存取該連接埠，避免在公用網路上開放。裝置是否使用該代理仍取決於應用程式的實作；手動設定 HTTP 代理通常無法接管所有 UDP 請求。

不少命令列工具不會讀取桌面系統代理，必須另外設定代理參數或環境變數。以 curl 為例，可執行 curl -x http://127.0.0.1:7890 https://example.com 明確測試代理，並將連接埠改為用戶端實際使用的值。確認測試成功後，再查看該工具是否支援 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。環境變數只會影響讀取它的程序，已開啟的終端機或背景服務可能需要重新啟動；清除測試設定時，也要一併移除這些變數。

部分受到 AppContainer 隔離的應用程式無法直接存取本機回送代理。先確認瀏覽器能透過相同連接埠連線，再使用用戶端提供的 UWP 回送工具，只為需要的應用程式啟用回送豁免；該工具可能需要系統管理員權限。若用戶端沒有整合入口，可透過 Windows 的 CheckNetIsolation 工具檢查對應套件的豁免狀態。不要一次對所有應用程式開放。若問題實際上來自 DNS、應用程式登入或防火牆，回送豁免並不能解決。

將服務提供者維護的節點與本機長期使用的設定分開管理。若用戶端支援覆寫、合併設定或腳本處理，請將 mixed-port、DNS 與自訂規則放在相應的持久化入口，再檢查最後產生的執行設定。不同用戶端的合併順序與陣列處理方式各不相同，不能假設規則會自動附加。首次設定後手動更新訂閱，確認節點已更新而本機修改仍然保留；若用戶端不支援持久化，請備份獨立設定檔並明確規劃維護方式。

先在設定頁面確認是哪一個訂閱失敗，再查看記錄中的狀態碼。401 或 403 可能與授權、期限或存取政策有關；404 可能表示網址已變更，但不能只靠狀態碼斷定原因。檢查連結是否完整、帳戶是否有效，以及回應內容是否為相容的設定檔。更新路徑也可能依賴目前使用的代理，可試試用戶端提供的直連更新方式。只有單一訂閱失敗時，請聯絡服務提供者；所有訂閱都失敗時，優先檢查本機網路、DNS 與系統時間。

逾時只表示目前的測試未能在限定時間內完成，可能與本機網路、DNS、測試網址、協定參數或伺服器狀態有關。先改測同一訂閱中的其他節點，再換個網路測試，並確認測試 URL 能透過該節點存取。若延遲測試失敗但實際網頁可開啟，請檢查測試網址設定；若所有節點和直連都失敗，先恢復基本網路連線。記錄出現驗證失敗時，核對訂閱與憑證；出現連線逾時時，再檢查伺服器是否可連線，別把兩種錯誤混為一談。

先查看用戶端的連線清單中是否出現該瀏覽器的請求。若沒有，檢查系統代理位址與實際監聽連接埠是否一致，並關閉瀏覽器中覆寫系統設定的代理擴充功能。若有請求但仍是直連，查看命中的規則與目標策略，確認不是 DIRECT。也要區分瀏覽器使用的 HTTP 代理與未受接管的其他流量。可用明確指定代理的命令測試本機連接埠是否可用；若連接埠無法連線，先處理核心啟動失敗或監聽衝突。

先關閉 TUN，確認基本網路恢復，再逐項檢查，不要連續疊加路由修改。保留錯誤記錄，檢查是否有其他 VPN、虛擬網卡或安全軟體同時接管網路，並核對 DNS 與自動路由設定。若 IP 可連線但無法解析網域，請優先檢查 DNS 監聽、上游連線狀況及路由迴圈。必要時正常結束用戶端並重新連線網路；仍無法恢復時再重新啟動裝置。受企業管理的裝置應遵守管理員政策，避免自行刪除系統網卡。

結束用戶端後無法上網，先檢查系統是否殘留指向本機的代理設定，關閉殘留代理，再核對終端機環境變數與瀏覽器擴充功能。憑證警告則是另一類問題：先校正系統日期與時間，查看憑證簽發者和存取網域，並檢查是否設有 HTTPS 檢查或 MITM。不要點選忽略警告，也不要任意安裝根憑證。若只有特定節點會觸發警告，請停止使用該節點並回報服務提供者；若直連也出現相同錯誤，應繼續檢查裝置或網站本身。