Clash 故障排除指南

無法上網：先釐清本機網路與代理連線

關閉流量接管後，原本的網路是否恢復

常見情況是啟用 Clash 後所有網頁都無法開啟，或用戶端顯示正在執行，但應用程式一直轉圈。先記下出問題的應用程式、目標網站和發生時間，再關閉「系統代理」與「TUN 模式」，並保持用戶端視窗開啟。使用瀏覽器造訪平時可直接連線的網站。如果仍無法連線，請優先檢查 Wi-Fi 登入認證、路由器連線、系統網路設定及其他 VPN；代理用戶端並非唯一可能的故障來源。在學校、飯店和公共網路上，通常要先在未接管流量的狀態下完成認證。

如果關閉流量接管後網路立即恢復，問題範圍便可縮小至本機入口、規則選擇或代理出口。前往「訂閱」或設定檔清單，確認已選取設定檔，而不只是下載完成。再開啟「代理」，檢查目前策略群組是否確實選到可用的出口。有些群組會記住先前的選擇；訂閱更新後成員名稱可能已變更，介面看似仍在運作，實際上卻沒有可用選項。不要直接刪除所有訂閱，先切換至已知可用的設定檔進行比較。

使用明確指定代理的請求，繞過系統設定

接著只啟用用戶端核心，暫時關閉 TUN。前往「設定」確認實際使用的混合連接埠；以下以 7897 為例，若連接埠不同，請替換成實際值。明確指定代理的請求不受瀏覽器是否遵循系統代理影響，因此可以分別判斷「用戶端能否轉送」與「應用程式是否有進入代理」。Windows PowerShell 請使用 curl.exe，避免舊版環境將 curl 解讀為其他命令。範例網域僅作為 HTTPS 請求目標，不代表必須能從目前網路直接連線。

curl --noproxy "" --proxy http://127.0.0.1:7897 --connect-timeout 10 --max-time 20 -I https://example.com

如果回傳 HTTP 狀態列，表示這次請求至少已收到伺服器回應；即使狀態表示拒絕存取，也不同於完全無法建立連線。若顯示無法連線至 127.0.0.1，請檢查核心是否已啟動，以及連接埠是否正確。若成功連上本機連接埠，但之後逾時，請繼續查看出口日誌。若瀏覽器連線失敗，但明確指定代理的請求成功，請先前往系統代理章節檢查應用程式入口，不要反覆更換節點。

搭配日誌判斷是規則錯誤還是出口連線失敗

開啟「日誌」，維持一般資訊層級，清除畫面後只重現一次失敗請求。確認時間、目標網域、比對到的規則和最終策略群組。若請求意外使用 DIRECT，而目標網路需要代理，問題多半出在規則順序或模式選擇。可暫時切換至「全域」進行比較，測試後再切回「規則」。如果全域模式可用、規則模式不可用，應檢查實際命中的規則，而不是長期將所有連線都送往同一個出口。舊連線可能仍沿用舊策略，切換後請重新開啟頁面或建立新連線。

如果某個應用程式完全沒有對應日誌，表示它可能沒有經過目前的入口，也可能使用另一套網路程序。先測試瀏覽器，再檢查該應用程式本身的代理設定。若日誌出現 REJECT，請確認命中的是廣告過濾、隱私規則還是自訂規則；只調整相關規則，不要直接清空整份規則清單。關於比對優先順序，請參閱規則語法與比對順序說明。

如果修改後連原本可直接連線的網站也無法開啟，請立即還原至最近一次可用狀態：關閉 TUN、還原原本的 DNS 設定、退出其他網路接管工具，再重新測試。暫時不要重設整個系統網路堆疊。系統層級重設會清除部分網路介面卡或網路設定，可能連遠端桌面、虛擬機和企業網路連線也一併中斷；應先確認局部修復無效，再考慮執行。

節點逾時：從錯誤位址判斷問題位置

先區分連線、交握與目標網站存取

