Clash 疑難排解指南

無法上網：從本機入口追查至遠端出口

先確認問題影響範圍

能開啟用戶端介面、代理開關也已啟用，不代表網路請求已成功。請先記下發生時間、網路類型、目前設定與出問題的應用程式，再分別開啟一個通常可直接連線的網站，以及實際無法瀏覽的網站。關閉代理後重測：若兩者都無法連線，應先檢查 Wi-Fi、閘道器或網路驗證；若只有啟用代理後才失敗，則優先檢查本機監聽、規則與遠端出口。

暫時關閉其他代理程式、瀏覽器代理擴充功能，以及可能接管網路的工具，避免多個程式反覆覆寫系統設定。請勿立即刪除設定，也不要同時啟用系統代理與 TUN 碰運氣。先保留目前記錄，從一種接管方式開始重現問題。若裝置受公司管理政策控管，請遵循管理規範，不要移除安全元件來排除衝突。

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

請在用戶端設定中查看混合連接埠，並確認核心已啟動。以下指令中的連接埠僅為範例，必須改成實際監聽值。明確指定代理，可暫時排除瀏覽器是否遵循系統代理這個變因。在 Windows 上使用 curl.exe，可避免部分終端機將同名指令解析為別名；其他平台通常直接使用 curl。

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

若連線至本機連接埠時立即遭拒，表示請求尚未進入代理核心，應優先檢查核心狀態與連接埠。若等待遠端連線時逾時，請接著查看記錄中的目標位址、命中規則與出口。收到 HTTP 回應但狀態碼不成功，也表示部分連線路徑已建立；伺服器拒絕、要求登入或限制內容存取，不能一概視為本機代理失效。上述指令只檢查回應標頭；若網站不支援這種請求方式，請改用一般 GET 請求重測。

分辨規則命中與出口是否可用

開啟連線或記錄頁面，重現一次失敗的請求，確認網域實際命中哪條規則、進入哪個代理群組，以及該群組選用了哪個出口。在規則模式下，目標可能走直連，也可能命中拒絕規則。短暫切換至全域模式僅供比對：若全域模式可用、規則模式失敗，請優先檢查規則順序與代理群組選擇；若兩種模式都失敗，則繼續檢查出口連線，不必反覆修改分流清單。

同一個網頁可能會載入登入網域、靜態資源與 API 網域。若首頁能顯示，但登入按鈕一直轉圈，通常應檢查失敗的子請求，而不是只替首頁新增規則。可透過瀏覽器開發人員工具的網路面板找出失敗網域，再與用戶端的連線記錄比對。提供截圖前，請遮蔽完整網址中的查詢參數、帳號識別資訊與訂閱資料；保留錯誤名稱和規則命中結果即可。

最後請以相同目標確認是否復原：分別確認明確指定代理的請求、瀏覽器，以及其他需要代理的應用程式都能正常使用。還原規則模式並關閉暫時開啟的偵錯記錄，避免將測試狀態當成長期設定。若瀏覽器仍無法使用，但指令測試成功，請前往系統代理章節；若記錄指出解析錯誤，請參閱DNS 章節。更精簡的逐項檢查流程，請見已連線卻無法開啟網頁檢查清單。

節點逾時：分別檢查解析、交握與傳輸

確認錯誤發生在哪個階段

介面顯示的逾時可能來自測速網址，也可能是實際服務請求；兩者不能互相取代。單次測試失敗不一定代表出口完全無法使用：測試目標可能限制存取，測試請求也可能受規則影響。請先選定一個出口，以相同目標重複少量請求，再查看對應時間的記錄，分辨是伺服器網域解析失敗、連線伺服器逾時、通訊協定交握失敗，還是目標網站回應過慢。

連線遭拒通常表示目標位址拒絕連線，或中間設備主動拒絕；連線逾時則只表示等待期間未收到預期回應，不能據此斷定伺服器已關閉。驗證失敗、憑證名稱不符等錯誤屬於不同線索，不應靠延長逾時時間來掩蓋。記下完整錯誤訊息，比只截取紅色的逾時標籤更有助於診斷。

檢查系統時間與伺服器入口設定

