Clash 疑難排解
連線、訂閱與系統代理

無法上網：先區分問題所在

「開啟 Clash 後網頁無法開啟」不代表節點一定失效。網路認證尚未完成、系統代理仍指向舊連接埠、規則套用拒絕策略，或 DNS 查詢沒有回應，都可能造成相同的瀏覽器錯誤。先確認問題是在用戶端啟動前或啟動後發生，再判斷是所有應用程式都受影響，還是只有特定網站或程式異常。

關閉流量接管，確認基本網路正常

在用戶端關閉系統代理與 TUN 模式，保持用戶端開啟，再瀏覽平常可直接開啟的網站。若仍無法連線，請檢查 Wi-Fi 是否已連線、閘道是否可達，以及飯店或校園網路是否要求先登入網頁認證。基本網路尚未恢復前，別反覆更換節點，否則容易混淆網路本身與代理出口的問題。

若退出用戶端後網路仍持續中斷，請到系統網路設定檢查是否留有手動代理。先記下位址與連接埠，再停用失效的代理設定。若裝置由公司或機構管理，代理可能是組織網路政策的一部分，不應直接移除。基本網路恢復後重新啟動用戶端，第一輪測試只開啟系統代理，暫時不要同時啟用虛擬網卡和自訂 DNS。

查看連線紀錄，確認流量是否進入核心

開啟連線清單或日誌頁面，清除舊紀錄後重新連線至明確的目標網址。若出現對應連線，表示請求至少已進入核心，接著檢查匹配規則、出口策略與錯誤原因；若完全沒有紀錄，優先確認應用程式是否遵循系統代理、瀏覽器是否另設代理，以及核心是否確實啟動。介面顯示正在執行，不代表監聽連接埠一定可用。

連線紀錄中的拒絕、解析失敗與連線逾時，分別指向不同問題。拒絕通常要檢查規則或出口策略；解析失敗先查 DNS；連線逾時則檢查節點位址與網路路徑。記下目標網域、匹配的策略組和最終節點，別只看日誌最後一行錯誤。背景更新失敗也可能出現在同一頁，但不一定會影響目前的網頁請求。

規則分流：檢查匹配順序與最終出口

規則模式會依序比對，通常由最先符合的規則決定流量去向。先確認異常連線匹配了哪條規則，再檢查該規則使用的策略組是否存在、組內選擇是否有效。若全域模式正常、規則模式卻失敗，應優先檢查分流設定，不必立刻重新安裝用戶端。全域模式只能作為對照測試，不能證明所有網站都適合走同一個出口。

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

此範例假設已有名為 Proxy 的策略組，無法脫離完整設定單獨執行。末尾的 MATCH 用來處理前面未匹配的連線；組名的拼法與大小寫必須和定義一致。網域規則需要連線保留網域資訊，IP 規則則可能觸發解析，因此同一網站的不同連線不一定會匹配同一條規則。

以最小幅度調整確認問題是否排除

選擇已確認可用的節點，維持預設接管方式，重新開啟原本無法連線的網站，再測試另一個網站。若只有單一服務無法使用，請檢查服務本身狀態、帳戶限制與出口地區要求，不要據此判定整個用戶端故障。若所有請求都失敗，請看下一章檢查節點；若只有部分應用程式沒有連線紀錄，請前往系統代理失效章節。

節點逾時：分階段測試連線路徑

節點測試逾時，表示用戶端在測試條件下未能及時收到預期回應，不代表節點在所有情況下都無法使用。測試網址無法連線、節點網域解析錯誤、認證資訊失效或傳輸交握異常，都可能出現類似結果。應分開檢查本機到伺服器、通訊協定交握，以及伺服器到目標網站這三個階段，不能只看測試按鈕的顏色就下結論。

先確認測試對象與實際使用的節點

確認目前連線使用的是單一節點、自動選擇組還是故障轉移組。某些策略組內還有另一層策略組，介面最外層顯示的名稱不一定是實際出口。請在連線詳細資訊中展開完整路徑，確認目前使用的節點與剛才測試的相同。若組內自動選擇仍在切換，可暫時固定一個候選節點，減少測試變因。

比較兩種結果：用戶端內建測試是否失敗，以及瀏覽器透過該節點瀏覽一般網頁是否失敗。內建測試會連至指定的測試網址；遠端網站限制存取或回應方式改變時，實際瀏覽仍可能正常。不要為了讓測試顯示成功而隨意填入陌生網址，優先使用用戶端預設的測試目標，並確認目前網路可以連線至該目標。