「逾時」不只有一種原因。用戶端的連線測試可能會連至特定測試位址，而瀏覽器造訪的是另一個網站，兩者結果不一定相同。先直接開啟目標頁面，再查看同一時間的日誌。如果只有測試按鈕顯示逾時，實際瀏覽卻正常，應檢查測試位址及其規則路徑，不要只憑單一測試結果就認定出口失效。反過來說，測試成功也只代表該測試請求已完成，不保證所有網站、UDP 或大型檔案傳輸都正常。

dial tcp 後面的位址尤其重要：可能是代理伺服器位址，也可能是直接連線的目標位址。若無法連上前者，請檢查伺服器網域解析、連接埠和網路可達性；若是後者失敗，先確認請求為何選擇直接連線。connection refused 通常表示連線遭到明確拒絕，可能是該連接埠沒有服務在監聽，也可能是中間設備主動拒絕；i/o timeout 只表示未能在期限內完成讀寫，不能據此直接認定服務商已停機。

交叉測試網路與出口，縮小問題範圍

固定使用同一個出口和目標，先將裝置從目前的 Wi-Fi 切換至手機熱點。如果熱點可用，原網路可能限制了相關連接埠或傳輸方式，也可能是網路路徑品質不佳。接著切回原網路，改用另一個出口測試。如果只有某個出口失敗，請檢查其設定是否已過期、伺服器端是否有變更，並向訂閱服務提供者回報具體時間和錯誤訊息。若所有出口在所有網路上都失敗，更應檢查本機時間、訂閱有效性與核心相容性。

對於使用 UDP 的傳輸方式，一般 TCP 連接埠測試不足以證明該協定可用。有些網路允許瀏覽網頁，卻會限制 UDP；此時可用支援不同傳輸方式的出口進行比較診斷。不要任意將協定名稱、連接埠或傳輸欄位改成另一種協定，用戶端設定必須與伺服器端一致。連線失敗也不代表一定要關閉防火牆；可先查看封鎖紀錄，依應用程式或明確指定的連接埠建立必要規則，測試完成後移除臨時允許項目。

核對 TLS、驗證資訊與核心相容性

發生交握失敗時，先讓系統時間自動同步，再核對伺服器名稱、SNI、驗證資訊和傳輸路徑。直接把伺服器網域替換為 IP，可能會改變憑證名稱驗證結果，因此不能把這種做法當成通用修復方式。請保留訂閱提供的完整參數；手動設定則逐項對照伺服器端說明。遇到不支援的協定或設定欄位時，請檢查目前用戶端使用的核心；舊版原始 Clash 並不支援所有 mihomo 擴充功能。

如果近期剛遷移設定，可參閱mihomo 與原版核心的差異，特別確認協定、規則提供者及嗅探相關欄位。更新用戶端時，請從安裝套件頁選擇適合裝置的版本，保留目前設定後再安裝。不要用來路不明的執行檔覆蓋核心，也不要同時更新用戶端、訂閱、DNS 和所有規則，否則發生問題後很難判斷是哪一步造成變更。

需要尋求協助時，請保留失敗請求前後相鄰的日誌，不要只截取「逾時」兩個字。可提供用戶端名稱、作業系統、使用的網路、是否只有特定出口受影響，以及跨網路測試結果。請隱藏密碼、訂閱參數和完整伺服器識別資訊；更多日誌欄位的判讀方式請參閱Clash 執行日誌解讀。

訂閱更新失敗：檢查下載與解析兩個階段

是無法取得連結，還是無法載入內容？

訂閱更新失敗時，請先保留目前可用的設定，不要刪除後重新新增。開啟訂閱卡片的錯誤詳情，判斷失敗發生在取得內容還是解析內容。連線逾時、名稱解析失敗通常發生於下載階段；YAML 格式錯誤、不支援的代理類型或策略群組引用錯誤，通常發生於解析階段。這兩類問題需要不同處理方式。反覆點擊更新無法修復格式錯誤，還可能觸發伺服器端的請求頻率限制，讓原本明確的錯誤變得更複雜。

