Clash 疑難排解
連線與設定診斷

無法上網：確認流量在哪一層中斷

先回到對照環境，再判斷問題範圍

先關閉客戶端的系統代理與 TUN，再退出其他 VPN 或代理程式。開啟平時可直接連線的網站，確認本機 Wi-Fi、有線網路或行動網路正常。若關閉後仍無法連線，請優先檢查路由器、網路認證及系統殘留代理，不要繼續更換節點。公共網路可能需要先開啟認證頁面；若太早啟動代理，認證要求可能會繞道，導致所有網站都無法連線。

確認基礎網路正常後，重新啟動客戶端，確認已選取設定、核心正在執行，且代理群組有可用成員。介面顯示「已連線」可能只代表本機服務已啟動，並不表示遠端代理可連線。先用規則模式開啟同一個網站，再查看連線清單是否出現該要求。若沒有記錄，請優先檢查流量入口；若有記錄但連線失敗，則繼續檢查策略、節點與解析結果。

透過明確指定代理的要求區分入口與出口

確認設定中實際使用的混合連接埠，再執行以下測試。範例使用本機連接埠 7890；若設定不同，請將命令中的連接埠改為實際值。Windows 請使用 curl.exe，避免舊版 PowerShell 中同名命令的行為差異。測試目標也可換成目前無法開啟的網站，測試一兩次即可，不必進行並行壓力測試。

curl --proxy http://127.0.0.1:7890 --connect-timeout 10 --max-time 30 -I https://example.com

出現 Connection refused 通常表示目標連接埠沒有監聽，或填錯連接埠；若成功連上本機代理後才逾時，問題可能在出口節點、規則或遠端網路。收到 HTTP 狀態碼代表部分網路路徑已連通，但仍須確認狀態是由目標網站還是中介服務回傳。憑證錯誤應另外處理，不要以關閉憑證驗證來掩蓋原因。

檢查模式、代理群組與規則順序

規則模式會依設定中的順序比對，命中後使用對應策略。若某個網站被較前面的 REJECT 規則攔截，更換節點也不會改變拒絕結果；若代理群組目前選取 DIRECT，開啟介面上的代理開關也不會讓該連線自動改走遠端。查看連線詳細資料中的規則與實際路徑，比只看總開關更可靠。自訂規則中的策略名稱必須與現有代理群組完全一致。

可短暫切換至全域模式作為對照，並明確選取一個已確認可用的節點。若全域模式可用、規則模式不可用，請優先檢查規則命中、代理群組巢狀設定與直連解析；若兩種模式都失敗，則繼續檢查本機入口與節點本身。對照完成後請切回規則模式，避免全域轉送影響區域網路、辦公系統或流量計費。

修復後進行可重複的驗證

不要把偶然成功重新載入頁面當成修復完成。關閉原有連線或重新啟動測試應用程式，依序測試一個直連網站、一個需要代理的網站和一個區域網路位址；並確認連線清單符合預期。瀏覽器可能沿用舊連線，切換策略後，新舊要求可能走不同路徑。確認結果穩定後，儲存設定並記下有效連接埠、模式與所選代理群組。

節點逾時：分辨探測失敗與實際連線失敗

先確認逾時來自哪一種測試

節點清單中的逾時通常來自客戶端發出的探測要求，不代表所有實際連線都失敗。探測位址無法連線、受到目標限制，或回應內容不符合預期，都可能讓可用節點顯示異常。先選取該節點連線至實際目標，同時查看記錄。若網頁可正常使用但探測失敗，請檢查測試位址與逾時設定，不要直接刪除節點或認定訂閱失效。

若實際連線也失敗，請比較同一代理群組中的其他節點。全部失敗通常與基礎網路、帳戶狀態、共用設定或本機攔截有關；只有一個節點失敗，則較可能是節點端點、通訊協定參數或該線路異常。不要一次測試整份清單，以免大量並行連線觸發限制。依序測試兩個不同端點，就足以初步判斷。

根據記錄區分連線、交握與解析問題

dial tcp 後接著出現逾時，通常表示 TCP 連線階段未能及時建立；connection refused 表示連線遭主動拒絕，可能是連接埠未開放或服務未執行；交握失敗則表示流程已進入通訊協定或 TLS 階段。找出錯誤訊息中的目標是節點伺服器還是網站伺服器，兩者的排查方向不同，不要只擷取最後一個「timeout」。