依錯誤訊息判斷解析、連線或認證問題

日誌顯示找不到主機或無法解析伺服器位址時，先檢查節點伺服器網域與本機 DNS。若顯示連線遭拒，通常代表目標位址明確拒絕連線，可能是連接埠錯誤或服務未監聽。若顯示連線逾時，可能是網路封包遺失、存取受限或伺服器沒有回應。這些資訊只能縮小排查範圍，無法單獨證明伺服器永久離線。

若出現認證失敗、交握失敗或憑證錯誤，請確認訂閱是否仍有效、裝置時間是否正確，以及用戶端核心是否支援該節點設定。不要關閉憑證驗證來掩蓋問題；憑證名稱、伺服器名稱與傳輸參數應由設定提供者確認。只需將錯誤類別與發生時間提供給服務商，不必把節點密碼或完整連線字串貼到公開討論區。

改用另一個網路進行對照

在相同裝置與設定下，分別使用家用網路和手機熱點測試。若只有特定網路無法連線，優先檢查該網路的認證、存取政策與 DNS；若不同網路都失敗，但同一訂閱的其他節點正常，問題較可能出在單一節點或通訊協定參數。使用手機熱點會消耗行動數據，先進行少量網頁測試即可，不必馬上測試大型檔案下載速度。

也可以在另一台裝置上用同一組有效訂閱測試，但請遵守訂閱服務的裝置數量與同時連線限制。另一台裝置能用，只能說明設定在該環境可行，仍須比較核心支援、系統時間與流量接管設定。避免同時開啟多個用戶端測試同一帳戶，以免帳戶端的同時連線限制造成新的逾時或斷線。

分辨節點故障與特定通訊協定受限

網頁可以開啟，但語音、遊戲或即時通訊失敗時，請確認應用程式是否依賴 UDP，以及節點、策略組與流量接管方式是否支援相應流量。HTTP 代理可處理的應用程式流量，與虛擬網卡接管的範圍並不完全相同。不要把單一即時功能失敗直接歸咎於整個節點，也不要因為網頁正常就認定所有傳輸方式都已測試通過。

確認節點故障後，手動更新訂閱並改用其他可用節點。單純增加逾時時間只會延長等待，無法修正錯誤位址、認證失敗或無法連線的路徑。更新後若仍全部無法使用，請前往訂閱章節確認設定來源；用戶端選擇與平台相容性請參閱下載中心，初次選擇可優先考慮 Clash Plus。

訂閱失敗：檢查伺服器回傳內容

匯入訂閱包含取得內容、解析格式與載入設定三個步驟。連結請求失敗和 YAML 語法錯誤並非同一問題，處理順序也不同。先記下完整錯誤訊息，判斷問題發生在下載階段還是載入設定階段。原本已生效的設定通常仍可用來復原；確認新訂閱可用前，先不要刪除所有舊設定和節點。

確認連結完整，帳戶狀態正常

請從服務商的帳戶頁面重新複製訂閱連結，避免聊天軟體插入換行、瀏覽器省略顯示或手動選取不完整。檢查連結前後是否多了空格或引號，尤其留意查詢參數是否遭截斷。訂閱網址通常包含存取憑證，切勿貼到公開文章、線上格式化工具或不熟悉的轉換服務。截圖時也要遮住網址列和 QR Code。

如果帳戶已到期、流量額度用完或訂閱連結已重設，用戶端重試也無法恢復權限。請先到服務商頁面確認帳戶狀態，再使用新連結更新。若在瀏覽器開啟連結後出現登入頁、驗證碼、拒絕存取或一般網頁，代表用戶端取得的可能不是設定內容。不要把這類網頁另存為 YAML 匯入，因為仍無法通過設定解析。

區分網路錯誤、狀態碼與格式錯誤

遇到請求逾時或連線失敗時，先確認裝置的基本網路與系統時間。若設定頁面提供直連或透過代理下載的選項，可記下原設定後進行一次對照；需要透過代理才能更新的訂閱，必須先有可用出口，不能依賴尚未匯入的節點。若目前沒有任何可用設定，請向服務商詢問適用於目前網路的正式匯入方式。