啟用系統自動校時，確認日期、時區與實際時間一致。使用憑證的連線會驗證憑證有效期間；系統時間錯誤可能導致原本可用的設定持續交握失敗。接著確認訂閱更新後的伺服器位址、連接埠與傳輸參數沒有被本機設定覆寫。複製節點時若漏掉路徑、服務名稱或傳輸層設定，可能出現底層連線已建立、代理通訊協定卻始終無法完成交握的情況。

若要單獨測試伺服器連接埠，可以在 PowerShell 中執行下列指令。範例網域僅用來說明語法，請替換成設定中的伺服器位址。測試成功只代表 TCP 連接埠可連線，無法證明驗證、TLS 或上層代理通訊協定正常；測試失敗也無法據此判斷僅使用 UDP 的服務。請勿為了測試而公開完整節點設定。

Test-NetConnection -ComputerName example.com -Port 443

不建議將停用憑證驗證當成一般修復方式。遇到憑證錯誤時，請檢查伺服器名稱、系統信任鏈、系統時間，以及網路中是否有受管理的檢查設備。若設定需要特定 SNI 或傳輸路徑，請向服務提供者確認參數，不要自行猜測。若仍在使用過期訂閱中保留的舊入口，更新訂閱或許能解決問題，但更新前仍應備份本機覆寫設定。

透過網路比對確認本機網路限制

維持相同裝置、設定與目標，只將網路從目前的 Wi-Fi 切換為手機熱點。若熱點可用、原網路不可用，問題範圍便縮小至原網路路徑、驗證狀態或存取政策。接著可用同一網路上的另一台裝置進行比對。請勿同時更換用戶端與出口，否則測試變因太多，復原後也無法確認真正原因。

部分網路只允許特定連線方式，尤其可能限制 UDP。若網頁使用 TCP 正常，但依賴 UDP 的應用程式失敗，請先確認出口通訊協定、核心與遠端服務是否支援相應流量。TUN 可以接管應用程式的封包，但無法讓不支援 UDP 的出口自動具備這項能力。若涉及 IPv6，也要比對實際連線使用的位址類型，避免將單一路徑無法連線誤判為所有入口都失效。

若只有一個入口失敗，而其他入口在相同條件下可用，請保留故障時間、錯誤類型與網路比對結果，提供給服務提供者。若所有入口都失敗，但直連正常，請再檢查用戶端核心、DNS 與本機防火牆。停止高頻重複測試，恢復合理的檢查頻率；持續並行探測不僅會干擾記錄，也可能觸發遠端限制，讓問題更難判斷。

訂閱失敗：檢查連結、回應內容與設定合併

分辨下載失敗與解析失敗

訂閱更新至少會經過請求網址、取得內容、解析設定與套用設定等步驟。下載逾時通常發生在前兩步；解析失敗則可能表示內容已取得，但回傳格式不受用戶端支援。請先確認錯誤屬於網路請求、HTTP 狀態碼、YAML 語法，還是核心設定驗證，不要把所有錯誤都歸因於連結過期。更新前請匯出目前可用的設定，避免後續操作覆蓋最後一份有效版本。

請從服務提供者的帳戶頁面重新複製訂閱連結，並留意剪貼簿內容是否混入換行、前後空白或通訊軟體加上的標點。連結通常含有存取憑證，切勿貼到公開的轉換網站、線上 YAML 檢查工具或公開問題回報區。瀏覽器能開啟連結，只代表瀏覽器完成請求，不代表用戶端使用了相同代理、標頭與網路路徑，也無法證明回應內容是相容設定。

確認回應內容的實際類型

若用戶端可查看下載錯誤詳情，請先檢查狀態碼與回應類型。若回傳的是網頁、登入頁或存取驗證頁面，核心可能會把 HTML 第一行當成 YAML，接著顯示看似語法錯誤的訊息。狀態碼成功也不代表內容正確，伺服器可能以成功狀態回傳說明文字。請在本機檢查檔案開頭的少量內容，確認是設定結構、節點文字還是網頁內容；不要上傳含有憑證的完整檔案求助。

不同用戶端支援的訂閱格式不盡相同。為其他通訊協定或應用程式產生的內容，不能只改副檔名就當成 Clash 設定。請在服務提供者處選擇相容於 Clash 或 mihomo 的訂閱格式，再重新匯入。若設定引用代理提供者或規則提供者，主設定匯入成功後，還要確認這些外部資源能否下載；主檔案成功不代表相依資源都已就緒。

找出 YAML 與覆寫設定錯誤

