Clash 常見問題與故障排除

Clash 是代理核心及相關設定生態系的常見稱呼；mihomo 是這個生態系中持續發展的核心，早期也常稱為 Clash Meta；Clash Verge Rev 則是提供設定管理、代理切換與系統設定入口的桌面用戶端。用戶端介面與實際使用的核心屬於不同層次，YAML 欄位是否可用，取決於用戶端搭載的核心及其版本。排查時，先在關於頁面記下用戶端名稱，再從核心資訊或啟動記錄確認核心，避免直接套用其他用戶端的選單位置。

用戶端負責讀取設定並轉送流量，安裝完成不代表就能自動使用代理服務。訂閱連結通常由服務提供者提供，用來取得節點、策略群組與規則等設定內容。前往服務提供者的訂閱頁面，選擇相容於 Clash 或 mihomo 的設定連結，再到用戶端設定頁新增遠端設定。請勿將帳戶登入頁面的網址當成訂閱連結，也不要把訂閱連結貼到公開討論區；連結中的存取憑證可能讓他人讀取設定。若只有本機設定檔，也可以匯入檔案。

平常建議使用規則模式，由已載入設定中的規則決定流量走向。全域模式通常會將已進入核心的連線交由全域策略處理，但不代表所有應用程式都已被接管；仍須確認系統代理或 TUN 是否生效。直連模式會讓核心收到的流量直接連往目標，適合暫時比較連線狀況。測試時一次只切換模式，不要同時修改 DNS 或節點。若只有特定網站在全域模式下能開啟，應優先檢查規則比對與策略群組選擇，而非長期以全域模式掩蓋設定問題。

系統代理會將代理位址寫入作業系統設定，主要影響遵循這項設定的應用程式；TUN 則透過虛擬網路介面與路由接管符合條件的流量，通常需要額外權限。為了連線成功，不必兩者都啟用。先只用系統代理測試瀏覽器，再依遊戲、命令列或其他應用程式的需求測試 TUN。部分用戶端支援兩者並用，但接管範圍仍會受到路由與排除設定影響。啟用 TUN 後若出現異常，先關閉 TUN 比較，確認問題出在路由接管還是代理服務本身。

先回到設定頁，確認剛匯入的設定已設為目前使用的設定，而不只是留在清單中。接著查看更新記錄與核心記錄，確認下載是否成功、YAML 是否正常解析。有些設定會使用 proxy-providers 個別擷取節點，主設定載入成功不代表節點提供者也已更新，還需要到提供者頁面再次確認。若服務提供者回傳的是登入頁面、錯誤訊息或用戶端不支援的訂閱格式，請重新取得相容的連結。不要反覆新增同名設定來解決問題，先保留一份方便比對即可。

先到服務提供者的帳戶頁面確認訂閱是否到期、流量是否用完，以及連結是否已重設。401 通常與身分驗證有關，403 則表示存取遭拒，但實際原因仍應以服務提供者的說明為準。重新複製完整訂閱網址，移除不小心帶入的空格與換行，再於原設定中替換連結並手動更新。若連結在其他網路可用，請檢查目前網路是否攔截了請求。回報問題時只提供錯誤碼與已遮蔽敏感資訊的記錄，不要附上完整訂閱網址；一直按更新通常無法解除伺服器端的存取限制。

先確認一般系統代理能正常連線，再處理 TUN 權限問題。桌面用戶端通常需要安裝或啟動服務模式；Windows 可在用戶端設定中確認服務狀態並依提示授權，macOS 則需要完成相應的系統授權。Linux 請依照用戶端文件設定服務或所需權限，不要任意開放整個目錄的寫入權限。完成授權後重新啟動用戶端，查看記錄中是否仍有建立裝置、設定路由或存取介面失敗的訊息。若使用的是受管理的工作裝置，請洽管理員確認權限政策，不要反覆嘗試繞過系統限制。

部分採用 AppContainer 隔離的 Windows 應用程式，預設無法存取本機回送位址。因此，若瀏覽器能用但市集應用程式無法連線，可檢查回送限制。若用戶端內附 UWP 回送工具，請以管理員權限開啟，只勾選確實需要存取本機代理的應用程式；儲存後完全關閉，再重新啟動該應用程式。不同用戶端的選項名稱可能不同；若沒有附工具，請參閱 Windows 的回送豁免說明。只授權有需要的應用程式，不要直接全選；回送豁免也無法解決訂閱失效、遠端節點故障或應用程式本身的網路限制。