權限相關狀態碼通常需要檢查帳戶或連結；遇到頻率限制時，應暫停反覆重新整理，並依服務商提示等待。解析錯誤則要檢查回傳格式：提供給其他用戶端的節點清單、單一分享連結與 Clash 設定檔並不相同。確認訂閱頁面選擇的是適用於 Clash 或 mihomo 的輸出類型，再嘗試匯入，不要只靠更改副檔名解決。

config.yaml：從第一個錯誤位置開始排查

YAML 對階層與縮排很敏感。優先檢查錯誤提示附近及前一行，使用空格而非定位字元縮排，並確認冒號、清單短橫線與引號是否成對。錯誤位置可能只是解析器發現問題的位置，真正原因可能是更前面的字串沒有結尾。編輯前先複製原始檔，修正一個錯誤後重新載入，不要一次重新整理整份設定。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
dns:
  enable: true
  listen: 127.0.0.1:1053

此範例僅用來說明階層關係，不含節點與策略組，並非完整訂閱。頂層欄位與 dns 同一層，enable 和 listen 則屬於 DNS 子項目。除了語法，也要檢查策略組是否引用不存在的節點、規則是否使用未定義的組名，以及設定是否包含目前核心不支援的通訊協定欄位；這些問題需搭配載入日誌判斷。

檢查覆寫與自動更新是否影響結果

訂閱原始檔正確，但生效設定出現錯誤時，請檢查用戶端的設定合併、指令碼處理與覆寫功能。先備份自訂內容，再暫時停用後重新載入，分辨問題出在訂閱原始檔還是本機處理。不要直接修改快取檔作為長期修復方式，因為下次更新可能會覆蓋；需要保留的設定應放在用戶端支援的持久性覆寫位置。

自動更新失敗不一定代表目前連線也失效。查看最近一次成功時間和失敗原因，先手動更新並確認新設定可載入，再設定合適的更新間隔。裝置休眠、背景執行限制與網路切換都可能讓排程延後。更詳細的檢查順序請參閱訂閱連結解析失敗自我檢查清單；匯入位置請參閱訂閱匯入教學。

速度慢：分別檢查延遲與傳輸速度

網頁載入慢、下載速度低和影片頻繁緩衝，可能分別與 DNS 查詢等待、往返延遲及持續傳輸能力不足有關。用戶端的測試結果主要反映特定請求的回應時間，不能直接當成下載頻寬。排查時先選一項能穩定重現的工作，例如開啟同一個網頁或下載同一個檔案，記錄網路、節點與時段，再一次只改變一項條件進行比較。

先比較直連與代理的速度基準

暫停其他下載、雲端同步與系統更新，並確認同一網路中的其他裝置是否占滿頻寬。先用可直接連線的資源觀察基本網路狀況，再透過代理存取相同或類似資源。若直連速度本來就慢，應先處理 Wi-Fi 訊號、路由器負載或寬頻連線；用戶端無法增加網路頻寬，也無法消除網路壅塞造成的封包遺失。

Wi-Fi 測試容易受到距離、頻段與周遭干擾影響。電腦可暫時改用有線網路，手機可移至路由器附近重新測試，但其他條件應保持一致。不要直接比較不同網站的瞬間峰值來判斷節點優劣，因為網站伺服器、內容傳遞路徑與帳戶限速都可能不同。持續傳輸時的穩定速度，通常比剛開始幾秒的峰值更有參考價值。

依載入階段找出瓶頸

點選連結後等待很久才開始顯示，但圖片隨後載入很快，應優先檢查 DNS、建立連線與交握；若頁面立刻出現，但大型檔案長時間下載緩慢，再檢查出口頻寬與遠端限制。若只有第一次開啟較慢，之後明顯改善，可能與解析快取、連線重用或資源快取有關。重新測試時請註明是否為首次瀏覽，避免把快取差異誤認為設定最佳化。

查看用戶端連線清單，確認速度慢的請求確實經過預期節點。一個頁面通常會連線至多個網域，主網站、圖片和影片資源可能匹配不同規則。只切換頁面主要網域的規則，不一定會改變媒體連線的出口。先找出實際載入緩慢的資源網域與最終策略，再決定要調整哪條規則；不要只為了解決一部影片，就長期將所有流量切換至全域模式。

比較節點路線，不只看地理距離

距離近不代表路由較短，測試回應快也不代表持續下載速度快。選兩到三個已確認可用的節點，在相近時段進行相同測試，比較連線穩定度、封包遺失與持續傳輸速度。若只在晚間壅塞，記下發生時段並提供給服務商；若只有特定網站一直很慢、其他網站正常，問題較可能與目標服務、出口地區或內容傳遞路徑有關。