節點端點使用網域名稱時，先確認該網域能否解析。解析失敗會讓所有依賴它的連線提早中止；解析到錯誤位址則可能造成交握失敗。TLS 類通訊協定還須核對系統時間、伺服器名稱與訂閱提供的參數。不要任意刪除 servername，或修改指紋、傳輸路徑；這些欄位通常必須與伺服器端一致，憑猜測修改只會增加變數。

確認通訊協定是否適用於目前網路

部分網路會限制 UDP。若 TCP 類型的節點可用，但依賴 UDP 的通訊協定持續失敗，可切換網路再次測試，藉此區分本機網路限制與伺服器端異常。Hysteria2、TUIC 等通訊協定的狀況，不能只用一般 TCP 連接埠測試來判斷；反過來說，TCP 連接埠可連通，也不代表代理通訊協定的驗證與轉送已成功。

辦公室、校園與公共 Wi-Fi 可能設有明確的存取政策。排查時請遵守網路管理規範，不要規避組織限制。可在允許使用的家用網路或行動網路上測試同一節點：若只有特定網路連線失敗，記下時間、通訊協定類型與錯誤階段，有助於服務提供者判斷問題。不要為了測試而將本機代理監聽開放給整個區域網路。

確認代理群組實際選取的節點

手動選取群組、自動測速群組與故障轉移群組的運作方式各不相同。介面選取上層群組時，實際出口可能來自另一層自動群組；上層顯示的名稱不一定是最終節點。展開連線路徑，確認是哪個成員處理該要求。自動選擇結果也可能受到探測快取影響，更新測試後仍須以實際要求驗證，不要只憑單一顏色或標籤下結論。

檢查服務狀態與流量額度。帳戶到期、節點遷移或並行連線數受限，都可能讓參數格式正確的節點無法使用。請先更新訂閱，再查看服務提供者公布的狀態；不要在公開討論區貼出完整節點 URI。節點密碼、UUID 與訂閱連結都可能授予存取權限，應與帳戶憑證同樣妥善保管。

修復步驟與回復原狀的界線

優先更新有效訂閱、選取已驗證的節點、還原服務提供者提供的原始參數，再切換網路重測。憑證錯誤不能靠長期設定 skip-cert-verify 解決；請先檢查時間與伺服器名稱，再由服務提供者處理憑證問題。暫時調高逾時值只適合判斷回應是否過慢，無法修復驗證失敗、網域錯誤或已關閉的連接埠。

若只有自動探測異常，可更換測試位址後重測，但請使用穩定且允許存取的目標。驗證時分別記錄「探測是否成功」與「實際連線是否成功」。若想了解延遲、流量倍率與地區的取捨，請參閱Clash 節點選擇說明；延遲低不代表頻寬充足，節點可用也不代表所有網站都接受該出口。

訂閱失敗：先區分要求失敗與設定解析失敗

確認匯入內容與錯誤發生階段

訂閱更新分為兩個階段：先從網址取得回應，再由客戶端或核心解析內容。連線逾時、憑證錯誤與 HTTP 狀態異常屬於要求階段；成功取得內容後出現 YAML 錯誤、未知欄位或代理群組參照錯誤，則屬於解析階段。請先完整閱讀錯誤訊息，確認失敗步驟。反覆點選更新通常無法解決連結過期或格式不相容的問題。

檢查貼上的內容是否含有前後空格、換行或中文標點。請匯入服務提供者給的訂閱網址，而不是帳戶後台、付款頁面或節點管理頁面的網址。連結中的查詢參數可能含有存取憑證，複製時若漏掉後半段，就會變成另一個要求。不要在公用終端機執行含完整訂閱連結的命令，也不要將連結貼入截圖或公開記錄。

根據 HTTP 回應判斷下一步

狀態碼只能提供排查方向，實際含義仍須以服務提供者的實作為準。驗證失敗或禁止存取可能與憑證、帳戶狀態及要求政策有關；找不到資源可能表示網址已變更；要求過多時應暫停更新。即使回應狀態表示成功，內容也可能是登入頁、維護頁或錯誤說明，而不是設定檔。瀏覽器能開啟網址，不代表客戶端收到的內容也相同。

