Clash 常見問題
安裝、設定與連線排除

用戶端提供載入設定、轉送代理流量及執行規則等功能，本身不會產生可用的遠端伺服器。訂閱通常由服務提供者提供，內容包括伺服器位址、驗證資訊、代理群組及分流規則。匯入設定或 Profiles 頁面後，還要選取該設定，再前往代理頁面選擇可用的出口。只安裝用戶端、只儲存訂閱網址，或匯入後未啟用設定，都不代表已建立連線。訂閱屬於敏感資訊，請勿在公開留言或截圖中貼出完整網址。

核心負責讀取設定、比對規則及建立代理連線；圖形介面用戶端則負責顯示設定清單、系統代理開關、記錄檔及安裝設定。mihomo 是 Clash 生態系中持續演進的核心，但並非所有名稱含有 Clash 的用戶端都使用相同核心或支援相同欄位。排查相容性時，請在「關於」或核心資訊頁面記下用戶端名稱、核心類型及錯誤欄位。各用戶端的按鈕位置可能不同，請依實際介面尋找教學中提到的設定，不要只照著截圖位置操作。

規則模式會依設定中的規則逐一比對，為不同目標選擇直連、代理群組或拒絕策略，適合日常使用。全域模式會讓進入核心的流量使用全域策略群組，仍須在該群組中選取可用出口；這不會自動接管所有應用程式。直連模式則讓進入核心的連線直接連至目標，適合用來比對排查。切換模式後，原有長連線可能仍沿用舊路徑，請重新開啟頁面或重啟相關應用程式。如需改變流量接管範圍，請檢查系統代理或 TUN，而非只切換模式。

舊版用戶端可能仍能讀取原有設定，但停止維護後，無法保證後續的系統相容性、協定擴充及問題修正。遷移前先匯出本機規則、覆寫設定及訂閱來源，再選擇仍在維護且支援所需設定語法的用戶端。不要直接用舊程式資料夾覆蓋新版用戶端資料夾。先匯入原始訂閱，確認能載入並連線後，再逐項遷移自訂 DNS、連接埠及規則。若出現未知欄位或不支援的協定，請查看新版用戶端的記錄檔，並向設定提供者確認相容格式。

先判斷是取得失敗還是解析失敗。出現 401 或 403 時，請確認訂閱是否到期、網址是否已重設，以及服務提供者是否限制存取；若逾時，則檢查目前網路及用戶端的訂閱更新代理設定。若出現 YAML 解析錯誤，回傳內容可能是登入頁、錯誤頁或不相容的設定，請重新複製完整訂閱網址，並避免包含空格。更新前先保留可用設定，失敗後不要反覆刪除再重建。也不要將含有驗證資訊的網址提交給不熟悉的線上訂閱轉換服務。

先在用戶端設定中確認服務模式、輔助程式或虛擬網卡元件是否已成功安裝，再依用戶端提示授權。Windows 通常需要安裝具備相應權限的服務；macOS 可能需要核准網路相關權限；Linux 的權限設定則視套件及服務設定而定。不要長期透過提高整個程式的權限來掩蓋服務安裝問題。首次測試時，先關閉其他 VPN 或虛擬網卡工具；啟用 TUN 後查看記錄檔中的網卡及路由錯誤。若網路中斷，先關閉 TUN 恢復連線，再檢查具體錯誤。

先關閉重複執行的用戶端，再找出正在監聽該連接埠的程序，確認用途後再決定是否停止，避免直接結束不明的系統服務。也可以在用戶端的連接埠設定中修改 mixed-port，套用後查看記錄檔，確認新連接埠已開始監聽。接著重新切換系統代理，並同步修改瀏覽器手動代理、終端機環境變數及應用程式內的代理位址。external-controller 是控制介面，不是供瀏覽器使用的代理連接埠，請勿混用。訂閱覆寫可能會覆蓋連接埠值，請確認修改位置在更新後仍會保留。

部分受應用程式容器限制的 Windows 應用程式無法直接連線到本機回送代理。先確認一般瀏覽器能透過同一個用戶端連線，再使用用戶端提供的 UWP 回送工具，只為需要使用本機代理的應用程式啟用豁免；操作可能需要系統管理員授權。若沒有內建工具，可透過 Windows 的 CheckNetIsolation 工具依應用程式套件識別資訊管理，請勿不加區別地為所有應用程式開放權限。若用戶端使用 TUN 接管流量，問題也可能與路由或 DNS 有關，請搭配記錄檔判斷，不要將所有市集應用程式的連線問題都歸因於回送限制。