裝置效能也會影響速度。查看系統工作管理員中的處理器使用率與記憶體負載，關閉大量閒置連線及重複執行的代理工具。詳細日誌可短時間協助定位問題，但長期保持高頻率除錯輸出會增加儲存寫入與處理負擔。排查完成後請恢復一般日誌層級，不要把關閉所有日誌當成通用的加速方法。

謹慎調整 MTU、IPv6 與即時流量

若只有啟用 TUN 後才發生大型檔案下載停滯或部分頁面卡住，而系統代理正常，可檢查虛擬網卡、路由與路徑 MTU。先還原用戶端預設設定，再依用戶端文件逐項調整並記下原值。MTU 過大可能造成特定路徑傳輸異常，過小也會增加負擔；寬頻、手機熱點與隧道沒有通用的最佳固定數值。

IPv6 支援不完整、UDP 無法使用，或即時應用程式採用不同傳輸路徑，都可能造成網頁測速結果與實際使用體驗不同。請依應用程式需求分別測試，不要只因一次測速就關閉整個系統的 IPv6。若問題只在特定接管方式下發生，請參閱TUN 模式與系統代理比較，確認接管範圍後再調整設定。

DNS 問題：確認由哪一層負責解析

DNS 問題常見症狀包括網域無法開啟、部分應用程式顯示離線，或連線日誌反覆出現解析失敗。系統解析器、瀏覽器安全 DNS、用戶端內建 DNS 與節點伺服器網域解析，可能同時參與一次連線。先找出哪一層回報錯誤，再決定要調整的位置；只把系統 DNS 換成某個公用位址，不一定會影響用戶端實際採用的解析路徑。

分別查看系統與用戶端的解析結果

先在終端機使用系統工具查詢一個公開網域，確認系統是否有回應，再查看用戶端日誌中同一網域的處理結果。以下指令用來檢查系統目前的解析路徑，無法單獨證明代理連線正常。若系統查詢成功但用戶端失敗，請檢查核心的 DNS 設定；若系統查詢也失敗，則繼續檢查網路認證、解析器是否可連線與本機網路政策。

nslookup example.com

查詢逾時和網域不存在代表不同問題。前者可能是解析器沒有回應，後者可能是網域確實不存在或解析結果異常。也要確認是否只有節點伺服器網域解析失敗：核心必須先解析伺服器位址才能建立代理，若這一步又依賴尚未建立的代理，就會形成循環。請依用戶端文件設定節點網域的解析路徑，不要隨意複製整段 DNS 範本。

了解 fake-ip、快取與瀏覽器安全 DNS

啟用 fake-ip 後，用戶端可能會回傳專用位址範圍內的對應位址給應用程式，再由核心連結至真實網域。這是流量接管機制的一部分，不能只因查詢結果不是公用 IP 位址就判定解析異常。重點在於後續連線是否仍回到同一個核心，以及對應關係是否存在。如果流量繞過用戶端，直接連線到對應位址，應用程式就可能無法連線。

瀏覽器啟用獨立的安全 DNS 後，可能會略過系統解析路徑，造成瀏覽器與其他應用程式的表現不同。排查時記下目前設定，再暫時改用系統解析進行比較。不要同時更換瀏覽器解析器、用戶端上游 DNS 與系統 DNS，否則恢復正常後無法判斷哪個調整有效。區域網路裝置名稱與內部網域則應保留網路原本需要的解析路徑。

切換設定後，舊連線與快取可能仍沿用先前的結果。先關閉出錯頁面並重新建立連線，再視情況清除對應層級的快取。Windows 可使用下方指令清除系統 DNS 快取；此操作不會清除用戶端內部或瀏覽器快取，也無法修復無法連線的上游伺服器。其他平台請依系統文件操作，避免執行來源不明的一鍵網路重設指令碼。

ipconfig /flushdns

GeoIP 更新：與 DNS 資料分開檢查

GeoIP 資料會依 IP 位址的地理位置協助判斷規則，不負責將網域轉換成 IP。下載資料失敗時，先查看日誌是否明確提到資源檔、下載網址或讀取錯誤，再檢查用戶端的資料更新功能、儲存權限與網路狀態。不要因為某個網域無法開啟就直接重建地理資料庫，也不要混淆網域規則資料、IP 地理資料與 DNS 快取。