避免更新流程形成啟動依賴

部分訂閱網址必須透過代理才能存取。如果目前代理節點剛好失效，而更新要求又依賴該節點，就會陷入無法取得新節點的循環。查看客戶端是否提供透過代理更新的選項；在網路允許時，可比較直連更新，或先使用保留的可用設定建立連線。不要一再將無法存取的訂閱網址轉換成不同連結，否則會掩蓋真正的網路路徑問題。

部分服務會依據 User-Agent 傳回不同格式。請優先使用服務後台中對應 Clash 或 mihomo 的匯入入口，並遵循其客戶端要求。隨意偽裝要求標頭，可能取得適用於其他客戶端的內容。將私人訂閱交給陌生的線上轉換服務，也會增加憑證外洩風險；若需要轉換，請先確認工具來源與資料處理方式。

排查 YAML 與核心相容性錯誤

YAML 使用空格縮排，請勿混用定位字元。錯誤行號有時指向解析器最後無法繼續的位置，真正原因可能出在上一行的引號、冒號或清單縮排。請先檢查錯誤行前後幾行，再檢查頂層結構。以下僅為合法的規則片段，並非可獨立連線的完整設定；其中的代理策略名稱必須對應現有設定中的群組名稱。

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

若 YAML 語法正確，但出現不支援某種通訊協定或欄位的提示，請確認實際執行的核心。客戶端名稱、介面版本與核心功能並不相同，舊版核心可能不支援 mihomo 擴充語法。不要只為了讓設定載入而刪除錯誤欄位，它可能是通訊協定必需的參數。可參閱mihomo 與原版核心的差異，了解相容性範圍。

保留本機修改並驗證更新結果

遠端訂閱更新可能覆寫直接編輯的內容。若客戶端支援覆寫、合併或本機規則，請將自訂項目放在相應層級，不要修改下載快取。更新後檢查節點清單、代理群組成員與規則是否符合預期，再選取一個節點實際連線。訂閱檔載入成功只代表解析通過，不表示所有遠端節點都在線。

若新設定無法使用，但舊設定仍正常，請先還原舊副本，保留新設定的錯誤記錄再繼續處理。不要一次清除所有設定與快取，以免失去比對依據。其他排查方向請參閱訂閱更新失敗自我檢查清單；修復後降低不必要的自動更新頻率，並確認重新啟動客戶端後仍能載入同一份有效設定。

速度慢：從節點、線路與本機三個層面排查

在相同條件下比較，避免混用不同指標

網頁載入慢、影片緩衝與檔案下載慢，不一定是同一個問題。先記錄目標、時段與操作方式：是開啟第一個頁面時等待太久，還是開始下載後傳輸速度持續偏低。測試期間暫停其他下載、雲端同步與系統更新，並保持裝置位置及網路不變。不同時段、不同網站的結果無法直接比較，否則難以判斷變化來自節點還是目標服務。

延遲測試主要反映探測要求的往返與處理時間，並非頻寬測量。低延遲節點仍可能壅塞，高頻寬節點也可能因跨區往返而讓網頁載入較慢。選擇兩個不同線路的節點，連線至同一個允許測試的目標，分別觀察首次回應與持續傳輸速度。避免反覆進行大量流量測試，訂閱流量會依服務提供者規則計算。

先檢查節點負載與網路線路

若只有一個節點速度慢，其他節點與直連都正常，請優先檢查該節點線路或負載。若夜間變慢、其他時段恢復，可能與共用出口或電信業者路徑壅塞有關。改測同一地區的另一條線路，比只換到鄰近地區更有診斷價值。地區標籤不代表實際線路、出口位址或目標內容服務相同，應以實際連線結果為準。

若所有節點都很慢，請先關閉代理，以一般網路連線作為基準。若直連下載也很慢，檢查 Wi-Fi 訊號、頻段、路由器負載與網路服務；情況允許時可改用網路線測試。若只有特定網站速度慢，可能與其內容傳遞路徑、限速或出口識別政策有關。更換測試目標有助於排除本機的一般性問題，但不能因此保證原本的目標一定可用。

區分 DNS 等待與傳輸瓶頸

