Clash 常見問題

Clash 是代理工具生態系中常見的名稱；mihomo 是相容於 Clash 設定體系並持續演進的代理核心，負責處理連線、DNS 與規則比對；圖形化用戶端則提供訂閱管理、策略選擇、日誌檢視和系統代理入口。介面相似不代表核心版本或功能相同，排查時應一併記錄用戶端名稱、用戶端版本與核心版本。設定中的協定或欄位是否可用，應以實際執行核心的支援情況為準，不能只憑用戶端名稱判斷。

用戶端負責執行設定，本身不等於可用的代理服務。訂閱通常提供代理節點、策略群組和規則等內容，也可能只提供節點，必須搭配用戶端的設定範本使用。匯入前請確認來源可信、服務仍在有效期限內，並確認輸出格式適用於目前的核心。匯入後還要啟用對應設定、選擇策略群組和代理模式；單純儲存連結並不會改變網路路徑。請勿在截圖、公開問題回報或聊天紀錄中顯示完整訂閱網址，其中的存取憑證可能遭他人使用。

規則模式依 rules 的排列順序進行比對，並將連線交給符合條件的策略，適合日常依網域或網路範圍分流；全域模式會將進入核心的連線交由全域策略處理，適合暫時確認問題是否來自規則；直連模式則讓進入核心的連線直接連至目標。全域模式不代表所有應用程式都會經過用戶端，未接入系統代理或 TUN 的流量可能根本沒有進入核心。切換模式後請建立新連線再測試，既有的長連線可能仍沿用先前的處理路徑。

系統代理會向作業系統登記代理位址，主要影響會讀取這項設定的應用程式；TUN 則透過虛擬網路介面和路由接入流量，常用來處理不遵循系統代理設定的程式。兩者不一定要同時啟用，初次使用建議先確認系統代理可正常運作，再依應用程式需求啟用 TUN。TUN 也涉及權限、路由、DNS 和其他網路軟體的相容性；啟用後若無法連線，請先關閉 TUN 進行對照測試，而非反覆更換訂閱。實際搭配方式請以用戶端的實作和說明為準。

先查看設定頁面顯示的更新錯誤，再判斷是連結無法存取，還是內容解析失敗。出現 401 或 403 時，檢查訂閱是否到期、憑證是否已重設，以及伺服器是否限制存取；出現 404 時，請向訂閱提供者確認連結是否已更換。若回傳的是登入頁、網頁驗證畫面或格式錯誤，收到的內容可能不是設定檔。連線逾時則檢查本機網路，以及用戶端擷取訂閱時使用直連還是代理。更新成功前請保留上一份可用設定，不要把重新安裝用戶端當成處理訂閱失效的第一步。

先複製原始檔案，再依照日誌提供的行號檢查附近內容。YAML 階層使用空格縮排，避免混入定位字元；也要留意清單項目的連字號、冒號後的空格，以及含有特殊字元的字串。語法檢查通過後，還要確認規則目標存在、策略群組引用的節點名稱完全一致，以及目前的核心支援所用欄位。行號有時指向解析停止的位置，真正的錯誤可能在上一行。每次只修改一小段並重新檢查，確認載入成功後再啟用，發生問題時也較容易還原。

先確認核心能正常啟動，再檢查用戶端要求的服務模式、輔助程式或管理員授權是否已完成。Windows 用戶端可能需要安裝並啟動服務；macOS 可能需要確認輔助程式權限；Linux 則可能涉及虛擬介面存取權限與網路管理能力。不要直接提高來源不明程式的權限，應先確認安裝來源並查閱用戶端說明。完成授權後重新啟動用戶端，並從日誌確認介面建立和路由設定是否成功；若裝置受組織政策管理，請由管理員確認權限範圍，不要繞過管理限制。

部分 Windows 封裝應用程式會受到 AppContainer 網路隔離影響，存取本機代理位址時可能需要迴圈存取豁免；但市集應用程式的問題不一定都由此引起。先確認瀏覽器透過相同的系統代理可以連線，再查看目標應用程式是否有連線紀錄。若用戶端提供迴圈存取豁免工具，只為確有需要且可信任的應用程式啟用；管理員也可使用系統工具檢查對應應用程式套件的豁免狀態。變更後請完全結束並重新開啟應用程式。迴圈存取權限只能解除本機存取限制，無法修復訂閱、DNS 或遠端連線故障。