若日誌顯示資料庫缺漏，請先使用用戶端支援的更新功能；完成後重新載入設定，確認錯誤已消失。資料來源與格式必須符合目前核心及設定，不要只把其他格式的檔案改名後取代。若更新需要代理，但目前出口無法使用，請先恢復可用出口，或依用戶端文件使用可連線的下載方式，避免不斷重試同一個失敗工作。

處理 IPv6 與區域網路解析問題

網域可能同時回傳 IPv4 與 IPv6 位址，但目前網路不一定具備完整的 IPv6 對外連線路徑。若日誌顯示只有 IPv6 連線失敗，請比較系統、核心與節點的支援情況，再進行暫時性的對照測試。不要長期封鎖所有 IPv6 來代替問題排查。印表機、網路儲存裝置與公司內部網域失效時，先確認它們是否被錯誤導向代理解析或代理出口。

確認修復時，應以「目標應用程式可正常連線、連線採用預期策略、內部資源仍可使用」為準，而不只是看單次查詢結果。想了解設定欄位的所屬層級，請參閱config.yaml 結構詳解；常見問題可至說明中心繼續查閱。

系統代理失效：檢查監聽與流量接管

系統代理是作業系統提供給應用程式使用的代理設定，不是強制接管所有網路流量的開關。瀏覽器可能會遵循這項設定，但命令列工具、遊戲或部分商店應用程式可能使用自己的網路堆疊。因此，「瀏覽器可以用，終端機卻不行」不一定代表系統代理設定失效。先確認目標程式支援哪種代理方式，再檢查用戶端監聽位址是否與系統設定一致。

確認實際監聽連接埠與系統位址一致

在用戶端設定或生效設定中查看混合連接埠，不要假設所有裝置都使用 7890。系統代理應指向目前裝置的迴圈位址與實際監聽連接埠。若曾執行其他用戶端，它可能仍保留舊連接埠，或在背景持續改寫系統設定。先結束其他代理程式，再關閉並重新啟用目前用戶端的系統代理，觀察系統設定是否同步更新。

可使用支援代理參數的命令列工具，略過系統代理開關，直接測試本機連接埠。以下指令假設用戶端在本機的 7890 連接埠監聽，實際使用時請換成設定中確認的連接埠。若指定代理後可以連線但瀏覽器失敗，請優先檢查瀏覽器獨立設定、擴充功能與系統代理；若指定代理也無法使用，則回頭檢查監聽、節點與規則。

curl --proxy http://127.0.0.1:7890 --head https://example.com

區分圖形介面、終端機與系統服務

部分終端機工具會讀取環境變數，另一些則只讀取各自的設定檔；Windows 的不同代理介面也可能分別供不同類型的程式使用。修改其中一組設定，不代表所有系統服務都會跟著變更。先查看目標工具的代理文件，使用單次命令參數測試；確認有效後，再決定是否要永久套用，避免把代理變數寫入全域環境後忘記還原。

指定代理參數可以連線，但一般命令失敗時，請檢查工具是否設定了獨立代理、直連例外或舊的環境變數。變數中的位址應與目前用戶端一致，例外清單也可能使目標網域略過代理。排查時只修改目標工具的設定，不必立即重設整個系統網路。結束用戶端後，也要檢查是否還有指向已停止連接埠的永久設定。

需要使用 TUN 時，先確認權限與路由

TUN 透過虛擬網路介面接管流量，可涵蓋部分不遵循系統代理的應用程式，但通常需要相應的系統權限、服務元件與路由支援。啟用失敗時先查看用戶端日誌中的權限、建立裝置或路由錯誤，不要反覆點擊開關。安裝服務或授權網路延伸功能時，請依用戶端提供的正常流程操作，完成後確認核心確實已建立介面。

其他 VPN、虛擬機器網路、容器網路與安全軟體可能和路由規則衝突。先記下目前執行中的網路工具，在允許的情況下逐一暫停並進行比較；不要直接關閉系統防火牆或刪除不明網卡。遠端操作裝置時尤其要小心，調整預設路由可能立即中斷遠端工作階段；繼續操作前，請先確保能在本機操作或有其他復原管道。

區域網路分享與退出後還原