系統代理只會影響讀取該設定的應用程式。瀏覽器擴充功能、瀏覽器個別代理設定及終端機環境變數，都可能改變實際連線路徑。先暫時停用代理擴充功能，確認系統設定中的代理位址指向用戶端目前正在監聽的連接埠，再單獨測試瀏覽器。終端機則請檢查 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 及其小寫形式，修改後重新開啟終端機。不要將控制介面連接埠填入代理設定。若應用程式不讀取系統代理，可使用內建代理選項，或在確認路由與權限後啟用 TUN。

測速只代表用戶端向指定測試位址發出的一次請求，不表示所有目標網站、協定及連線方式都可用。先確認目前規則命中哪個代理群組，以及該群組實際選用的出口，再查看失敗請求對應的記錄檔。若測試位址可連線但目標網站失敗，可能與目標限制、DNS、伺服器出口或協定相容性有關。不要只依延遲排序後反覆切換。請使用相同目標及模式逐一比較出口，並在切換後關閉舊連線，才能判斷變化是否來自所選節點。

優先使用用戶端提供的覆寫、合併設定或規則擴充功能，不要直接修改下次更新時會被取代的訂閱快取檔案。先記下要比對的網域及預期策略，再將規則放在可能提早命中的寬泛規則之前；MATCH 通常作為最後的兜底規則。策略名稱必須與設定中的代理群組名稱完全一致。套用後，在連線詳細資料或記錄檔中確認實際命中的規則，再更新一次訂閱，確認規則仍然存在。GEOSITE 等規則也需要相應的資料檔及核心支援，不能只複製規則而忽略執行條件。

在用戶端設定頁開啟開機自動啟動後，再到系統的啟動項目或登入項目確認已允許執行。開機自動啟動、自動啟用系統代理及自動啟動 TUN 通常是彼此獨立的設定，不要以為開啟其中一個就完成所有設定。重新啟動後，檢查程序、已啟用的設定及連接埠監聽狀態，再開啟網頁測試。若關機前未正常結束，用戶端設定的系統代理可能仍指向本機；此時用戶端未執行就會導致無法上網。可先關閉系統代理恢復連線，再檢查自動啟動權限及服務狀態。

先關閉代理，確認本機網路能連線至平常可直連的網站，再檢查系統時間、訂閱狀態及目前設定是否已載入。重新啟用代理後，只選一個出口測試同一個目標，並查看記錄檔判斷是連線伺服器逾時、驗證失敗，還是連線目標失敗。改用其他網路有助於判斷目前網路是否限制連線，但請保持其他設定不變。若多個出口在不同網路下都失敗，請聯絡服務提供者確認服務狀態。增加逾時時間只會延長等待，無法修復失效位址、錯誤驗證資訊或遠端無法連線的問題。

先判斷是網域解析失敗，還是解析路徑與預期不符。查看目前生效設定中的 dns 欄位，以及用戶端覆寫是否變更 nameserver、fallback 或增強模式；這些欄位的行為也取決於核心支援。瀏覽器安全 DNS、系統加密 DNS 及其他 VPN 可能使用不同的解析路徑，請逐項記錄並比對測試。使用 TUN 時，也要確認 DNS 劫持及路由確實生效。測試網站顯示的解析器位置只能作為線索，無法單獨證明所有應用程式的解析路徑；修改後應搭配記錄檔及實際請求再次確認。

不要透過關閉憑證驗證或安裝來源不明的根憑證來規避錯誤。先確認系統日期、時間及時區正確，再比較關閉代理、切換出口及更換網路後的結果。若只有某個出口觸發憑證異常，請停止使用該出口並向服務提供者回報。企業網路、公共網路登入頁面及安全軟體的 HTTPS 檢查也可能影響憑證鏈，請依所在網路的管理規範處理。回報時記下錯誤代碼及目標網域即可，避免傳送含有帳號、訂閱網址或完整請求參數的截圖與記錄檔。

先前往系統網路設定關閉殘留的手動代理，確認基本網路已恢復；若先前啟用 TUN，請在用戶端恢復執行後正常關閉該功能，必要時重新啟動系統以清除暫存路由。重新安裝前，備份設定資料夾、覆寫規則及故障時段的記錄檔；分享前請刪除訂閱網址及驗證資訊。接著以最精簡的設定啟動，再逐項恢復功能，確認是否由特定設定或權限操作觸發當機。行動裝置也要檢查 VPN 授權、電池背景執行限制及其他 VPN 是否占用資源；不要直接清除應用程式資料，以免失去排查線索。