首次開啟很慢、再次開啟明顯變快，可能與 DNS、TLS 交握或快取有關。查看記錄是否長時間停在解析階段，並檢查網域是否頻繁重試。若下載開始後仍持續緩慢，則應優先檢查線路吞吐量、封包遺失與伺服器限制。遇到速度問題時不要立刻更換所有 DNS；解析器變更可能改變內容傳遞位址，讓比較條件不再一致。

可透過一次明確指定代理的要求記錄耗時，不必安裝其他工具。以下命令會輸出總耗時與首位元組時間，數值來自實際要求。透過 HTTP 代理時，網域解析可能由代理核心或遠端執行，因此不能將結果當成獨立的 DNS 測試；這些數值只適合比較不同節點處理同一要求的表現。

curl --proxy http://127.0.0.1:7890 --max-time 30 -o /dev/null -sS \
  -w '首位元組：%{time_starttransfer}s\n總耗時：%{time_total}s\n' \
  https://example.com

Windows 請使用 curl.exe，並將輸出目標 /dev/null 改為 NUL，且將命令寫成單行。測試時使用回應內容很小的頁面，主要觀察等待時間，不用來判斷大型檔案的頻寬。若首位元組時間正常，但特定下載始終緩慢，請繼續檢查目標限速、下載工具的並行設定，以及代理規則是否命中同一個出口。

檢查本機流量接管與資源使用

比較系統代理與 TUN，但不要同時修改通訊協定、DNS 與代理群組。若只有 TUN 模式速度慢，請檢查是否同時執行其他 VPN、虛擬網卡工具或安全軟體，以及記錄中是否重複處理同一連線。工作管理員中的 CPU 使用率偏高或持續寫入磁碟，也可能影響網路體驗；短期診斷記錄完成後，請恢復一般記錄層級，避免長時間大量寫入。

大量連線、並行下載小檔案與背景同步會增加核心及裝置負擔。先關閉不相關的應用程式，再重複原本的單一工作。在路由器或低功耗裝置上，通訊協定加密與連線數量可能受處理能力限制。不要直接套用桌上型電腦的高並行設定，也不要永久關閉所有安全防護來提升速度；應透過程序、規則與時間比對找出衝突。

檢查 MTU 與分流設定

若小型要求正常，但大型頁面或長連線容易卡住，尤其只發生在 TUN 或特定網路下，可檢查 MTU、路徑封包遺失或 UDP 處理問題。先換用其他網路與通訊協定再次測試，確認差異穩定後，再小幅調整受支援的 MTU 設定並保留原值。沒有適用於所有裝置的通用最佳數值；盲目調低可能增加負擔，卻無助於解決問題。

最後核對速度慢的要求命中了哪條規則。有些下載實際上走直連，有些媒體要求則會分配至不同代理群組，因此不能把所有體驗都歸因於目前手動選取的節點。還原臨時設定後，以同一目標重新測試，並在相近時段再確認一次。分層記錄方式可參閱Clash 網速慢的分層診斷，避免將短暫波動誤認為持續故障。

DNS 問題：檢查解析路徑與 Fake-IP 對應

先了解系統解析與核心解析的差異

瀏覽器、安全軟體、作業系統與代理核心都可能參與網域解析。在終端機查得到網域，不代表應用程式使用相同結果；應用程式啟用加密 DNS 後，也可能略過系統解析器。先記下失敗的網域、錯誤訊息與目前的流量接管模式。若記錄中沒有相應的解析要求，應先檢查應用程式的解析路徑，而不是立刻替換核心中的所有 DNS 設定。

使用系統工具查詢可建立基準，但須了解測試範圍。nslookup 通常會向系統指定的 DNS 伺服器發出查詢；它無法完整模擬瀏覽器的加密 DNS，也不一定會經過目前的 HTTP 代理。查看回應中的伺服器與位址，再與客戶端記錄比對。若網域已成功解析但仍無法連線，請繼續檢查路由、規則、TLS 或目標服務，避免混淆問題層級。

nslookup example.com

了解 Fake-IP 的正常狀況

Fake-IP 會使用對應位址將網域名稱與連線關聯，方便核心依網域比對規則。啟用後看到對應範圍內的位址，不一定代表發生錯誤，也不能用一般直連方式確認該位址是否為真實伺服器。應用程式取得對應位址後，後續連線仍須由同一個核心接管；若只接管解析而未接管後續連線，對應位址就可能被送往錯誤路徑。