其他裝置連線至電腦代理時，不能填入 127.0.0.1，因為這個位址永遠代表裝置本身。應填入電腦目前在區域網路中的位址，並確認用戶端允許區域網路連線、監聽範圍正確，且防火牆只放行必要的網路。不要將代理連接埠暴露至公用網際網路；不再分享時請關閉相關設定，位址變更後也要同步更新其他裝置的設定。

正常結束用戶端前，先關閉系統代理與 TUN，並確認直連網路已恢復。若強制結束程序後無法上網，請手動停用殘留的系統代理，再重新啟動用戶端完成清理。完整分享步驟請參閱混合連接埠與區域網路連線說明；基本開關位置請參閱系統代理設定教學。

用戶端閃退：保留設定後再復原

視窗閃退、介面空白、核心反覆重新啟動與設定無法儲存，需要分開處理。圖形介面負責顯示與管理，核心負責實際代理，兩者可能各自發生問題。先確認程序是否仍在執行、是否能開啟系統匣，以及代理連接埠是否仍在監聽。介面關閉但網路仍正常，可能只是視窗隱藏；核心已退出但介面仍開啟，也可能讓人誤以為所有節點都失效。

先確認安裝檔、權限與執行環境

確認安裝檔的平台與處理器架構相符，且作業系統版本符合用戶端需求。macOS 要區分 Apple Silicon 與 Intel；Linux 要確認發行版及套件類型；Windows 則需檢查系統安全提示與安裝目錄權限。不要從不明的彈出視窗下載所謂修復元件，也不要為了啟動程式而長期關閉系統安全機制；請優先依用戶端文件所述的方式安裝與授權。

若安裝在受保護的目錄、免安裝版執行目錄無法寫入，或磁碟空間不足，都可能造成設定無法儲存或啟動失敗。請檢查用戶端實際使用的資料目錄，而不只是程式安裝目錄。公司裝置可能限制背景服務與網路延伸功能，此時應依裝置管理規範處理。以系統管理員權限執行可作為有依據的測試，但不能取代修正錯誤的目錄權限。

區分介面故障與核心載入失敗

介面可以開啟但核心無法啟動時，先查看啟動日誌。連接埠被占用、設定欄位錯誤、策略組引用無效或資料檔缺漏，通常都會出現明確提示。不要立刻刪除所有使用者資料；先用用戶端內建的檢查或載入功能檢查設定，再停用最近新增的覆寫、指令碼與規則資源。還原至先前可用的設定後，再逐項重新加入修改。

發生連接埠衝突時，先找出占用者是否為舊用戶端或殘留核心，再正常結束對應程式。若確實需要更改連接埠，也要同步更新系統代理、終端機設定與分享裝置設定。只修改設定中的監聽連接埠，卻保留舊的系統位址，會讓啟動問題變成新的斷網問題。若介面空白或顯示異常，請依用戶端文件檢查圖形執行環境，避免直接套用其他軟體的啟動參數。

備份後建立最精簡的執行環境

重設或重新安裝前，先匯出訂閱設定、記下策略組選擇，並備份覆寫內容與必要設定。備份應保存在自己可控的位置，因為其中可能包含訂閱憑證與節點認證資訊。只解除安裝程式不一定會刪除使用者資料，因此「重新安裝後仍閃退」不代表安裝檔一定有問題；舊設定或快取可能在重新啟動時再次載入。

若用戶端提供重設功能，先了解其影響範圍；若說明不清楚，可在完全結束相關程序後備份並暫時移開資料目錄，不要直接永久刪除。重新啟動後先使用預設設定，確認空白環境能穩定開啟，再匯入一份已知有效的設定。若匯入後馬上重現問題，優先檢查該設定與資源；若空白環境也會閃退，再檢查系統相容性與安裝環境。

選擇持續維護的用戶端並整理回報資訊

新安裝可優先考慮 Clash Plus，也可依平台選擇 Clash Verge Rev、FlClash 等用戶端。Clash for Windows 與 ClashX Meta 已停止維護，舊環境的問題不一定能靠重新安裝解決。切換用戶端前先確認訂閱格式相容，不要直接複製整個使用者目錄；設定檔、應用程式設定與快取資料通常不能視為同一類資料搬移。

回報時請提供作業系統平台、處理器架構、用戶端名稱、實際安裝資訊、觸發步驟，以及相關的最後幾行日誌。避免提出無法重現的結論，例如只憑一次閃退就認定系統不支援。日誌若包含帳戶、訂閱或節點資訊，請先移除敏感內容；若排查時曾啟用詳細日誌，問題解決後請恢復一般層級，並視需要清理本機診斷檔案。

