Clash 常見問題
訂閱、設定與連線疑難排解

Clash 用戶端是這類圖形化工具的統稱，mihomo 則是負責代理協定、規則比對與 DNS 處理的核心。Clash Verge Rev、FlClash 等產品提供匯入設定與整合系統的介面；Clash for Windows 則是已停止維護的特定產品。選擇時應同時確認用戶端的維護狀態與核心相容性，不能只憑名稱相近就認定功能相同。遷移前請匯出設定，並記下本機覆寫內容與系統代理連接埠。

安裝用戶端不會自動取得可用的代理服務。訂閱通常由既有服務的管理頁面提供，也可以使用自行架設服務所對應的設定。匯入前請確認格式支援 Clash YAML，或符合所用用戶端的匯入方式；不要把帳戶登入頁面當成訂閱網址。訂閱連結可能含有存取憑證，請勿公開貼到論壇、截圖或不明的轉換網站；若連結外洩，應向服務提供者重新產生。

日常使用建議選擇規則模式，由 rules 依序比對目標並交由相應策略處理。全域模式會將進入核心的連線交給全域策略，但不會自動接管所有應用程式；應用程式是否進入核心，仍取決於系統代理或 TUN。直連模式則讓進入核心的連線直接連線。排查問題時，可暫時切換至全域模式並選擇已確認可用的代理；驗證完成後請切回規則模式，避免長期保留臨時設定。

不必預設同時啟用。系統代理會修改作業系統的代理設定，適合遵循該設定的瀏覽器與應用程式；TUN 透過虛擬網路介面與路由接管流量，適合不遵循系統代理的程式，但需要額外權限。首次連線時，先用系統代理確認訂閱與策略群組正常，再依應用程式需求啟用 TUN。若兩者並用時發生異常，先停用其中一種接管方式，並暫停其他 VPN，以縮小排查範圍。

訂閱連結是取得遠端內容的入口，設定檔是核心實際讀取的 YAML，策略群組則將多個代理或處理方式整理成可選目標。完整設定通常還包含 DNS、規則與監聽連接埠，不只有節點清單。策略群組名稱必須與規則中的引用一致，例如規則末尾使用 PROXY 時，設定中就必須有同名代理或策略群組。若只取得單一協定連結，應依用戶端支援的方式匯入，而不是直接當成完整 YAML 使用。

先確認複製的是完整訂閱連結，再前往服務提供者的帳戶頁面查看服務狀態，以及連結是否已重新產生。401 或 403 通常與授權或存取限制有關；404 可能表示網址已變更，實際原因仍以服務提供者的說明為準。請勿連續重複匯入；先從用戶端日誌確認回應狀態，再檢查訂閱更新是否錯誤地依賴尚未可用的代理。需要回報時，只提供已遮蔽敏感資訊的狀態碼與時間，切勿公開完整連結。

先確認下載的內容確實是 YAML：登入頁面、網頁錯誤訊息與 Base64 節點清單都不能直接當成完整設定。若日誌出現 yaml: unmarshal errors，請根據後續行號檢查欄位型別、縮排與清單結構；YAML 縮排應使用空格，不要使用定位字元。先還原未修改的訂閱設定，確認能否載入，再逐項恢復覆寫。分享錯誤片段前，請移除伺服器憑證與訂閱網址。

先依照目前使用的用戶端說明安裝或啟用服務模式，再確認服務正在執行；不同產品的選項可能稱為服務模式、Service Mode 或輔助服務。Windows 通常需要提升權限才能安裝服務；macOS 可能需要授權輔助程式；Linux 則應依發行版與用戶端說明設定權限。不要直接放寬所有可執行檔的權限。安裝後仍無法使用時，查看建立虛擬網卡或新增路由時的錯誤訊息，再檢查安全軟體與其他 VPN 是否衝突。

先確認系統代理位址是否指向 127.0.0.1，以及連接埠是否與目前設定的 mixed-port 或 HTTP 監聽連接埠一致。接著檢查瀏覽器是否使用獨立的代理設定、代理擴充功能或組織政策；這些設定可能會覆蓋系統代理。開啟用戶端的連線頁面後，瀏覽新的網頁並確認是否出現對應連線。若沒有連線記錄，優先檢查流量接管路徑；若有記錄卻仍直接連線，則檢查比對規則與策略群組，不要只是不斷切換系統代理開關。

電腦端必須啟用允許區域網路連線的設定，也就是 allow-lan，並確認 bind-address 不只綁定迴圈位址。手機與電腦應連上同一個可信任網路，再到手機 Wi-Fi 的手動代理設定中，填入電腦的區域網路 IP，以及 HTTP 或 mixed-port 連接埠。防火牆只需允許必要的私人網路連線；條件許可時，請設定驗證機制。手機的 Wi-Fi 代理不一定能接管所有應用程式；使用完畢後請還原設定，也不要將監聽連接埠轉送至公網。