本機編輯後若發生解析失敗，請先檢查縮排是否使用空格、同層級的鍵是否對齊，以及清單項目前是否保留連字號。包含特殊字元的字串需要正確加上引號，但不要不加判斷地替所有數字與布林值加引號。以下是用來比對語法的合法局部結構，並非可直接連線的完整設定；實際代理群組與出口仍由訂閱提供。

mixed-port: 7897
mode: rule
log-level: info
allow-lan: false

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

用戶端可能會合併訂閱原文、全域覆寫、指令碼處理與介面選項，再交由核心載入。原始檔語法正確，最終設定仍可能因引用不存在的代理群組而失敗。請暫時停用最近新增的覆寫或指令碼，再套用原始訂閱；若問題消失，請逐項重新啟用，找出衝突項目。請勿長期直接修改會自動更新的原始檔，否則下次更新可能覆蓋手動變更。

自動更新失敗時，也要確認應用程式是否在背景執行、裝置是否進入休眠，以及更新間隔的單位。不同用戶端可能以分鐘、小時或內部秒數儲存參數，不能照抄其他地方的數值。請勿以極短間隔反覆請求失效連結；先手動更新成功，再恢復自動排程。各用戶端的設定位置與失敗情況，請參閱訂閱自動更新間隔說明。

確認復原時，除了查看更新時間，也要確認目標設定已選取、核心已成功套用，而且引用的代理群組確實存在。若伺服器持續回傳錯誤內容，請向服務提供者提交已遮蔽敏感資訊的狀態碼、錯誤行號與請求時間。更多格式檢查方式請見訂閱解析失敗自我檢查步驟；訂閱基本概念可回到說明中心查閱。

網頁速度緩慢：分辨連線等待與持續傳輸

先確認速度慢在哪個階段

網頁空白很久後突然完整顯示，與檔案一開始下載很快、隨後速度下降，是兩種不同問題。前者較可能涉及網域解析、連線重試、交握或關鍵資源阻塞；後者較可能與出口容量、封包遺失、遠端限速或本機 Wi-Fi 品質有關。請先確認是所有網站、單一網站還是某類應用程式變慢，再以相同目標、檔案與網路進行比較，避免把不同伺服器的差異誤認為用戶端效能差異。

瀏覽器開發人員工具的網路時間軸，可用來分辨等待連線、等待第一個位元組與下載內容所花的時間。某個統計指令碼或字型資源一直等待，也可能拖延整個頁面的完成時間。用戶端記錄可補充出口與規則資訊，但無法取代瀏覽器對頁面相依項目的觀察。先找出真正耗時的請求，再確認它使用直連還是代理，通常比反覆切換整份設定更有效。

維持入口與目標不變進行比對

暫停系統更新、雲端硬碟同步與其他占用頻寬的工作，以單一下載項目測試。若無線網路不穩，請靠近無線基地台，或改用有線網路進行比對。不要同時執行多個測速工具，也不要根據單次測試結果替出口排序。測試網址的回應時間只代表該次測試路徑，不等於大型檔案的傳輸量，也不等於實際服務的使用體驗。

若要觀察明確指定代理的請求，可以用 curl 輸出各階段耗時。以下指令會保留一般頁面輸出，並在最後列出時間；實際測試時請替換成固定目標。透過 HTTP 代理存取 HTTPS 時，部分耗時包含代理協商，不能直接把單一欄位當成遠端伺服器的獨立耗時。請在相同條件下比較多次測試的變化，不要依單一數字下定論。

curl --noproxy "" --proxy http://127.0.0.1:7897 \
  --connect-timeout 10 --max-time 30 \
  --write-out '\nconnect=%{time_connect} tls=%{time_appconnect} first=%{time_starttransfer} total=%{time_total}\n' \
  https://example.com/

若直連請求也很慢，應先檢查本機網路與目標網站；若只有某個出口慢，可切換至相同設定下的其他可用出口比較。若某網站透過所有出口都很慢，但其他網站正常，可能與目標服務負載、地區路徑或應用程式本身的限制有關。此時通常沒有理由重裝用戶端。請記錄目標、時間與出口選擇，方便日後重測，而不只是記下「速度慢」。

檢查規則繞路與傳輸差異