切換增強模式、重新啟動核心或更換設定後，應用程式可能仍快取舊的對應資料。先關閉相關應用程式，再依平台支援的方式清除快取並重新建立要求。Windows 可清除系統 DNS 快取，但瀏覽器與應用程式可能另有獨立快取，須重新啟動或透過其網路設定處理。不要反覆切換模式卻保留所有舊連線，否則新舊對應資料會混在一起。

ipconfig /flushdns

針對相容性問題設定排除項

區域網路裝置探索、部分遊戲與依賴真實位址的應用程式可能需要例外。請優先為明確受影響的網域設定 fake-ip-filter，不要排除所有網域。以下片段示範對應範圍與區域網路後綴的過濾設定，不含上游解析器，不能單獨取代完整的 DNS 設定。修改前請確認目前核心支援的過濾語法。

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter:
    - "*.lan"
    - "*.local"

私人 DNS 與企業內部網域通常需要組織提供的解析器。公共解析器無法取代內部 DNS，改用公共服務反而可能讓辦公系統失效。記錄問題是否只發生在公司網路，並確認網域後綴與 VPN 的解析要求。區域網路探索也可能依賴 mDNS 或廣播，單純新增網域過濾設定，不保證能恢復所有裝置探索功能。

排查上游解析器與節點網域的啟動依賴

加密 DNS 上游本身也可能使用網域名稱，因此需要先解析其位址；節點伺服器的網域同樣須在建立代理前取得有效結果。如果解析節點網域又依賴尚未建立的代理，就可能形成循環。mihomo 的 default-nameserver、proxy-server-nameserver 等設定各有不同用途，請先確認目前核心的設定語義，再針對問題調整。

啟用依規則處理 DNS 要求時，也須檢查解析器連線最後採用的路徑。不要同時新增多個彼此參照的策略，期待核心自行解決依賴問題。若記錄反覆查詢同一個上游網域，卻始終未能建立連線，請優先檢查啟動時的解析路徑。若上游逾時，應確認目前網路是否允許存取，而不只是看伺服器名稱是否常見。

排查 DNS 洩漏與解析結果異常

DNS 洩漏表示解析要求走了非預期路徑，不等於「結果中出現本地電信業者名稱」。網頁測試只能提供線索，可能受到快取、瀏覽器加密 DNS、IPv6 與測試服務觀察方式影響。請一併查看系統 DNS 設定、客戶端查詢記錄與應用程式設定，確認要求由誰發出、經由哪條路徑送出，再判斷是否偏離預期。

啟用 IPv6 時，也要一併檢查 AAAA 記錄與 IPv6 路由。只接管 IPv4 代理入口，不代表 IPv6 要求也會被接管；反過來說，直接關閉 IPv6 也可能影響原本正常的網路。先比對同一網域的位址類型與連線結果，再依平台設定完整接管或明確指定直連策略。術語說明請參閱Fake-IP 詞條。

系統代理無效：檢查入口、連接埠與 TUN 路由

系統代理不會接管所有應用程式

系統代理是作業系統提供給應用程式的一組代理設定，應用程式是否使用取決於自身實作。部分瀏覽器會讀取這些設定，部分命令列工具、遊戲與使用自有網路堆疊的程式則不會。若瀏覽器可用但某個應用程式無法連線，請先檢查該應用程式是否有獨立的代理選項，不要只憑系統代理開關就認定核心異常。只有需要接管更多流量時，才評估使用 TUN。

先測試明確指定代理的要求。若該要求正常，但依賴系統設定的連線失敗，代表本機代理服務與部分出口路徑可用，問題更可能出在系統設定或應用程式入口。若明確指定代理也無法連線，請檢查監聽連接埠、核心啟動狀態與設定載入情形。介面開關與作業系統中的實際設定值可能短暫不一致，尤其是在程式異常結束或多個程式爭用設定時。

檢查連接埠與監聽位址

mixed-port 同時提供 HTTP 與 SOCKS 入口，port 和 socks-port 則分別設定。不要將外部控制介面的連接埠誤填為代理連接埠；控制介面用來管理核心，並非轉送一般要求。修改設定後，請確認核心已重新載入；若舊程序尚未結束，也可能繼續占用原本的連接埠，導致介面顯示與實際監聽狀態不一致。