手機問題：檢查 VPN 與背景執行

手機上的代理連線依賴系統 VPN 介面或網路延伸功能，運作方式與桌面系統代理不同。狀態列出現 VPN 圖示，只能表示系統建立了相應介面，不能證明訂閱、節點與分流設定都正確。先讓用戶端保持在前景完成一次連線測試，再觀察鎖定螢幕、切換應用程式與更換網路後的狀況，分別記錄首次連線失敗和背景中斷。

Android：確認授權並排除其他 VPN 衝突

首次連線時請完成系統 VPN 授權，並確認目前啟用的是目標用戶端。過濾工具、工作設定檔與其他 VPN 應用程式可能爭用相同的流量接管介面，造成連線剛建立就中斷。先到系統設定查看目前使用的 VPN，不要同時反覆啟動多個應用程式。若裝置由公司或機構管理，工作設定檔與個人設定檔的網路政策可能不同，應分別確認適用範圍。

若只有鎖定螢幕後才斷線，請檢查系統是否限制用戶端的背景活動、電池使用或行動數據。將用戶端加入系統允許背景執行的清單，再測試鎖定螢幕時的狀況；各品牌設定名稱可能不同，請以實際系統頁面為準。不要把所有應用程式都設為不受限制，也不要只因通知消失就判定代理已停止，仍須搭配用戶端狀態與實際連線結果確認。

Android 的依應用程式代理設定，可能只接管指定應用程式，或將某些應用程式排除在外。若一個瀏覽器可以連線、另一個卻不行，先確認應用程式是否在接管範圍內，再檢查規則。更新應用程式或切換工作設定檔後，也要重新確認選取結果。基本匯入與授權流程請參閱Android 入門步驟，不要把桌面教學中的系統代理開關名稱直接套用到手機介面。

iOS：確認網路延伸功能與設定已啟用

iOS 可優先選擇 Clash Plus，請透過iOS 下載入口查看 App Store 連結；用戶端官網為 clashplus.io。完成系統授權後，也要確認訂閱已載入，且策略組已選擇可用項目。只建立 VPN 設定但未匯入可用節點，無法建立實際代理連線。

從其他網路工具切換過來時，請確認系統目前使用的 VPN 設定是否正確，並在舊工具中關閉可能自動重新連線的選項。應用程式內顯示連線成功後，請用相同網頁再次測試；若只有一個應用程式異常，請檢查它的獨立網路行為與分流結果。不要反覆刪除所有系統設定，先確認是否是舊工具重新接管流量所致。

切換 Wi-Fi、行動網路與手機熱點

從 Wi-Fi 切換至行動網路後，原有連線可能仍依賴舊位址與舊路徑。先等網路穩定，再從用戶端中斷並重新連線，建立新的工作階段。若只有行動網路無法使用，請檢查用戶端與目標應用程式是否允許使用行動數據，並比較節點網域解析與網路通訊協定支援情況。不要只因切換網路當下短暫失敗，就判定訂閱失效。

需要網頁認證的公共 Wi-Fi，請先暫停代理並完成網路登入，再恢復連線。手機分享熱點不代表連上熱點的裝置會自動經過手機代理，系統處理分享流量的方式可能與手機本身不同。若需要分享，請使用用戶端與系統明確支援的方式，並參閱區域網路代理分享說明確認位址與安全範圍。

保留可還原的設定，完成最後驗證

Android 的永遠開啟 VPN、封鎖未經 VPN 的連線，以及用戶端的自動連線選項，可能會在服務停止時讓裝置完全無法上網。先記下這些選項目前的狀態，再依系統說明暫時停用以進行對照；排查完成後，依使用需求恢復設定。刪除應用程式或設定失效後，也要確認系統是否仍要求透過已不存在的連線對外連線。

手機端的最後驗證至少應涵蓋前景瀏覽、鎖定螢幕後恢復，以及 Wi-Fi 與行動網路切換三種情境。每次都使用相同目標，確認實際出口是否符合預期，不要只看狀態列圖示。若仍無法定位問題，請整理裝置系統、網路類型、用戶端名稱、錯誤時間與已去除敏感資訊的日誌，再到說明中心查閱常見問題；重新設定時請回到入門指南，依照單一流程逐步復原。