先依照服務提供者建議的更新間隔設定；若沒有特別要求，可以從每天更新一次開始，避免過於頻繁地請求訂閱。遠端設定更新後，直接修改遠端 YAML 的內容可能會被取代，因此自訂規則、DNS 或策略調整，建議優先放在用戶端支援的覆寫或合併設定中。設定完成後手動更新一次，再查看最後生效的設定，確認修改仍然保留。不同用戶端的合併順序與陣列處理方式不盡相同；更換用戶端時請重新檢查，不要只複製覆寫檔就認定結果相同。

為每份設定取容易辨識的名稱，例如依用途或服務來源命名，不要全部沿用預設名稱。需要切換時，在設定頁將目標設定設為目前使用的設定，再到代理頁確認策略群組與可選節點也已更新。切換後，舊連線可能暫時沿用原本的連線路徑；測試前可先關閉目標應用程式再重新開啟，或使用用戶端的連線管理功能結束相關連線。確認新設定可用後再刪除舊設定；刪除前請備份必要的本機規則，並留意遠端訂閱與本機覆寫是否分開儲存。

在用戶端開啟連線頁面，再重新瀏覽目標網站，依網域或目標位址尋找新建立的連線，查看符合的規則、策略群組及最後的出站方式。既有連線可能不會重新比對，因此測試前應關閉舊頁面或結束對應連線。若介面只顯示 IP，請搭配記錄確認是否已進行 DNS 解析，以及規則是否依賴網域資訊。若流量符合兜底規則，請檢查目標規則是否排在兜底規則之前，以及規則集是否載入成功。不要只因代理頁選了某個節點，就認定所有網站都使用該節點。

請提供作業系統、用戶端名稱、用戶端與核心版本，以及問題發生時使用的模式、系統代理和 TUN 狀態。描述一個可重複操作的步驟，例如開啟哪類應用程式後出現什麼錯誤，並說明相同網路下其他應用程式是否正常。記錄只需截取一次操作失敗前後的內容，保留錯誤碼與必要的上下文。公開前請遮蔽完整訂閱連結、存取憑證、節點密碼、個人帳戶與不必要的公網位址。不要公開上傳整份設定檔；先擷取相關欄位並替換敏感值，方便他人判斷，也能減少資訊外洩。

先關閉代理，確認基本網路可以連線；再檢查裝置日期與時間是否正確，接著確認訂閱狀態及設定更新結果。選一個已知可用的節點單獨測試，並觀察記錄是網域解析失敗、連線遭拒還是交握失敗。測試位址無法連線也會造成測速逾時，因此應搭配實際連線結果判斷。若所有節點同時失敗，優先檢查 DNS、網路限制與本機設定；若只有單一節點失敗，請改用其他節點並聯絡服務提供者。每次只調整一項設定並記錄變更，避免同時切換連接埠、DNS 與路由而無法判斷原因。

先確認用戶端核心正在執行，再核對系統代理中的主機與連接埠是否符合用戶端目前的監聽位址和混合連接埠，不能只看到開關已啟用就認定設定正確。關閉其他代理用戶端，以及可能接管代理設定的瀏覽器擴充功能，再重新啟動瀏覽器測試。Firefox 等應用程式可能使用自己的網路設定，需選擇系統代理或填入正確的本機代理位址。若連線頁面始終沒有新記錄，問題多半出在應用程式與用戶端之間；若已有連線記錄，則繼續檢查規則比對、策略選擇與節點狀態。

先關閉 TUN 進行比對，確認基本網路與系統代理是否正常，再查看記錄中的 DNS 逾時、解析失敗或路由錯誤。檢查設定中的 DNS 服務是否已啟用、上游位址能否依預期路徑連線，以及 TUN 的 DNS 劫持設定是否與目前核心相容。fake-ip 回傳合成位址是正常機制，不代表設定已損壞。修改解析模式或過濾規則後，清除用戶端與系統的 DNS 快取，再重新建立連線。若只有少數應用程式受影響，可先針對相關網域設定 fake-ip 過濾，不要直接複製來源不明的整套 DNS 設定。

連接埠遭占用時，先關閉其他代理用戶端，確認背景是否仍有舊的核心程序執行；使用系統的網路連線或程序工具找出占用者，不要直接結束不熟悉的系統程序。若需變更混合連接埠，也要同步更新手動填入該連接埠的應用程式設定。關閉用戶端後無法上網，先到系統網路設定確認是否還留有指向本機的手動代理，關閉後再測試。若仍有異常，檢查 TUN 服務與路由是否已恢復，必要時依正常流程重新啟動裝置。下次關閉用戶端前先停用流量接管，可減少強制結束程序後留下的網路設定。