mixed-port: 7890
allow-lan: false
bind-address: "127.0.0.1"
mode: rule
log-level: info

以下是供本機使用的基本片段，須合併至現有設定中。只在本機使用時，保留迴送位址監聽即可，不必開放給區域網路。allow-lan 會影響其他裝置能否連線，並非修復本機系統代理的必要開關。若發生連接埠占用，請使用系統工具查出對應程序，再決定調整連接埠或停止衝突程式；不要任意結束不明的系統服務。

# Windows PowerShell
Get-NetTCPConnection -LocalPort 7890 -State Listen

# Linux
ss -lntp 'sport = :7890'

# macOS
lsof -nP -iTCP:7890 -sTCP:LISTEN

核對平台設定與命令列環境

Windows 中，使用者代理設定與 WinHTTP 代理是不同入口；讀取其中一套設定的程式，可能不受另一套影響。macOS 的代理設定會綁定網路服務，切換 Wi-Fi、有線網路或建立新服務後，請檢查目前使用的服務。Linux 桌面環境的代理設定也可能與終端機環境變數分開。排查時先確認目標應用程式讀取哪一層，不要把不同介面當成同一個開關。

命令列工具通常需要明確指定參數或環境變數。以下變數只會影響目前終端機及其後續啟動的子程序，不會修改所有應用程式。已開啟的終端機或背景服務可能仍保留舊值；NO_PROXY 中的例外也可能讓目標略過代理。若要在 SOCKS 代理端解析網域，可使用 socks5h 位址，是否支援則視工具而定。

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5h://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1

TUN 的權限、路由與排除項

TUN 透過虛擬網路介面接管流量，需要相應權限與路由設定。客戶端可能透過服務模式或系統授權完成這些操作；只在介面開啟開關，不代表路由已成功安裝。請先查看記錄中是否有權限、網卡或路由錯誤，再檢查實際使用的介面。企業裝置可能限制虛擬網卡，請遵守裝置管理規範，不要強行規避限制。

切換至 TUN 前，請先關閉其他 VPN，並保存目前的系統代理狀態。啟動後確認一般應用程式、命令列與區域網路都能正常使用；若辦公網段無法連線，請檢查自動路由與排除範圍。排除整個私人位址範圍不一定適用於所有網路，也可能影響原本需要透過 VPN 存取的資源。請依實際網路拓撲設定，不要照搬與目前環境無關的網段清單。

異常結束後的復原與驗證

客戶端結束後無法上網，常見原因是系統仍指向已停止的本機連接埠。請先在系統網路設定中還原原本的代理狀態，再確認應用程式能否直連。若 TUN 路由殘留，請透過客戶端正常關閉、還原網路服務或重新啟動裝置處理，避免手動刪除不明路由。若設定了開機自動啟動，也要檢查啟動順序；網路尚未就緒可能導致首次連線失敗。

需要常駐服務的 Linux 環境，可參閱mihomo 與 systemd 部署說明。修復後，請結束並重新啟動客戶端一次，確認監聽連接埠、代理設定與路由都能正確還原；最後再確認停止代理後網路也能正常使用，完成啟用與停用的完整驗證。

客戶端閃退：區分介面、核心與系統服務

先確認停止的是哪個部分

視窗消失不代表核心一定停止，系統匣圖示仍在也不代表核心運作正常。請檢查客戶端記錄與系統程序，區分介面閃退、核心結束及背景服務啟動失敗。介面問題通常影響操作與顯示；核心問題會直接影響代理監聽；服務問題則可能只影響 TUN 或需要較高權限的功能。記下問題發生在啟動、匯入設定，還是開啟某項功能之後。

優先使用正常結束方式關閉殘留程序，再重新啟動一次。多個執行個體可能爭用設定檔、控制介面或代理連接埠，讓第二個執行個體看起來像是閃退。若背景程序仍在執行，不要同時安裝另一個客戶端並啟用相同的流量接管功能。先確認舊執行個體已結束，再進行測試，以免將程序衝突誤判為軟體相容性問題。

透過設定比對確認是否由新修改觸發

