Clash 常見問題

Clash 最初指的是代理核心及其設定生態系；Clash Meta 是衍生核心專案的舊稱，後續以 mihomo 名稱維護。圖形化用戶端負責匯入訂閱、選擇策略群組、設定系統代理及顯示記錄；核心則負責解析設定、比對規則與建立連線。用戶端名稱相近，不代表核心及支援的通訊協定完全相同。排查前，先在「關於」頁面記下用戶端名稱、版本與核心版本，再依相應專案的設定項目操作，不要直接套用其他用戶端的畫面指引。

用戶端提供操作介面與網路處理功能，設定檔則定義代理伺服器、策略群組、規則與 DNS 設定。只安裝用戶端並不會自動取得可連線的代理伺服器。已有設定檔時，可在設定頁選擇透過 URL 或本機檔案匯入；啟用後，確認策略群組中是否出現可用選項。訂閱通常包含存取憑證，請只從可信任來源取得，也不要將完整連結貼到公開論壇、線上轉換頁面或問題截圖中。

日常使用建議選擇規則模式，由 rules 從上到下決定連線使用 DIRECT、代理策略群組或 REJECT。全域模式會將已進入核心的連線交由全域策略處理，適合短時間比較規則是否影響結果；直連模式則讓已接管的連線直接連至目標。模式選擇不等於流量接管開關；如果應用程式沒有使用系統代理、明確指定的代理或 TUN，切換至全域模式也不會自動接管該應用程式。測試後請切回規則模式，並重新建立待測連線。

系統代理會將代理位址寫入作業系統設定，主要供遵循該設定的應用程式使用；TUN 則透過虛擬網路介面與路由，接管符合條件的流量，適用於忽略系統代理的程式。兩者不必同時啟用才能生效。建議先用系統代理測試瀏覽器，再依應用程式需求啟用 TUN，避免一次變更多個設定。TUN 的實際接管範圍也會受到路由、排除項目與 DNS 設定影響，不能只看開關已啟用，就認定所有流量都已接管。

通常可以共用代理伺服器、策略群組與常見規則，但前提是目標用戶端的核心支援相同語法與通訊協定。網卡名稱、檔案路徑、指令碼、外部控制介面及 TUN 相關設定，往往需要依作業系統調整。遷移時，先匯入原始設定檔並查看解析結果，再個別啟用流量接管功能；不要直接複製舊裝置的執行目錄，覆蓋新安裝的檔案。訂閱更新也可能覆蓋本機修改，長期調整建議使用用戶端支援的覆寫或合併設定。

先在設定頁查看完整錯誤訊息。發生逾時時，通常要檢查網路是否可連線，以及更新是否依賴目前的代理；HTTP 401 或 403 則應確認訂閱授權及連結是否失效。遇到憑證錯誤，先校準系統時間，再檢查憑證鏈與網路環境，不要直接停用憑證驗證。若是解析錯誤，請確認回傳內容是 Clash YAML，而不是網頁、登入提示或其他格式的節點清單。重新複製連結時，移除前後空白並保留完整參數，也請避免在公開記錄中洩露連結。

先使用用戶端提供的設定檢查功能，依錯誤行數找出縮排、欄位或參照問題。YAML 階層請使用空格，避免使用定位字元；策略群組參照的節點名稱，以及規則指定的策略群組名稱，都必須與定義完全一致，包括大小寫。遇到不支援的代理類型或欄位時，請確認核心相容性，不要一再重新安裝。修改前保留原始檔案，每次只調整一項並重新檢查。成功匯入只代表檔案已讀取，仍須啟用設定檔並確認核心已成功啟動。

先確認核心正在執行，再到系統代理設定檢查監聽位址與連接埠是否和用戶端一致。7890 是常見的混合連接埠範例，不代表每款用戶端目前都使用這個連接埠。檢查瀏覽器代理擴充功能、手動代理設定與系統略過清單，避免其他設定覆蓋用戶端設定。接著開啟連線頁面，用新分頁造訪目標網站，查看是否出現相應連線及命中規則。若完全沒有記錄，優先檢查流量接管路徑；若記錄顯示 DIRECT，就繼續檢查規則與策略，而不只是更換節點。

在 Windows 上，先關閉 TUN，確認用戶端是否提供服務模式的安裝或修復選項，依提示授權後重新啟動用戶端；部分用戶端也可透過以系統管理員身分執行來完成相關操作。macOS 與 Linux 請依專案文件授權網路擴充功能、輔助服務或所需權限，不要照搬 Windows 的步驟。若服務啟動失敗，先查看記錄中的具體錯誤，再檢查安全軟體封鎖、虛擬網卡及其他 VPN 衝突。解決權限問題後再啟用 TUN，不要反覆安裝。

先確認目前啟用的是剛匯入的設定檔，而不是另一份同名設定檔。如果使用 proxy-providers，請檢查提供者資源是否下載成功，以及策略群組的 use、filter 或 exclude-filter 是否排除了所有項目。設定檔中有代理定義，不代表每個策略群組都會自動顯示這些代理。訂閱回傳內容不完整、方案到期或核心不支援該通訊協定，也可能造成項目缺漏。請保留原始設定檔並查看更新錯誤；暫時停用自訂覆寫，有助於分辨是訂閱問題還是本機合併設定造成的問題。