請重新從服務提供者的管理頁面複製完整訂閱網址，確認沒有連同前後空格、換行、通訊軟體標點或網頁上的說明文字一起複製。訂閱連結中的查詢參數通常具有授權作用，不可任意刪改，也不應公開貼在截圖或論壇上。請優先在用戶端內匯入，不要將連結提交給不明的線上轉換網站。若必須透過瀏覽器檢查，請先留意瀏覽器歷史紀錄、下載紀錄及同步功能可能會保存完整網址。

依 HTTP 回應判斷處理方向

若看到 401 或 403，通常應檢查授權、帳戶狀態或伺服器存取策略，而不是修改本機混合連接埠。404 可能表示路徑已失效，也可能是伺服器刻意隱藏資源；請重新取得服務提供者提供的網址。429 表示請求過於頻繁，請停止連續重試，並依伺服器提示等待。5xx 通常較可能是伺服器或其上游發生異常；請記錄時間並稍後重試，不要立即重新安裝所有用戶端。

即使回傳成功狀態，也可能取得的是登入頁面、驗證頁面或錯誤提示，而非設定檔正文。檢查錯誤內容是否包含 <html>、文件類型宣告或網頁登入資訊。Clash 設定檔通常是 YAML 對應結構，包含代理、策略群組或規則等相關欄位；一般節點清單也不同於完整設定檔。若服務商提供多種訂閱格式，請選擇與目前用戶端相容的格式。只有在服務提供者明確要求時，修改用戶端名稱或請求識別資訊才有意義。

排除更新路徑依賴與設定衝突

有些訂閱網址無法在目前網路上直接連線，而用戶端更新時預設使用直連；另一些情況則相反，更新請求被送進已失效的代理。請檢查訂閱更新選項是否支援透過目前代理取得內容，分別測試直連與可用代理路徑。若所有現有出口都失效，可暫時切換至能連上訂閱服務的網路再更新，避免陷入「必須先更新才能連線、必須先連線才能更新」的循環。代理伺服器本身的網域解析也必須正常。

解析錯誤附有行號時，先檢查該行及前後的縮排。YAML 使用空格表示層級，請勿混用定位字元；同一層級的鍵名重複也可能造成覆寫或解析異常。以下範例是獨立的最小直連設定，只用來確認核心能否載入設定，不提供代理出口，也不能取代訂閱。請另建本機設定進行測試，不要直接覆蓋遠端訂閱正文。

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

如果最小設定可以載入，但訂閱設定無法載入，請繼續檢查訂閱內容、核心支援及本機覆寫。部分用戶端會在每次更新後套用「合併」、「腳本」或「覆寫」；如果舊覆寫引用了已不存在的策略群組，即使遠端正文正確，最終設定仍可能出錯。請逐項停用這些附加處理，再更新並驗證；找出原因後只修正相關引用，不要永久丟棄所有自訂設定。

更新成功後，也要重新確認目前選取的設定檔、策略群組成員和可用出口。有些用戶端即使下載成功，也不代表已切換至新設定檔。若懷疑訂閱網址外洩，請在服務提供者的管理頁面重設連結，再更新所有裝置；單純刪除通訊紀錄中的訊息，無法撤回已複製出去的授權資訊。

網速慢與間歇斷線：區分頻寬、延遲與應用程式行為

把「很慢」描述成可重現的現象

先說明是哪裡變慢：是網頁首屏遲遲不顯示、影片開始播放後反覆緩衝、下載速率偏低，還是連線一段時間後中斷。網頁載入慢通常與 DNS、建立連線或 TLS 交握有關；持續下載緩慢則較可能涉及傳輸量、線路壅塞或伺服器限制；固定時間後斷線則應檢查休眠、背景限制和連線保活。只看用戶端的延遲數字無法判斷下載頻寬；往返延遲低，也不代表遠端出口沒有壅塞。