若更新訂閱或編輯設定後發生閃退，請先還原上一份可正常啟動的副本。若舊設定正常、新設定失敗，請檢查語法、規則集載入、通訊協定相容性與檔案路徑。部分客戶端會在介面中提示設定錯誤，而核心已拒絕啟動；這不代表必須重新安裝才能解決。保留錯誤行號與附近內容，隱藏節點憑證後再進行分析。

以命令列部署的 mihomo 可使用測試模式檢查設定，但以下命令不能取代完整的執行驗證。請依安裝位置調整程式名稱與路徑；Windows 可能需要執行 mihomo.exe。圖形介面客戶端也可能內建檢查功能，應優先使用，以免另一個核心讀取相同設定目錄造成干擾。

mihomo -t -f ./config.yaml

若純規則設定可正常載入，但加入某個規則集後失敗，請檢查規則集路徑、格式與下載結果。相對路徑通常與設定目錄有關，不要假設工作目錄永遠相同。分批還原新增內容，找出確切的觸發項目，比清空所有檔案更有效。切勿刪除所有設定後，才發現訂閱網址與本機覆寫都沒有備份。

檢查架構、系統支援與權限

下載時請確認作業系統平台與處理器架構。Apple Silicon、Intel 與 ARM 裝置可能需要不同安裝套件；執行錯誤可能源自架構不符、系統元件缺失或作業系統版本不受支援。請前往下載中心核對相應套件與需求，不要只因檔名相似就拿來替換。新安裝時可優先考慮 Clash Plus，再依平台需求選擇其他客戶端。

設定目錄無法寫入、磁碟空間不足或記錄目錄權限異常，也可能導致啟動失敗。請確認目前使用者能讀寫客戶端自己的資料目錄，不要將整個系統目錄改成所有使用者皆可寫入。Linux 服務的執行使用者可能與互動登入的使用者不同；在終端機中可讀取設定，不代表 systemd 服務也有權讀取，請依實際服務身分核對權限。

以證據排查安全軟體與資源問題

安全軟體可能會攔截虛擬網卡、背景服務或程式啟動。請先查看隔離記錄與系統通知，確認遭阻擋的檔案與操作；不要長期關閉整套防護。若裝置由企業管理，請提供記錄並向管理員確認。若只在啟用 TUN 後閃退，請優先檢查網卡與特權服務；若一開啟視窗就失敗，則先檢查圖形元件與使用者資料。

記憶體或 CPU 使用量持續升高時，請檢查是否啟用了過於詳細的記錄、載入過大的規則集，或發生連線迴圈。資源用量升高只是現象，須與連線數量、記錄內容及觸發操作一起分析。先恢復一般記錄層級、關閉重複接管流量的程式，再觀察是否改善。對低記憶體裝置而言，精簡不必要的設定通常比繼續增加快取更合適。

在明確範圍內重設與遷移

重設前請先備份，再只移出疑似損壞的使用者狀態或快取檔案，讓客戶端重新建立。優先使用介面提供的重設功能，並先確認會刪除哪些內容。遠端訂閱、本機規則、代理群組選擇與系統服務設定並非同一份資料；遷移至其他客戶端時，也不能假設所有介面偏好都能隨 YAML 一併轉移。

Clash for Windows 與 ClashX Meta 已停止維護，若遇到新的系統相容性問題，應考慮遷移至仍在維護的方案。遷移前先匯出設定與自訂項目，再依下載頁面上的平台順序選擇客戶端；先驗證基本代理，再恢復 TUN 與啟動設定。不要同時讓舊客戶端與新客戶端在開機時接管網路。

手機問題：VPN 權限、背景執行與網路切換

從 VPN 授權與設定載入開始排查

手機通常透過系統 VPN 介面接管流量。首次連線須完成系統授權；成功匯入訂閱不代表已取得授權。先確認已選取設定且代理群組有可用成員，再啟動連線，並查看系統是否顯示 VPN 狀態，以及客戶端是否出現連線記錄。若授權遭拒或受到裝置管理限制，請先解決系統層級問題，不要重複匯入同一份訂閱。

同一裝置上的其他 VPN、工作設定檔、安全過濾功能與部分廣告過濾工具，可能會爭用流量接管能力。測試時只保留一套網路接管工具，並先停用其他同類服務。瀏覽器擴充功能類的過濾工具不一定會與 VPN 衝突，請依實際實作判斷。裝置受組織管理時，應遵守管理政策，不要刪除管理設定來強行啟動代理。