測速結果只表示當時能連上所設定的測試網址，不代表所有目標網站、協定與應用程式都能正常使用。先確認實際命中的策略群組確實選用了該節點，再到連線頁檢查目標網域、比對規則與連線錯誤。若瀏覽器可用，但遊戲或通話失敗，還要確認是否支援 UDP，以及流量接管方式是否正確。不要只憑測速結果排除節點問題；使用相同目標與策略逐項比較，才能判斷差異來自規則、協定或遠端服務。

直接修改訂閱產生的設定，可能會在下次更新時被遠端內容覆蓋。需要長期保留的規則，應放在用戶端支援的覆寫、擴充設定或指令碼中；具體位置請參考產品文件。還原前先備份目前的檔案，再確認最終生效設定中的 rules 順序：具體規則應放在 MATCH 之前。覆寫中的策略群組名稱也必須與訂閱中的實際名稱一致，否則載入時可能發生找不到策略的錯誤。

在用戶端設定中啟用開機自動啟動後，也要確認系統的啟動項目權限沒有阻擋程式。開機自動啟動、啟動後設定系統代理，以及服務隨系統啟動是不同選項，應分別確認。首次測試建議重新開機後，先檢查設定是否成功載入，再確認服務與網路是否就緒；若訂閱更新因啟動過早而失敗，可在連上網路後手動更新。解除安裝或更換用戶端前，請先關閉系統代理，避免系統保留已無程式監聽的連接埠。

使用規則模式，並在本機覆寫中新增精確網域規則或 DOMAIN-SUFFIX 規則，將目標指定為 DIRECT。規則依序比對，因此應放在範圍較廣的規則與 MATCH 之前。修改後，確認最終設定中包含該規則，再透過新連線驗證是否命中；既有的長連線可能仍沿用舊策略。不要只為了一個網站就長期將整個用戶端切換為直連模式，也不要使用過於寬泛的網域後綴，應只涵蓋實際需要比對的範圍。

先確認 external-controller 已啟用，並確認面板填寫的位址、連接埠與 secret 和核心設定一致。若只在本機使用，控制介面綁定 127.0.0.1 即可；不要為了方便連線而直接公開至公網。若面板透過 HTTPS 開啟，但控制介面使用 HTTP，瀏覽器可能因混合內容政策而封鎖請求，請依面板部署說明調整。分享截圖前請遮蔽控制金鑰；若需遠端存取，應另外設定可信任網路與存取防護。

先關閉代理，確認基礎網路正常，再確認訂閱有效且節點設定已成功載入。接著選擇一個節點，以實際目標建立連線並查看日誌；timeout 表示請求未能在限定時間內完成，但不能只憑這個字就判定伺服器故障。請檢查系統時間、伺服器網域解析、防火牆，以及其他 VPN 是否造成干擾。若多個節點都失敗，優先檢查本機共用環節；若只有個別節點失敗，再向服務提供者回報，並附上已遮蔽敏感資訊的錯誤訊息與發生時間。

部分 Windows 應用程式容器受到迴圈存取限制，無法直接連線至本機代理連接埠。若用戶端提供 UWP 迴圈工具，可視需要為相關應用程式啟用迴圈豁免，完成後重新啟動該應用程式；不要一次替所有應用程式開放。也可以在支援的環境中測試 TUN 接管，但仍須檢查應用程式本身與系統的代理設定。迴圈豁免並非所有商店問題的通用解法；帳戶、系統服務與 DNS 錯誤也應搭配日誌分別排查。

先記下失敗的網域與完整錯誤訊息，再檢查設定中的 DNS 上游是否可連線，以及上游網域解析是否形成循環依賴。DNS 逾時不代表 Fake-IP 本身有問題。只有確認某個應用程式不相容虛擬位址時，才視需要加入 fake-ip-filter，或切換至 redir-host 模式進行比對測試。修改後請清除相關 DNS 快取，並重新建立連線。不要一次更換所有 DNS 設定，否則即使恢復連線，也難以判斷是哪項調整有效。

如果舊資料庫仍存在且核心可以讀取，更新失敗不一定會立即影響現有的 GEOIP 比對；若資料庫遺失或損毀，引用它的規則可能無法載入或比對。先查看日誌中的資料庫路徑與下載錯誤，確認寫入權限、磁碟空間及下載連線都正常，再透過用戶端提供的資料庫更新入口重試。Country.mmdb 是常見的 GeoIP 資料檔案，但實際格式取決於設定。GeoIP 與 geosite 用途不同，不能互相取代。

address already in use 通常表示監聽連接埠已被占用。先確認是否同時執行多個用戶端，或有殘留的核心程序。請停止重複執行的實例，或調整 mixed-port 後同步修改系統代理連接埠，不要只改其中一處。退出用戶端後若無法上網，先關閉系統中殘留的手動代理；若曾使用 TUN，再依用戶端說明停止服務並確認路由已復原。基礎網路恢復後，再單獨啟動一個用戶端進行確認。