規則若將原本可直連的資源送往遠端，可能增加連線距離；若將需要代理的 API 送去直連，則可能引發長時間重試。請檢查主頁與 API 網域是否被分配到不同出口，尤其是需要維持工作階段一致性的登入服務。調整時只修正明確有誤的網域規則，不要將大量未知位址加入全域繞過清單；修正後請重新建立連線，因為舊連線可能仍沿用原出口。

瀏覽器可能會優先嘗試使用 UDP 的 HTTP/3，再退回其他連線方式。若出口或網路不支援這條路徑，等待回退可能導致首次開啟時偶爾變慢。請先確認用戶端、出口通訊協定與網路能力，再進行有記錄的瀏覽器比對測試。停用某項通訊協定只能協助判斷原因，不應在未說明的情況下當成所有裝置的通用最佳化方案。

只有在 TUN 環境出現小網頁正常、大型請求卡住時，才進一步檢查路徑 MTU 或相關網路設備行為。請勿直接套用網路上的 MTU 數值，也不要同時修改 DNS、通訊協定堆疊與 MTU。先保留原值，並以系統代理進行比對；若只有 TUN 能重現問題，再依據記錄與網路環境逐項調整。代理轉送無法消除原網路的封包遺失，虛擬網卡也不會自動提升連線容量。

確認復原時，請使用實際服務進行驗收：開啟相同網頁、登入相同服務、下載相同資源。清除暫時測試條件並恢復日常規則，只保留確實改善問題且能說明作用的設定。若問題只在固定時段出現，記錄時段比不斷修改用戶端更有幫助；若只有特定應用程式異常，再檢查該應用程式的快取、擴充功能與獨立代理設定。

DNS 問題：釐清系統、應用程式與核心的解析路徑

先確認由哪一方解析網域

DNS 問題常見症狀包括網域無法開啟、首次存取等待很久，或同一網站在不同應用程式中結果不一。系統 DNS、瀏覽器安全 DNS、應用程式內建解析與 mihomo DNS 可能同時存在。請先記下失敗網域、錯誤類型與目前的接管方式。直接存取某個 IP 成功只能作為線索，不能取代以 HTTPS 網域測試，因為憑證、主機名稱與伺服器虛擬主機都可能依賴網域。

系統工具查詢成功，不代表用戶端的解析路徑也正常。明確指定 HTTP 代理通常可以將目標網域交由代理處理；SOCKS 請求是否在本機解析，則取決於呼叫方式。若瀏覽器啟用了獨立的安全 DNS，也可能繞過系統解析結果。排查時請選定一條路徑進行測試，並記錄所用工具，避免混淆不同解析來源的結果。

了解主要 DNS 參數的作用範圍

nameserver 用來指定一般上游 DNS；default-nameserver 可用於解析上游伺服器本身的網域，避免網域形式的上游缺少引導解析。proxy-server-nameserver 用來解析代理伺服器網域，與一般網站的解析問題不同。fallback 及其過濾條件會參與候選結果選擇，並不是所有請求逾時後才依序呼叫的備用清單。

以下片段展示 fake-ip 模式的最小觀察設定，不包含完整的 TUN 與分流設定。上游位址僅供說明參數，請依網路連線狀況選擇。監聽位址限制在本機，避免不必要地向區域網路提供 DNS 服務。若用戶端已透過介面或覆寫檔管理 DNS，請在同一處修改，避免多份設定互相覆蓋。

dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  default-nameserver:
    - 1.1.1.1
  nameserver:
    - https://dns.cloudflare.com/dns-query
  fake-ip-filter:
    - "*.lan"
    - "*.local"

fake-ip 回傳的是由核心維護對應關係的虛擬位址，不是網站伺服器的真實位址。看到測試網段位址本身，不代表解析已遭破壞；真正要確認的是後續連線是否仍進入維護該對應關係的核心。若應用程式取得虛擬位址後繞過 TUN 直連，或核心重新啟動後應用程式仍使用舊快取，就可能出現解析看似正常、連線卻失敗的情況。

依快取與接管順序逐步復原

先套用設定並確認核心已啟動，再清除系統與應用程式中和故障相關的快取，然後重新送出請求。Windows 可使用下列指令清除系統解析快取；瀏覽器本身的快取與連線池可能仍需重新啟動瀏覽器才能排除。其他系統請使用對應平台的方法，不要將 Windows 指令當成通用步驟。頻繁清除快取只能改變表面症狀，無法修復錯誤的上游 DNS 或接管路徑。