測試時固定裝置、目標和應用程式，暫停雲端硬碟同步、系統更新及其他大量傳輸工作。先比較不經代理時的本機網路狀況，再以相同目標比較兩個出口。不要同時切換 Wi-Fi、瀏覽器、協定和目標網站，否則每次測試的條件都不同。測速網站本身也可能依規則採用直連；若將直連結果誤認為代理表現，結論就會完全相反。測試時請在連線清單確認實際使用的出口。

分段檢查連線路徑與裝置負載

Wi-Fi 訊號格數多，不代表干擾少。靠近路由器、切換至穩定的頻段，或暫時改用有線網路，是檢查本機無線問題的直接方法。如果同一個出口在手機熱點下穩定，在家用無線網路下卻斷斷續續，應先處理本機網路連線。企業網路、共享寬頻和晚間尖峰時段也可能影響可用傳輸量。不要因為一次尖峰時段的測試結果不理想，就把所有設定參數都改成網路上推薦的「高速設定」。

接著查看系統工作管理員或活動監視器，確認 CPU、記憶體和磁碟是否持續處於高負載。代理連線較多時，用戶端圖形介面、核心及其他安全軟體可能同時消耗資源。可暫時降低日誌詳細程度，關閉持續捲動的偵錯視窗，再觀察實際傳輸狀況；不要為了追求測速數字而關閉必要的安全防護。如果只有圖形介面卡頓，但網路請求正常，應分開處理介面效能與核心轉送問題。

檢查規則、協定與大型封包傳輸

如果只有某個網站變慢，其他網站正常，請查看它是否使用不同的內容傳遞網路網域，或部分資源是否被分配到另一個出口。瀏覽器頁面可能同時連線至多個網域；若首頁主網域走代理，但圖片和媒體資源卻直接連線，就會出現文字先載入、影片遲遲無法播放的情況。請檢查連線清單及日誌中的相關請求，再針對實際命中的網域調整規則。自訂規則應放在可能提前命中的位置，並保留最終備援規則，不要只把規則加在 MATCH 後面。

系統代理正常，但啟用 TUN 後大型檔案傳輸容易卡住時，可先關閉 TUN 進行比較，檢查路由和 MTU。MTU 不相符可能造成小型請求正常、大型封包傳輸停滯，但並非所有卡頓都由此引起。調整前請記下原值，依用戶端及網路環境說明逐步測試；不要直接照抄他人的虛擬網路介面卡參數。若使用依賴 UDP 的傳輸方式，也應考量目前網路的 UDP 品質和限速情況。

瀏覽器可能會嘗試使用 QUIC，應用程式也可能建立獨立的 UDP 工作階段。若問題只出現在這類流量，可在有明確設定的測試應用程式中暫時停用相關功能進行比較，之後再恢復。不要只為了讓單次測試成功，就在全域範圍拒絕所有 UDP，這會影響語音、遊戲及其他服務。切換策略後請重新建立連線；既有下載或影片工作階段不一定會立即切換至新出口。

如果只有某個應用程式持續很慢，在清除該應用程式的代理設定和快取前，先確認其他應用程式的同類請求是否正常。有些平台會依出口位址、帳戶或內容伺服器分配不同路徑；換出口後短暫改善，也不一定代表用戶端有故障。請優先保留穩定的使用方式，避免頻繁重新連線，導致服務重新驗證帳戶或中斷進行中的工作。

DNS 異常：釐清系統解析與核心解析

網域解析失敗不代表所有連線都失敗

常見症狀包括顯示找不到伺服器、日誌出現 no such host，或同一個網站有時能開啟、有時卻解析到無法連線的位址。先檢查目標網域拼寫，再確認錯誤發生於解析代理伺服器，還是解析最終網站。代理伺服器網域無法解析會影響整個出口；單一網站解析失敗則可能只影響該目標。直接連線至某個 IP 無法完全取代網域測試，因為 HTTPS 憑證、虛擬主機和內容傳遞網路都可能依賴網域。