Android 背景執行與省電限制

Android 裝置在鎖定螢幕後斷線、回到應用程式後又恢復，通常與背景執行限制有關。檢查客戶端通知是否持續顯示，以及系統是否限制其背景活動；依裝置提供的電池設定允許必要的背景執行。各品牌的設定入口不同，不要照搬其他品牌的選單路徑。調整後請鎖定螢幕等待，再解鎖並測試連線、查看記錄，不要只看前景中的開關狀態。

「一律使用 VPN」與「沒有 VPN 時封鎖連線」會改變斷線後的行為。若啟用了封鎖連線，客戶端停止後整部裝置無法上網，可能是系統政策的正常結果。排查前先了解這些選項，再決定是否暫時關閉作為對照；診斷完成後請恢復原本需要的保護設定。不要把系統主動封鎖流量誤認為 DNS 或所有節點都已故障。

Android 客戶端也可能提供依應用程式代理或略過清單。若只有某個應用程式沒有記錄，請檢查它是否遭到排除，尤其是工作設定檔中名稱相同的應用程式。啟用略過後，該應用程式的行為就不能用代理群組解釋。Clash Plus、Clash Meta for Android、FlClash 與 Surfboard 的介面及設定支援各不相同，遷移時請逐項核對功能，不要直接複製所有偏好設定。

iOS 連線與客戶端選擇

在 iOS 上使用 Clash Plus 時，請先依系統提示加入 VPN 設定，再匯入有效訂閱並選取策略。系統顯示 VPN 狀態，表示接管通道已建立，但仍須透過實際要求確認出口。更換設定後若舊要求仍失敗，可先關閉測試中的應用程式再重新開啟，避免沿用舊連線而影響判斷。若裝置由公司管理，請先確認是否允許加入個人 VPN。

客戶端選擇與安裝方式請參閱iOS 下載說明，Clash Plus 官方網站為 clashplus.io。若應用程式內的設定失敗，請分別記錄匯入錯誤與連線錯誤，不要混為同一個問題。帳戶、訂閱服務與客戶端屬於不同環節，安裝應用程式不會自動提供可用節點。

分別測試 Wi-Fi、行動網路與熱點

若 Wi-Fi 正常但行動網路失敗，請檢查客戶端的行動數據權限、系統數據限制，以及服務提供者是否限制來源網路。反之，若只有 Wi-Fi 失敗，請檢查入口網站認證、路由器 DNS、網路通訊協定限制與該網路的管理規範。使用同一節點與目標，分別記錄兩種網路的結果，有助於縮小問題範圍；不要切換網路的同時又更換設定。

切換 Wi-Fi 與行動網路時，本機位址、IPv6 狀態與 NAT 對應可能改變，既有連線不一定能繼續使用。切換後請等待系統網路穩定，再重新發出要求；若持續無法恢復，可關閉並重新啟用客戶端連線，確認出口是否重新建立。只有切換瞬間失敗，與切換後持續失敗是不同狀況，應分開記錄。

手機開啟熱點，不代表下游裝置會自動透過手機 VPN 上網。是否轉送取決於作業系統與實作方式，不能以手機本身可開啟網頁來證明電腦已使用代理。請在下游裝置獨立驗證出口；若要共用代理，先確認客戶端支援的區域網路入口與網路隔離設定，並限制存取範圍，避免在公共熱點開放代理連接埠。

區域網路與修復驗收

投影、列印、區域網路管理與遊戲探索功能，可能依賴直連、廣播或本機解析。啟用代理後若這些功能失效，請檢查略過區域網路、路由與 Fake-IP 例外設定；不要只為了恢復投影就將所有流量改成直連。先找出特定應用程式與目標位址，再新增必要的例外。區域網路探索與公網網站存取應分別驗收。

最後完成四項驗證：前景使用、鎖定螢幕後恢復、Wi-Fi 與行動網路切換，以及停止客戶端後的網路狀態。確認自訂規則不會被訂閱更新覆寫，並保留一份可用設定。常見術語與問題請參閱說明中心；若是首次安裝或遷移，請回到快速入門教學重新建立基本連線，再逐步恢復背景執行、依應用程式分流與區域網路設定。