ipconfig /flushdns

TUN 的 DNS 劫持通常只針對指定的 DNS 流量，不代表所有應用程式內建的加密解析都會一併接管。核心在非標準連接埠監聽 DNS，也不會讓系統自動將查詢送到該連接埠；仍需要搭配系統設定或 TUN 轉送設定。若記錄中沒有 DNS 請求，請先確認請求是否進入核心，再考慮更換上游 DNS，以免修改未實際使用的設定。

區域網路裝置名稱、公司內部網域與多點傳送名稱都需要個別考量。公共 DNS 通常無法解析內部名稱，將所有查詢強制送往公共上游，可能導致印表機或內部服務無法使用。請依實際網域與網路需求設定解析策略或 fake-ip 過濾，保留原有的內部網路解析路徑。過濾某個網域只會改變該網域的處理方式，不保證系統能解析其名稱。

驗收時請分別測試一般網站、原本無法解析的網域，以及需要使用的內部服務，再確認代理伺服器網域也能穩定解析。若停用某項 DNS 設定後才恢復，請記錄該設定影響的解析路徑，再決定是否保留。參數組合與 DNS 劫持的進一步說明，請參閱mihomo DNS 設定詳解；不要只為了消除一則錯誤記錄就更換整段 DNS 設定。

系統代理失效：檢查連接埠、應用程式與接管方式

先確認本機監聽，再檢查系統入口

系統代理開關的作用是寫入系統代理設定，不代表所有程式都會遵循。請先用明確指定代理的請求，確認核心連接埠可用；再檢查系統中的代理主機是否為本機迴路位址，以及連接埠是否與用戶端一致。變更混合連接埠後，系統設定、瀏覽器擴充功能與終端機環境變數可能仍保留舊值。請一併檢查這些入口，不要只確認用戶端設定頁顯示了新數字。

發生連接埠衝突時，核心可能啟動失敗，也可能是其他處理程序占用了預期連接埠。在 Windows PowerShell 中可以查看監聽處理程序；在 macOS 或 Linux 上則可使用 lsof。範例連接埠仍需依實際情況調整。找到處理程序後，請先確認所屬應用程式，不要直接終止不明系統處理程序；關閉衝突應用程式或改用未占用的連接埠，再重新套用設定。

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

# macOS / Linux
lsof -nP -iTCP:7897 -sTCP:LISTEN

分辨瀏覽器、終端機與系統服務

瀏覽器代理擴充功能可能覆蓋系統設定，某些應用程式也有獨立的代理選單。終端機工具通常會讀取 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 與 NO_PROXY，但實際支援情況取決於工具本身。環境變數通常在處理程序啟動時繼承；修改後，已開啟的終端機或編輯器不一定會立即更新。不要因為瀏覽器正常，就推斷背景服務也使用相同代理。

Windows 的使用者代理設定與部分系統服務使用的 WinHTTP 設定並不相同。排查特定服務時，可以先用 netsh winhttp show proxy 查看其環境，但不應將匯入或重設 WinHTTP 當成一般瀏覽器的固定修復方式。macOS 請確認目前使用的網路服務，不要修改未連線的介面；Linux 桌面環境的代理是否生效，則取決於桌面環境與應用程式的實作。

TUN 模式需另外檢查權限與路由

不遵循系統代理的應用程式可考慮使用 TUN，但啟用前請確認用戶端的服務元件或權限需求已符合。TUN 開關顯示已開啟，不代表虛擬網卡與路由已成功建立。請查看記錄是否出現裝置建立失敗、權限不足或路由衝突。通訊協定堆疊選項會影響相容性，請依用戶端支援的選項逐一測試，不要同時修改通訊協定堆疊、DNS 與出口。

其他 VPN、虛擬機器網路、容器網路與安全軟體，可能會與 TUN 路由衝突。請先退出非必要的網路工具，再比較系統代理與 TUN 的行為。核心必須能連線至自己的遠端伺服器；路由設定錯誤可能會將該連線再次送回代理，形成迴圈。使用用戶端提供的自動路由與介面偵測功能時，也要確認辨識到的是目前有效的網路介面。