系統 DNS、瀏覽器安全 DNS 和 mihomo 內建 DNS 屬於不同環節。瀏覽器可能自行使用加密解析，有些應用程式也會略過系統設定。因此系統查詢成功，不代表瀏覽器採用相同路徑；系統查詢失敗，也不一定代表代理核心無法解析。在 Windows 可使用 nslookup example.com 查看系統查詢結果；在提供相關工具的系統上，也可使用 dig example.com。這些命令應搭配用戶端日誌判讀，不宜單獨作為最終結論。

先排除循環依賴，再處理快取

加密 DNS 服務本身需要建立連線，有時也需要解析其伺服器名稱。如果建立代理連線需要先解析代理伺服器，而 DNS 解析又必須經過這條尚未建立的代理，就會形成循環依賴。設定中的基礎解析、代理伺服器解析和一般目標解析都應有明確路徑。不要簡單地強制所有 DNS 請求都走代理，再讓代理伺服器的網域也交由這條路徑解析。使用訂閱時，請先還原原有 DNS 設定，再逐項加入本機需求。

修改 DNS 後，舊快取可能會讓結果在短時間內維持不變。請先重新開啟測試應用程式，必要時清除核心快取，或依用戶端說明重新啟動核心。確認有需要時，Windows 可執行 ipconfig /flushdns 清除系統解析快取，但這不會同步清除所有瀏覽器和應用程式的快取。不要反覆重設網路介面卡來取代釐清快取層級；每次處理後，請以同一個網域重新測試，並記錄日誌中的請求路徑是否已變更。

了解 fake-ip 與區域網路網域例外

在 fake-ip 模式下，核心可能會回傳保留位址範圍內的映射位址給應用程式，再透過內部映射還原目標網域。這是運作機制，看到該位址不代表解析遭到污染。如果應用程式繞過核心路由，直接使用映射位址連上外部網路，就可能連線失敗。關閉流量接管後，仍保留舊映射的應用程式也可能暫時異常；此時應恢復正確的流量接管方式或重新建立應用程式連線，不要把映射位址寫入系統 hosts 檔案。

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter:
    - "*.lan"
    - "*.local"
  nameserver:
    - https://dns.alidns.com/dns-query

這段設定展示 mihomo 的相關欄位，前提是目前網路能連上所選的解析服務；它不是適用於所有網路的完整 DNS 方案。請將所需欄位合併至現有的 dns 對應結構，不要重複新增同名的頂層鍵。區域網路裝置、企業內部網域和分流解析可能需要交由路由器或企業 DNS 處理；單純排除 fake-ip 並不會自動選擇正確的內部解析器，還需要依實際環境設定解析策略。

啟用 TUN 後，內網印表機、NAS 或公司網域無法使用時，請先關閉 TUN 進行確認，再檢查 DNS 攔截範圍、內部網域解析和私有網段路由。不要強制將所有內網連線也送往遠端出口。企業網路可能依賴搜尋後綴、分離 DNS 或專用 VPN；單純更換公用 DNS 往往會讓內部名稱更難解析。若裝置由組織管理，請遵循網路管理員的要求，不要覆蓋受管理的設定。

如果網頁顯示憑證錯誤，請勿透過停用憑證驗證來掩蓋問題。核對系統時間、實際造訪的網域和憑證簽發對象；DNS 回傳錯誤位址、殘留的中間代理設定等，都可能造成類似情況。請參閱HTTPS 憑證錯誤說明，進一步判斷原因。最終驗證應涵蓋一般網站、需要代理的網站及區域網路資源，避免只修復一類查詢，卻影響其他查詢。

系統代理無效：檢查入口、連接埠與接管衝突

系統代理開關不會接管整台裝置的所有流量

常見情況是用戶端已啟用「系統代理」，但某些程式仍直接連線，或瀏覽器可以使用、終端機與遊戲卻不行。系統代理通常只是將本機代理位址寫入作業系統的相關設定，應用程式是否採用，取決於自身的網路實作。瀏覽器、系統服務和命令列工具可能使用不同的代理機制。請先用瀏覽器和明確指定代理的請求建立基準，不要只因「某個程式沒有日誌」就認定核心轉送失敗。