先比對系統代理位址和連接埠與用戶端實際監聽的值，並確認核心正在執行；預設範例中的 7890 不代表目前設定一定使用該連接埠。接著檢查應用程式是否另有代理設定、是否忽略系統代理，以及系統的略過清單是否包含目標位址。可在應用程式中發出新請求，同時查看用戶端的連線頁面或日誌；完全沒有紀錄時，應優先檢查流量接入路徑，而非調整分流規則。也請確認其他代理軟體或網路管理工具是否覆寫系統設定，必要時只保留一套工具進行比對。

許多命令列工具不會自動讀取桌面系統代理，需要依工具說明設定 HTTP、HTTPS 或 SOCKS 代理。使用 mixed-port 時，可在支援 HTTP 代理的工具中填入本機位址和該連接埠；不要誤填 external-controller，因為它是控制介面，不是流量入口。終端機環境變數只會影響讀取這些變數的程式，變數名稱和生效方式也因工具而異；修改後應在同一個終端機啟動新程序測試。先在目前工作階段暫時設定，確認有效後再永久保存；關閉用戶端後也要一併取消，避免殘留代理設定導致連線失敗。

用戶端測速通常會探測指定位址，結果只反映當下該次探測的連線狀況，不代表所有網站都能存取，也不能直接代表下載速度。先確認目前策略群組實際選取的節點是否與測試對象一致，再查看網頁連線命中了哪個策略。若只有某一類網站無法連線，請檢查網域解析、規則歸屬及目標服務的存取限制；若所有目標都無法連線，再檢查節點是否有效和本機網路是否正常。測試位址本身無法連線也會造成誤判，因此應搭配日誌和實際存取結果判斷，不要只因延遲數值而頻繁切換節點。

更新訂閱檔案時通常會重新下載，直接編輯檔案內容可能會被覆蓋。需要長期保留的設定，應使用用戶端支援的覆寫、合併或指令碼機制，並先了解它對清單採用追加、置前還是整份取代。自訂 rules 的位置尤其重要：具體規則應放在可能先命中的廣泛規則之前，MATCH 作為兜底規則通常放在末尾。修改後請查看最終生效設定，確認策略名稱引用仍有效。不同用戶端的覆寫格式未必通用，轉換時應重新檢查，不要直接複製其他用戶端的覆寫檔案。

先關閉用戶端代理，確認本機網路本身可正常連線至直連目標，再檢查訂閱有效期限、節點是否正確載入，以及裝置時間是否準確。接著選一個節點實際連線，搭配日誌判斷是網域解析失敗、連線逾時、驗證失敗還是憑證錯誤。所有節點都失敗，可能是共用網路路徑或訂閱出了問題，不能直接認定每個節點都已失效。若情況允許，請改用另一個可信任的網路比對；若只有測速失敗，也要檢查探測位址。回報問題時請提供已遮蔽敏感資訊的錯誤內容和操作步驟，避免公開節點密碼及訂閱憑證。

先從日誌確認異常網域是否解析成功，並檢查連線是否進入正確的策略。Fake-IP 會使用映射位址協助分流，部分應用程式或網路環境可能不相容，但網頁無法開啟並不足以判定是它造成的。保留原始設定後，可使用用戶端支援的方式暫時切換解析模式進行比對；若確認只有少數網域不相容，再依核心文件評估 fake-ip-filter，而非排除所有網域。調整後需要重新建立連線，必要時清除系統或應用程式的 DNS 快取，並檢查瀏覽器的安全 DNS 是否繞過預期的解析路徑。

先確認是否重複啟動用戶端，或同時執行其他代理工具。Windows 可使用 netstat 查找監聽連接埠及對應程序；macOS 和 Linux 可使用 lsof 或 ss 查看。確認程序用途後再決定要關閉哪個程式，不要直接結束不熟悉的系統程序。若要保留原有程序，可將 mixed-port 改為未使用的連接埠，並同步修改系統代理、瀏覽器個別代理及終端機設定。也要分清發生錯誤的是代理連接埠還是控制連接埠，兩者不能互相替代。修改後確認核心已成功監聽，再建立新連線進行測試。

先檢查系統代理是否仍指向已停止監聽的本機連接埠，並移除瀏覽器或終端機中另行設定的代理。若先前啟用了 TUN，請優先重新開啟用戶端，依正常關閉程序停用 TUN、關閉系統代理後再退出，並確認虛擬介面與路由是否恢復。若仍有異常，請檢查系統 DNS 是否被手動改為目前無法連線的位址，並重新連線網路。操作前請記下原有網路設定，尤其是在公司網路或使用固定 IP 的環境中；不要一開始就重設所有網路參數，以免一併清除原本需要的設定。