若要與區域網路共用代理，還需要啟用允許區域網路連線，並正確設定監聽位址與防火牆範圍。其他裝置上的 127.0.0.1 指向該裝置本身，不能用來存取這台電腦上的代理。請勿為了共用而直接關閉整套防火牆，也不要將本機代理連接埠開放至公網。僅允許可信任的區域網路存取，並留意網路共用設定變更後，原有存取規則是否仍合適。

關閉用戶端後無法恢復上網時，請先檢查系統代理是否殘留，指向已停止監聽的本機連接埠。手動關閉殘留設定，再確認其他應用程式是否也寫入了代理或自動設定指令碼。恢復連線後，重新啟動一個用戶端進行驗證，避免多個開機啟動項互相覆寫。系統代理與 TUN 的基本差異可在說明中心繼續查閱；初次啟用的日常步驟請參閱快速入門教學。

程式閃退：分辨介面、核心與設定問題

先判斷哪個部分停止運作

視窗關閉、系統匣仍在、核心停止與整個處理程序結束，是不同故障。請先查看系統匣圖示與系統處理程序清單，再確認記錄是否繼續寫入。按下關閉按鈕後視窗縮至系統匣，通常是設定行為，不是程式閃退。若介面仍可操作，但核心反覆重新啟動，應優先檢查套用設定時的錯誤、資源路徑與權限，而不是將所有現象都歸因於圖形介面。

請記下閃退前最後執行的動作：匯入訂閱、更新應用程式、切換 TUN、結束休眠或登入系統。保留應用程式記錄末尾與系統錯誤記錄的對應時間，不必提交整個設定資料夾。記錄中可能包含伺服器位址、存取網域與設定路徑，請先遮蔽敏感資訊。若問題可以穩定重現，清楚列出重現步驟比提供大量重複截圖更有幫助。

備份後以最精簡設定啟動

退出用戶端並確認相關處理程序已結束，再將設定資料夾複製到其他位置。備份應包含訂閱、覆寫檔與必要的使用者設定，但不要上傳至公開雲端硬碟。接著使用用戶端支援的獨立設定資料夾或重設方式，啟動測試環境；若不清楚資料資料夾的位置，請先查看設定中的「開啟設定資料夾」選項。不要直接刪除使用者資料夾中不明用途的檔案來嘗試修復。

若最精簡的環境可以啟動，請先匯入一份確認有效的設定，再逐項還原覆寫、指令碼與介面設定。只要還原某項後問題再次出現，就已掌握明確範圍。設定錯誤應依錯誤行號與最終合併結果修正；若是介面資料庫或視窗狀態問題，則不必修改代理通訊協定。若安裝套件包含獨立核心，請避免手動替換來源與相容性不明的檔案。

若要在本機驗證 mihomo 設定語法，可以使用核心提供的測試參數。以下指令假設目前資料夾中有可執行檔與測試設定。測試會確認核心能否接受設定，但不保證伺服器可連線、規則符合預期，或訂閱資源能持續下載。指令輸出也可能包含敏感路徑，轉傳前請先檢查內容。

# macOS / Linux
./mihomo -t -f ./config.yaml

# Windows PowerShell
.\mihomo.exe -t -f .\config.yaml

檢查架構、執行環境與權限

重新下載前，請先確認作業系統與處理器架構，尤其是 Intel 與 Apple Silicon，以及 Android 裝置的安裝套件架構。安裝成功不代表所有相依項目都已具備；圖形執行環境、系統元件與安裝位置權限也可能影響啟動。請依應用程式指出的缺少元件或系統錯誤處理，不要大量安裝來源不明的修復工具。

Windows 可搭配事件檢視器找出故障模組；macOS 可查看系統當機報告與應用程式啟動記錄；Linux 可查看使用者工作階段記錄，以及從終端機啟動時的輸出。透過終端機啟動可顯示圖形相依項目的錯誤，但不應長期以系統管理員權限執行整個桌面程式來掩蓋問題。服務元件需要權限時，請使用用戶端提供的安裝與管理流程。

若安全軟體隔離了某個元件，請先核對隔離記錄、安裝來源與觸發原因，不要一律關閉防護。安裝資料夾無法寫入或遭同步軟體占用，也可能導致更新後檔案不完整。請先完全退出應用程式，再前往下載中心選擇符合系統的安裝套件重新安裝；請保留資料備份，避免解除安裝時一併刪除仍需排查的設定與記錄。