在 Windows 開啟「設定 → 網路和網際網路 → Proxy」，確認位址和連接埠與目前用戶端一致；在 macOS 開啟「系統設定 → 網路」，進入目前網路服務的詳細資訊，查看「代理伺服器」。不同系統的介面位置可能略有不同。切換 Wi-Fi、有線網路或網路位置後，也應確認目前生效的是哪項服務。自動代理指令碼和手動代理可能來自其他軟體或組織策略；修改前請記下原設定，受管理裝置請勿擅自覆蓋策略。

確認實際監聽混合連接埠的程序

用戶端介面顯示連接埠，不代表核心已成功繫結該連接埠。請查看日誌是否出現位址已被使用、權限不足或核心啟動失敗。以下命令以混合連接埠 7897 為例，只用來查看監聽程序，不會終止程序。Windows PowerShell 可執行第一段；已安裝 lsof 的 macOS 或 Linux 環境可執行第二段。如果權限限制導致資訊不完整，再依系統要求提高檢視權限。

Get-NetTCPConnection -LocalPort 7897 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

lsof -nP -iTCP:7897 -sTCP:LISTEN

如果連接埠被舊用戶端佔用，請先透過工作管理員或活動監視器確認程序名稱，再正常退出舊用戶端。不要只看到程序編號就強制結束系統服務。如果改用其他空閒連接埠，必須同步更新應用程式自己的代理設定和終端機命令。若只更改用戶端連接埠，但系統代理仍指向舊連接埠，就會造成「核心正常運作，但應用程式無法連線」；反過來說，舊核心仍佔用連接埠，也可能讓請求進入錯誤的設定。

逐步檢查環境變數與 TUN 模式

終端機程式可能會讀取 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY，也可能只讀取其中一部分。請檢查目前工作階段是否殘留舊位址，尤其是容器、遠端開發工具和整合式終端機。環境變數會在程序啟動時繼承；修改系統變數後，已開啟的終端機不一定會自動更新。請先為單一測試命令明確指定代理，確認有效後再決定是否設為長期變數。

需要接管不遵循系統代理的應用程式時，再考慮使用 TUN。先關閉其他 VPN、網路加速工具和重複的 TUN 執行個體，確認用戶端所需權限或服務模式正常。啟用 TUN 後，請檢查虛擬介面卡和路由是否已建立，不要只看開關狀態。部分用戶端可以搭配使用系統代理與 TUN，但排查時請先分別驗證，避免請求經過多重入口、繞路，或被另一套工具改寫。

Linux 桌面環境的代理設定也不一定會被所有程式讀取。命令列應用程式、沙箱應用程式和系統服務可能各有設定；容器內的 127.0.0.1 指向容器本身，而非主機上的 Clash。若要讓其他裝置或容器使用代理，還需設定監聽位址、防火牆和存取控制。不要為了方便而將代理入口公開至網際網路；即使只開放區域網路，也應限制為可信任來源。

最後請分別測試瀏覽器、明確指定代理的命令，以及原本出問題的應用程式。如果前兩者正常，但目標應用程式仍未出現在日誌中，請將排查重點放在該應用程式的入口。如果只有啟用 TUN 時才失敗，請回頭檢查路由、權限和 DNS，而不是反覆修改訂閱。這種分層驗證方式也適用於開機自動啟動後偶爾失效的情況：確認網路已就緒、核心已開始監聽，再檢查系統代理是否正確寫入。

用戶端閃退與啟動失敗：保留設定後逐步隔離問題

區分視窗關閉、背景執行與核心結束

按兩下後沒有視窗，請先查看系統匣或選單列，以及系統程序清單。部分用戶端關閉視窗後仍會在背景執行，重複啟動只會叫出現有執行個體；視窗隱藏不代表程式已閃退。若視窗仍在，但顯示核心未執行，請查看核心日誌，而非只重新安裝圖形介面。若程序啟動後立即消失，才進一步排查啟動閃退。請記下最後一次正常使用後發生的變更，例如系統更新、設定遷移、安裝安全軟體或異常關機。