在設定頁開啟對應訂閱的編輯或更新設定，尋找自動更新間隔及更新代理選項；各用戶端的欄位名稱與時間單位可能不同，請以介面說明為準。更新間隔應依服務提供者的要求設定，避免過於頻繁而觸發請求限制。若直連更新失敗，但現有代理仍可使用，可以試著透過代理更新；若必須先更新訂閱才能連線，選擇依賴已失效代理的更新方式就會陷入循環。手動更新成功後，再確認自動更新記錄是否如預期執行。

規則會依序比對，通常命中後就不再檢查後續規則。請將較具體的網域規則放在較廣泛的規則之前，並將 MATCH 後備規則留在最後。例如 DOMAIN-SUFFIX,github.com,Proxy 必須搭配設定檔中確實存在的 Proxy 策略群組。建議使用用戶端的規則覆寫功能新增或前置規則，避免訂閱更新覆蓋修改內容。儲存後重新載入設定檔，再用新連線查看實際命中的規則；既有的長連線通常不會因規則修改而立即改用新的出口。

開啟連線頁面，依目標網域、處理程序名稱或目標位址篩選，再檢查命中規則、策略鏈及最終選用的代理。策略群組名稱只是選擇入口，不一定就是最後的出口；若有巢狀策略群組，請沿著策略鏈繼續查看。測試前先關閉目標應用程式的舊連線，再發出新請求，減少連線重複使用造成的干擾。只查看瀏覽器顯示的出口位址，只能確認該次請求的結果，無法證明其他應用程式、UDP 或所有網域都採用相同路徑。

先在用戶端啟用允許區域網路存取，並確認監聽位址不再限定為本機回送位址；接著在其他裝置上填入執行用戶端的電腦區域網路位址與實際連接埠。allow-lan: false 代表不允許區域網路存取，實際預設值請以目前設定檔為準。設定防火牆放行時，只對可信任的私人網路與必要位址開放，並依核心支援情況設定驗證；不要將代理連接埠轉送至公用網際網路。測試完成後，關閉不再需要的共用功能，並確認沒有連帶公開外部控制介面。

保留用戶端與核心版本、作業系統版本、發生時間、操作順序及完整錯誤類型。記錄層級通常先使用 info，只有在重現問題時才短暫提高；完成後請恢復原設定，避免持續產生大量記錄。分享前遮蔽訂閱 URL、驗證參數、密碼、控制介面金鑰，以及不希望公開的存取網域與位址。不要直接上傳整個設定目錄；建議只提供與故障相關的少量記錄及已去識別化的設定片段，並註明系統代理與 TUN 的啟用狀態。

節點測試只是核心向指定測試位址發出的一次請求；逾時可能是測試位址無法連線、解析失敗或伺服器連線失敗，不能據此認定所有連線都已失效。先確認可開啟的網頁是否命中代理，而不是走 DIRECT 或使用快取；再用同一節點連線至不同目標，並查看錯誤發生在解析、交握或傳輸階段。如果所有目標都失敗，再檢查伺服器狀態、訂閱有效期限及本機網路。可依用戶端文件調整測試位址，不要只憑一次測試結果就刪除設定。

先關閉 TUN，確認基本網路恢復，再只保留一個流量接管工具進行測試。其他 VPN、虛擬機網卡與安全軟體可能同時修改預設路由或 DNS，造成流量繞道、回送或解析失敗。檢查記錄中的網卡建立、路由新增及 DNS 監聽錯誤，再依序確認服務權限、連接埠占用與自動路由設定。不要直接刪除所有系統路由。若需要同時使用企業 VPN，請依其網路需求設定排除網段，不要假設兩套自動路由可以直接相容。

先釐清預期行為：哪些網域應由哪條解析路徑處理，以及解析連線應直連還是經過代理。DNS 檢測頁面顯示的是解析器的出口，不能只因地區不同就認定發生洩漏。瀏覽器安全 DNS、系統加密 DNS、IPv6 與 TUN 的 DNS 劫持設定，都可能讓解析繞過用戶端。測試時逐項記錄這些設定，清除相關快取後重新查詢，並搭配用戶端記錄確認請求路徑。不要同時隨意修改 fake-ip、nameserver 與系統 DNS，否則很難找出真正造成變化的設定。

部分受應用程式容器限制的 Windows 應用程式無法直接連線至本機回送代理，即使瀏覽器正常，也可能連線失敗。先確認問題應用程式確實使用系統代理，再檢查用戶端是否提供 UWP 回送豁免選項。需要手動處理時，以系統管理員身分開啟終端機，使用 CheckNetIsolation LoopbackExempt -s 查看現有豁免，再依應用程式實際的套件家族名稱設定，不要照抄其他應用程式的名稱。只授權可信任且確有需要的應用程式，並遵守裝置管理政策；回送豁免無法修復節點或規則錯誤。

退出後無法連線時，先確認系統代理是否仍指向已停止監聽的本機連接埠；關閉殘留的手動代理設定後再試一次。若曾啟用 TUN，也要確認輔助服務或虛擬介面是否仍在執行。遇到連接埠占用，先檢查是否同時啟動了兩個用戶端，並正常關閉重複執行的實例；不要直接結束不明的系統處理程序。確實需要更換 mixed-port 時，請同步更新系統代理及手動填入該連接埠的應用程式。恢復後請使用用戶端的正常結束流程，避免反覆強制結束處理程序而留下設定。