Clash for Windows 與 ClashX Meta 已停止維護。若在新系統上遇到相容性問題，建議改用仍適用於目前環境的用戶端，優先考慮 Clash Plus；Linux 使用者可參考 Clash Verge Rev 與 FlClash。遷移時請先匯入設定並完成基本連線測試，再逐項還原自訂功能。不要直接複製不同用戶端的整個介面設定資料夾；設定語法相容，不代表內部資料格式也相同。

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

Android：先檢查 VPN 權限與應用程式範圍

Android 用戶端通常透過系統 VPN 介面接管流量。首次連線需要系統授權；若授權遭取消或受裝置政策限制，應用程式介面看似正常，實際上卻不會建立有效接管。請先查看系統 VPN 狀態與用戶端記錄，再檢查是否有其他 VPN、工作設定檔網路或應用程式占用相同範圍。不要只憑通知列圖示判斷出口與 DNS 是否正常。

Clash Plus、Clash Meta for Android、FlClash 與 Surfboard 的設定格式和選項位置各不相同。匯入時應選擇相應格式，不要假設所有 Android 用戶端都接受相同設定。啟用依應用程式分流後，請確認發生問題的應用程式位於預期範圍內。有些介面使用包含清單，有些則使用排除清單；若看反選項，可能導致瀏覽器正常，但特定應用程式始終直連。

系統的「永遠開啟 VPN」與「封鎖未經 VPN 的連線」是兩個獨立選項。啟用封鎖功能後，隧道中斷時網路被封鎖，可能是系統依政策運作，並非 Wi-Fi 故障。排查時請先記下原有設定，再了解影響後進行比對。受機構管理的裝置應遵循管理規範，不要修改工作設定檔的安全政策。

分別處理背景中斷與安裝失敗

若鎖定螢幕後連線失效、返回用戶端後立即恢復，請優先檢查電池最佳化、背景活動限制與廠商的自動啟動管理。允許必要的背景執行後，再完整測試一次鎖定螢幕與喚醒流程。關閉所有省電設定無法準確找出問題，也可能縮短電池續航力。若背景處理程序仍在，但從 Wi-Fi 切換到行動網路後失敗，應優先檢查網路重新連線與 DNS，而不是繼續增加背景權限。

若安裝時提示不相容，請檢查系統需求與處理器架構；覆蓋安裝失敗也可能與簽章不同或安裝來源有關。解除安裝前請先匯出設定，因為應用程式資料可能會一併刪除。不要為了繞過安裝錯誤而隨意降級或替換不明安裝套件。Android 使用者可在Android 下載專區比對用戶端與架構；首次匯入步驟仍請依教學操作。

iOS：檢查隧道設定與資源限制

iOS 使用者可從iOS 下載專區前往 Clash Plus 的 App Store 頁面；用戶端官方網站為 clashplus.io。遇到連線問題時，請先檢查系統中的 VPN 設定是否對應目前使用的用戶端，再確認應用程式已獲准建立隧道。舊設定殘留、其他網路工具或裝置管理政策都可能影響連線，請依系統顯示的具體狀態判斷。

iOS 的網路延伸功能與前景介面是不同的執行元件；介面能開啟不代表隧道持續正常。設定過大、規則資源過多或更新太頻繁，都可能增加延伸功能的負擔。請先使用較小且確認可用的設定重測，再逐步還原外部資源。不要將背景限制問題簡單歸咎於訂閱損壞，也不要在缺少記錄時不斷重新安裝應用程式。

分開測試 Wi-Fi、行動網路與入口網站驗證

公共 Wi-Fi 可能要求先透過瀏覽器完成驗證。若驗證前就啟用代理，登入頁面可能無法顯示；請先依網路要求完成驗證，再啟用用戶端。Wi-Fi 與行動網路的 IPv6、DNS 和存取路徑可能不同，切換網路後應重新建立測試請求。相同設定在家中可用，不代表辦公室網路或手機熱點也沒有路徑限制。

手機熱點不一定會將手機本身 VPN 的流量接管能力分享給連線裝置，實際情況取決於系統實作。電腦連上手機熱點後，仍應個別確認電腦端的系統代理或 TUN 設定。行動裝置恢復正常後，請分別測試鎖定螢幕、喚醒、切換網路與故障應用程式；若仍失敗，請整理系統類型、用戶端名稱、網路條件與已遮蔽敏感資訊的記錄，再回到本手冊相關章節繼續縮小問題範圍。