先透過用戶端支援的目錄入口找到設定和日誌的位置；若無法開啟目錄，請查閱該用戶端的說明，不要直接依照其他軟體的路徑刪除檔案。正常退出用戶端及相關背景程序後，將整個設定目錄複製到本機備份位置，並妥善保管其中的訂閱授權資訊。備份僅供復原，不宜上傳至公開的問題回報單。若只能取得日誌，至少保留最近一次啟動失敗前後的紀錄和系統事件資訊。

檢查執行環境、處理器架構與封鎖紀錄

在 Windows 上，部分用戶端的圖形介面依賴 WebView2 執行環境；若出現相關載入錯誤，請透過系統或用戶端說明提供的官方管道修復執行環境。另一款用戶端能開啟，不代表目前用戶端所需的執行環境也已備妥。接著確認安裝套件的處理器架構與作業系統相符，並確認壓縮檔已完整解壓縮至可寫入的目錄。直接從壓縮軟體的暫存預覽目錄執行，可能導致資源檔或資料目錄無法使用。

macOS 使用者應確認應用程式已正確放入可存取的位置，並查看系統安全性設定是否記錄封鎖原因。遇到安全性提示時，請先確認安裝來源，不要一律關閉系統保護。Linux 則需區分套件相依性、圖形工作階段和檔案權限問題；從終端機啟動應用程式，有時能看到介面未顯示的相依性錯誤。不同發行版和桌面環境差異較大，請優先依實際錯誤安裝缺少的相依套件，不要重裝整套桌面元件。

如果安全軟體將核心隔離，可能會出現視窗正常、連線卻一直失敗的情況。確認檔案來源後查看隔離紀錄，再決定如何處理；不要直接將整個磁碟加入排除清單。連接埠衝突也會導致核心啟動失敗，請參閱連接埠監聽檢查，確認是否有舊執行個體佔用。使用服務模式時，圖形介面與背景服務可能分開執行；升級後若路徑不一致，請使用用戶端提供的服務管理入口修復。

使用新的使用者設定進行比較

執行環境沒有明顯問題時，先保留備份，將原設定目錄重新命名，再依用戶端支援的方式建立新的使用者設定。請在完全退出後執行此步驟；不要在程式執行時移動正在寫入的資料庫。新設定可以啟動，表示問題較可能出在舊狀態、覆寫指令碼、損毀的設定或介面儲存資料。接著只匯入一份可信任的訂閱，確認正常後再逐項還原自訂規則和設定，不要整個覆蓋回舊目錄。

如果新設定也無法啟動，請繼續檢查系統應用程式日誌、磁碟剩餘空間和目錄權限。系統磁碟已滿可能導致設定無法寫入；受保護的資料夾也可能阻止必要的資料更新。若先前曾以系統管理員身分執行，後來改用一般使用者啟動，資料檔案的擁有者或權限也可能不一致。修復範圍應限於該用戶端的資料目錄；不要讓整個使用者目錄都可任意寫入，更不要對系統目錄遞迴修改權限。

需要重新安裝時，請先正常解除安裝或退出舊程式，依用戶端說明處理服務，再從安裝套件頁選擇合適版本。新安裝可優先選擇 Clash Plus；已使用 Clash Verge Rev 或 FlClash 的使用者，也可先修復原有環境。已停止維護的用戶端遇到新的系統相容性問題時，反覆重裝相同程式可能沒有幫助；應考慮遷移設定，不要長期依賴關閉安全機制維持運作。

行動裝置專項：VPN 權限、背景限制與網路切換

Android 已連線，但應用程式仍無法存取網路

在 Android 上看到 VPN 圖示，只能表示系統已建立相應的流量接管狀態，不代表訂閱、出口和 DNS 都正常。先讓用戶端保持在前景執行，選取已匯入的設定檔，用瀏覽器測試，再查看日誌。如果瀏覽器正常，但某個應用程式失敗，請檢查「分應用程式代理」或略過應用程式清單，確認該應用程式沒有被排除。不同用戶端的清單可能採用「僅代理選取的應用程式」或「略過選取的應用程式」兩種相反模式，務必先確認目前使用哪種模式。

