Clash 常見問題與故障排查
依基本認識、安裝設定、使用技巧與故障排查分類整理。處理連線問題時，先確認故障範圍，再依序檢查設定、代理入口、DNS、策略群組與日誌，避免同時變更多個變數。
基本認識
先區分用戶端介面、執行核心、設定檔與代理模式，後續排查時才不會將不同層級的問題混在一起。
Clash 用戶端、Clash 核心與 mihomo 核心有什麼關係？
核心負責讀取設定、建立代理連線、執行規則比對及處理 DNS；圖形化用戶端則負責訂閱管理、策略切換、日誌檢視與系統代理控制。mihomo 是延續 Clash 設定體系的活躍核心實作，許多新用戶端都使用它作為執行核心。排查問題時，應同時記錄用戶端名稱、核心類型與設定來源，因為介面故障與核心錯誤的處理方式不同。
規則模式、全域模式和直連模式有什麼差別？
規則模式會依照設定中 rules 的宣告順序判斷請求去向，適合日常使用；全域模式會將大部分請求交由目前選取的代理策略處理，適合暫時驗證節點；直連模式則讓請求直接連線到目標，不經過代理節點。網站無法開啟時，可暫時切換至全域模式進行比對。如果全域模式正常而規則模式異常，應檢查規則命中結果與策略群組選擇，而不是反覆切換系統代理。
訂閱連結與本機 YAML 設定檔有什麼差別？
訂閱連結由設定提供者代管，用戶端可定期重新請求並替換訂閱內容；本機 YAML 檔案則儲存在裝置上，欄位修改由使用者維護。訂閱更新通常會覆蓋直接編輯的內容，因此長期自訂規則應放入用戶端支援的覆寫、合併或腳本功能中。匯入前也應確認連結回傳的是 YAML 或用戶端支援的設定內容，而不是登入頁面、錯誤頁面或一般網頁。
Fake-IP 模式用來處理什麼問題？
Fake-IP 模式會先由核心向應用程式回傳保留位址，再透過內部對映還原原始網域並執行規則比對，通常能減少重複解析並保留網域資訊。少數區域網路裝置、遊戲、企業軟體或依賴真實位址驗證的程式可能不相容。遇到區域網路存取異常時，可先將相關網域加入 fake-ip-filter；若問題範圍較大，再暫時切換至 redir-host 進行比對，確認是否由 Fake-IP 對映造成。
安裝設定
設定匯入、訂閱更新、TUN 權限與開機自動啟動，分別由不同的系統能力控制，應依照錯誤出現的位置逐項處理。
YAML 設定匯入失敗或顯示解析錯誤，該怎麼辦？
先在用戶端日誌中找出第一個解析錯誤及對應行號，再檢查該行附近的縮排、冒號、短橫線與引號。YAML 必須使用空格縮排，清單項目的層級也必須一致；包含特殊字元的節點名稱或密碼可用引號包住。還應確認 proxies、proxy-groups 和 rules 等欄位位於正確層級。若設定來自訂閱連結，應先檢視回應內容，避免將網頁錯誤訊息誤當成 YAML 匯入。
Clash 訂閱連結失效或更新失敗，如何找出原因？
先將訂閱網址複製到瀏覽器，測試是否能取得內容，並觀察回應狀態、檔案內容及是否被重新導向至登入頁面。瀏覽器也無法存取時，應聯絡設定提供者處理連結狀態；瀏覽器可存取但用戶端失敗時，則檢查用戶端網路權限、代理鏈路、更新間隔與本機快取。可以刪除失敗的設定副本後重新匯入，但應先備份覆寫規則。若回應內容是 JSON、HTML 或空白文字，還需確認用戶端是否支援該訂閱格式。
啟用 TUN 模式時顯示權限不足，該怎麼辦？
TUN 模式需要建立虛擬網路介面並修改系統路由，因此權限要求高於一般系統代理。Windows 可檢查服務模式是否已安裝並正常執行，必要時以系統管理員權限完成首次設定；macOS 需要核准網路延伸功能或輔助服務；Linux 通常需要 CAP_NET_ADMIN、管理員權限及可用的 TUN 裝置。修復權限後，應完全結束用戶端再重新啟動，並檢查防火牆是否阻擋新建立的虛擬介面。
Clash 已開啟開機自動啟動，但重新開機後沒有執行，該怎麼辦？
先區分用戶端未啟動，還是用戶端已啟動但系統代理未開啟。Windows 可在工作管理員的啟動應用程式清單中確認項目狀態，並檢查用戶端路徑是否因安裝目錄移動而失效；macOS 可檢視登入項目及背景項目的權限；Linux 則應檢查桌面自動啟動檔案或使用者層級服務。若用戶端能啟動但沒有接管流量，還要確認啟動後自動設定系統代理或自動啟用 TUN 的選項是否另外開啟。
使用技巧
部分應用程式不讀取系統代理，部分請求則會受到 DNS、UWP 容器或協定行為影響，因此需要先確認問題是否只出現在特定程式中。
Clash 已執行但系統代理沒有生效，該怎麼辦？
先確認用戶端顯示的 HTTP 或 mixed 連接埠，與系統代理設定中的位址及連接埠一致，常見的本機位址為 127.0.0.1。接著檢查瀏覽器或應用程式是否使用獨立代理、擴充功能代理，或忽略系統設定。企業政策、安全軟體與其他代理工具也可能覆寫系統代理。可先關閉其他網路工具，再重新切換一次系統代理，並使用明確遵循系統代理的瀏覽器測試；只有部分應用程式異常時，應改查該應用程式的代理機制。
Windows Microsoft Store 應用程式無法透過 Clash 連網，如何設定 UWP 回送？
部分 UWP 應用程式在受限制的容器中執行，預設無法存取本機回送代理，因此桌面瀏覽器正常並不代表 Microsoft Store 應用程式也能連線。可使用用戶端提供的 UWP 回送工具，勾選需要連網的特定應用程式並儲存豁免設定；不要一次選取全部項目，以便控制影響範圍。設定後重新啟動目標應用程式。若仍然失敗，應確認系統代理連接埠可用，並檢查目標應用程式是否改用 QUIC、獨立 DNS 或其他不遵循系統代理的連線方式。
節點顯示逾時或延遲測試失敗，應該檢查什麼？
延遲測試失敗不一定代表節點完全無法使用，測試位址、網路出口與協定交握都可能影響結果。先確認裝置的基本網路正常，再更新訂閱，並選擇其他地區或協定的節點進行比對。接著查看日誌，確認是 DNS 失敗、連線逾時、TLS 錯誤還是驗證失敗。大量節點同時逾時，通常指向本機網路、訂閱狀態或測試位址問題；只有單一節點失敗時，則較可能是節點本身無法連線或參數已經變更。
啟用 Clash 後出現 DNS 解析異常或網域無法開啟，該怎麼辦？
先判斷問題只影響網域，還是連 IP 位址也無法存取。若 IP 可連線但網域解析失敗，應檢查 dns.enable、nameserver、fallback、enhanced-mode 與監聽位址，並確認設定中的 DNS 伺服器可從目前網路存取。系統中殘留的加密 DNS、瀏覽器安全 DNS 或其他本機解析服務，可能繞過或占用 Clash DNS。修改後清除系統 DNS 快取並重新啟動目標應用程式，再透過日誌確認請求是否進入核心。
故障排查
複雜故障應保留重現條件與第一筆錯誤日誌，每次只修改一個變數，再以相同目標位址重複測試。
Clash 顯示已連線，但瀏覽器和應用程式都無法上網，該怎麼辦？
依照基本網路、代理入口、DNS、策略群組與規則命中的順序排查。先關閉系統代理或 TUN，確認裝置直連網路正常；再重新啟用 Clash，檢查連接埠是否正在監聽，以及目前策略群組選取的節點是否可用。暫時切換至全域模式，可以區分規則問題與節點問題。若全域模式也失敗，應查看日誌中的連線錯誤；若只有規則模式失敗，應檢查最終規則、策略群組引用，以及是否誤選 REJECT 或不可用的子策略。
代理連線頻繁中斷，或使用一段時間後失效，該怎麼辦？
先記錄中斷時間，並檢查是否與裝置休眠、網路切換、訂閱自動更新或節點健康檢查同時發生。行動網路與 Wi-Fi 切換後，舊連線可能需要重新建立；桌面系統從休眠恢復時，虛擬介面與系統代理狀態也可能不同步。可先關閉用戶端後重新啟動進行比對，並查看日誌中是否出現網路變更、連線重設或驗證錯誤。若只發生在單一節點，應更換節點並比較穩定性。
啟動 Clash 時顯示連接埠已被占用，該怎麼辦？
連接埠被占用表示設定中的 port、socks-port、mixed-port、redir-port 或控制連接埠，已由其他程序監聽。先完全結束重複執行的 Clash 用戶端及其他代理工具，再重新啟動。若仍有衝突，可使用系統網路工具找出占用程序，確認用途後停止該程序，或將 Clash 連接埠改為尚未使用的值。修改連接埠後，必須同步更新系統代理、瀏覽器手動代理及區域網路裝置中的連線設定。
更新訂閱後，本機規則和策略修改消失，該怎麼辦？
訂閱更新通常會重新下載並替換代管設定，因此直接寫入訂閱檔案的規則、節點與策略群組可能會被覆蓋。長期修改應移至用戶端提供的覆寫、合併設定、腳本處理或獨立設定檔中，並在更新前保留可還原的副本。遷移時先處理連接埠、DNS 等基礎欄位，再合併策略群組與規則，最後確認所有被引用的策略名稱都存在。不要只依賴介面中對訂閱檔案的暫時編輯狀態。
繼續檢查設定與安裝步驟
需要核對 YAML 欄位時，請查看設定參考；首次安裝或重新設定用戶端時，請依照入門步驟操作。