首次連線時，系統會要求授權 VPN 接管；若拒絕，請回到用戶端重新發起連線，不要只開啟類似系統代理的選項。Android 通常無法讓多個一般 VPN 應用程式同時接管流量，同類代理、以 VPN 運作的過濾工具和企業 VPN 可能互相取代。測試時只保留一個流量接管工具。工作設定檔、受管理設定和系統永遠啟用的 VPN 可能另有相關限制；受管理裝置請先確認組織政策，不要強行移除管理元件。

鎖定螢幕後斷線，以及切換網路後的復原

前景使用正常，鎖定螢幕後卻斷線時，請優先檢查電池最佳化、背景活動權限和廠商的自動啟動管理。先確認用戶端是否仍顯示系統要求的前景服務通知，再依系統說明允許必要的背景執行。並非所有斷線都由電池最佳化造成；網路進入休眠、Wi-Fi 與行動網路切換、上游工作階段過期，也會出現類似情況。測試時請記錄鎖定螢幕的時間、網路類型，以及重新開啟應用程式後是否立即恢復。

從 Wi-Fi 切換至行動網路後，既有的 TCP 或 UDP 工作階段可能無法繼續使用，因為新網路的位址、路由和 DNS 都已改變。請先讓目標應用程式重新建立連線，必要時先在用戶端中斷連線，再重新連線。連線尚未恢復前，不要連續切換多個節點，否則會掩蓋網路切換本身的問題。若只有某個 Wi-Fi 網路會失敗，請在行動網路上使用同一個出口進行比較，並檢查該 Wi-Fi 是否需要網頁認證或限制特定傳輸方式。

系統「私人 DNS」與用戶端內建 DNS 可能同時影響解析。遇到網域問題時，請先記下目前設定，再分別測試自動模式和用戶端建議設定。不要長期將所有 DNS 設定同時改成不同的服務。行動網路可能使用 IPv6；若只有部分網域或協定失敗，請檢查所選出口及流量接管方式是否支援 IPv6，避免只在一處停用 IPv6，其他元件卻仍優先使用相關位址。

iOS 接管狀態與設定驗證

iOS 使用者可從iOS 安裝入口選擇 Clash Plus，相關產品資訊請見clashplus.io。安裝後，先匯入訂閱並選取設定檔，再依系統提示允許新增 VPN 設定。若系統顯示已連線，但網頁仍無法使用，請依「目標請求、日誌、規則、出口」的順序檢查；不可把系統狀態視為遠端服務已驗證成功的依據。

裝置上存在多份 VPN 設定時，請確認目前實際啟用的是哪一份，以及依需求連線的規則是否會自動啟用另一項流量接管。公司裝置可能有受管理的 VPN，一般使用者不應擅自刪除。部分網路隱私功能、描述檔或內容過濾機制也可能改變請求路徑；只有確認會影響測試時，才暫時調整，並在測試後還原。如果系統拒絕建立流量接管，請先正常中斷其他 VPN，再重新授權並連線。

排查行動裝置問題時，也要檢查用戶端是否被禁止使用行動數據、訂閱更新是否限定只能使用 Wi-Fi，以及省流量模式是否影響背景工作。如果訂閱只在行動網路上更新失敗，請先測試是否能連上服務位址，不要直接刪除應用程式；解除安裝可能也會清除本機設定和規則。重新安裝前，請使用用戶端支援的匯出或備份方式保存必要設定，並妥善保護其中的授權資訊。

若仍需回報問題，請整理裝置作業系統、用戶端名稱、是否使用其他 VPN、出問題的應用程式、網路類型，以及同一時間的去識別化日誌。若是初次設定時遺漏步驟，可回到快速入門教學核對；若已確認是訂閱或出口問題，請附上跨網路比較結果，聯絡相應的服務提供者。保留最近一次可用的設定，比在多台裝置上同時重設更容易復原。