FAQ · 依問題查找設定

Clash 常見問題

從匯入訂閱到排查連線。先確認要求是否進入核心,再檢查規則、出口和 DNS,避免同時變更多項設定。

第一次使用可先參考入門指南;需要完整的排查流程時,請前往問題診斷。點選問題即可展開答案,也可同時展開多個問題進行比對。

基礎概念

先分清用戶端、核心和流量接管。開關名稱相似,不代表處理的是同一件事。

查看名詞解釋 →
Clash、mihomo 與用戶端有什麼關係?

Clash 是代理核心及其設定生態系的常見稱呼,mihomo 則是這個生態系中持續發展的核心專案。Clash Verge Rev、FlClash 等用戶端提供圖形介面,負責匯入設定、管理系統代理與核心程序;實際解析規則、建立連線的是核心。排查時,先在「關於」或「核心」頁面分別記下用戶端名稱與核心版本。介面相似不代表支援相同設定,尤其是 TUN、DNS 和通訊協定欄位。下載時請依裝置系統選擇用戶端,修改設定前也要確認目前執行的核心,別只看安裝檔名稱。

安裝用戶端後,還需要準備訂閱或節點嗎?

需要可用的代理設定。用戶端負責讀取設定並轉送要求,安裝本身不會提供可用的遠端代理服務。通常可從既有服務的帳戶頁面取得 Clash 或 mihomo 格式的訂閱,再到「設定」頁匯入;也可以匯入自行維護的 YAML 檔案。匯入後,請確認設定已選取、「代理」頁已載入策略群組,且所選群組有可用出口。訂閱網址通常含有帳戶識別資訊,請妥善保管;分享截圖時記得遮住完整網址。來源不明的設定不要用於重要帳戶,也別把單一節點連結誤認為完整設定檔。

規則、全域和直連模式該怎麼選?

日常使用建議先選「規則」,讓要求依 rules 的順序由上而下比對,再交由對應的策略群組處理。「全域」會將進入核心的要求統一交給全域策略群組,適合暫時確認規則是否造成異常,但仍須在該群組選擇可用出口。「直連」則讓進入核心的要求直接連線,適合用來比對測試。模式只決定核心收到要求後如何處理,不能取代系統代理或 TUN,也不會自動接管所有應用程式。切換到全域後仍無法開啟網頁,請先確認要求是否出現在記錄中,再檢查出口連線;不要連續切換模式又同時修改 DNS,否則難以判斷是哪項設定生效。

系統代理和 TUN 有什麼差別?需要同時啟用嗎?

系統代理透過作業系統的代理設定,讓遵循該設定的應用程式連到本機監聽連接埠;TUN 則透過虛擬網路介面接收路由至該介面的 IP 流量,較適合不遵循系統代理的程式。兩者都不代表所有流量一定會經過代理,實際結果也會受到路由、應用程式行為和規則影響。首次設定時先只啟用系統代理,確認瀏覽器能正常使用後,再視需要啟用 TUN,並依照用戶端對開關組合的建議操作。排查問題時,不要一次啟用多個代理用戶端、VPN 和虛擬網卡接管功能。先保留一條明確的流量接管路徑,比同時開啟多個開關更容易找出問題。

安裝設定

依架構選擇安裝檔,確認目前設定,再處理開機啟動與權限。安裝完成只是第一步。

查看訂閱匯入步驟 →
匯入訂閱連結後,如何確認設定確實生效?

在「設定」頁選擇「從 URL 匯入」或「新增訂閱」,貼上服務提供的 Clash 格式網址並儲存。下載完成後,點選該設定檔,將它設為目前使用的設定。接著到「代理」頁確認策略群組已載入,再到「記錄」頁檢查是否有解析錯誤。清單中出現檔案,只代表設定已儲存,不表示已啟用。若看到 yaml: unmarshal errors,先確認訂閱格式與核心是否相容,不要直接刪除不熟悉的欄位。最後啟用系統代理並造訪目標網站,查看連線記錄;記錄中的規則、策略群組和出口,才是判斷設定是否生效的依據。

安裝檔該選 x64、ARM64 還是其他架構?

先確認作業系統的處理器架構,再選擇安裝檔。Windows 可在「設定 → 系統 → 系統資訊」查看系統類型;macOS 可在「關於這台 Mac」查看晶片,Apple Silicon 通常選 ARM64,Intel 機型則選 x64。多數較新的 Android 裝置使用 arm64-v8a,但仍應以裝置與安裝檔的支援範圍為準;Linux 可執行 uname -m,x86_64 通常對應 AMD64,aarch64 通常對應 ARM64。架構相符後,也要確認最低系統需求。若無法安裝或啟動,請保留完整錯誤訊息,先排除架構與系統版本不符的問題;安裝階段出錯時,不必反覆更換訂閱。

Clash 設定開機啟動後,為什麼沒有自動連線?

「開機啟動」通常只代表啟動用戶端,不保證核心、系統代理和 TUN 也會恢復。先登出再重新登入,確認系統匣是否出現用戶端圖示,再檢查核心狀態、目前設定和流量接管開關。Windows 也要確認「啟動應用程式」是否停用了該程式;使用 TUN 時,請確認用戶端所需的服務已安裝且能正常啟動。不要重複設定管理員權限和一般使用者的啟動項目。若只是剛登入時訂閱更新失敗,可等網路連線就緒後手動更新,或使用用戶端提供的延遲啟動選項。請逐項確認啟動流程,別只因為工作管理員中有程序,就認定連線已恢復。

TUN 模式顯示權限不足,該處理哪個項目?

先確認提示是來自服務安裝、虛擬介面建立,還是網路延伸功能授權。Windows 用戶端若提供「服務模式」或「安裝服務」,請依照提示授權安裝,再重新啟用 TUN;不要長期依賴反覆以較高權限啟動來掩蓋服務故障。macOS 請依實際提示,在系統設定中允許相應的網路延伸功能或 VPN 設定,不同用戶端的實作方式可能不同。Linux 通常需要存取 /dev/net/tun,並具備相應的網路管理權限,請採用專案建議的服務設定。授權後查看記錄,確認介面是否成功建立。若之後仍無法連網,應繼續檢查路由和 DNS,而不是反覆授予與網路無關的磁碟權限。

使用技巧

分別檢查測速、策略群組、連接埠和應用程式代理設定,並以新連線的實際出口為準。

了解策略群組 →
Clash 節點測速正常,實際下載卻很慢,為什麼?

延遲測試主要反映測試位址的連通性與回應時間,不代表持續傳輸速度,也不保證目標網站使用相同路徑。先固定一個出口和同一個下載網址,查看連線記錄,確認實際要求沒有被規則導向其他策略群組。再比較直連與代理、不同出口及不同時段,判斷問題來自本地網路、遠端線路還是目標網站限速。測試時暫停其他裝置的大量傳輸,避免測速與下載互相搶占頻寬。若只有特定應用程式速度慢,請檢查該程式的代理設定與並行連線限制。不要只按最低延遲選節點,也別把單次測速結果當成長期速度保證。

策略群組已切換節點,為什麼連線仍走舊出口?

先到「連線」頁查看該要求命中的規則與策略群組,確認修改的是實際使用的群組,而非名稱相近的其他群組。select 群組可手動選擇;url-test 等自動群組則可能依測試結果重新選擇節點。若是巢狀群組,也要沿著選擇鏈逐層檢查。既有的長連線通常不會因為切換節點就立即轉移,請先關閉對應連線或重新啟動發出要求的應用程式,再建立新連線驗證。訂閱更新也可能改變群組結構或重設選擇,實際情況取決於用戶端是否會保留選擇狀態。排查時一次只修改一個群組,並記錄新連線的出口;不要用仍在重複使用的舊頁面連線判斷切換是否成功。

mixed-port 和 external-controller 各自有什麼用途?

mixed-port 是接收 HTTP 與 SOCKS 代理要求的混合監聽連接埠;應用程式的手動代理設定應指向這個連接埠。external-controller 則是管理核心的 API 位址,不能當作上網代理連接埠。7890 和 127.0.0.1:9090 是常見範例值,實際設定請以目前使用的用戶端為準。若記錄出現 bind: address already in use,先關閉其他代理程式,再檢查連接埠是否被占用;修改 mixed-port 後,也要同步更新應用程式的手動代理設定。管理介面應優先綁定回環位址,確實需要對外開放時再設定存取控制。不要只為了讓本機應用程式連線,就把管理介面直接暴露在區域網路或公網。

瀏覽器能上網,但 Windows UWP 應用程式無法連線,怎麼辦?

先確認受影響的是採用應用程式容器隔離的 UWP 應用,而不是所有 Windows 程式。部分應用程式預設無法存取本機回環代理,因此可能出現瀏覽器正常、商店應用程式卻無法連線的情況。若用戶端提供「UWP 回環豁免」工具,請以所需權限開啟工具,只替需要的應用程式啟用豁免,再重新啟動該應用程式測試。豁免只會允許存取回環位址,不會自動設定代理,也無法修復無效節點。若沒有相關工具,可依照 Microsoft 文件使用 CheckNetIsolation 管理指定應用程式的回環豁免,不要直接對所有應用程式一律開放。若仍無法連線,請確認該應用程式是否遵循系統代理,以及連線記錄是否收到要求。

故障排查

保留完整錯誤訊息,區分訂閱要求、節點連線和目標網站要求,再逐步縮小問題範圍。

查看節點逾時排查流程 →
訂閱更新失敗,回傳 401 或 403,該如何排查?

先分辨是 HTTP 錯誤還是網路錯誤。401、403 通常與網址失效、存取限制或帳戶狀態有關,請回到帳戶頁面確認服務狀態,並重新複製完整的 Clash 訂閱網址;若是 404,先確認路徑是否完整複製。若收到的是 HTML 登入頁,而非 YAML 設定,也會造成匯入解析失敗。若出現 i/o timeout,則應檢查目前網路及訂閱網域是否可連線。若用戶端允許選擇更新時是否經過代理,可分別測試直連和已確認可用的代理出口,避免訂閱更新依賴尚未成功載入的設定。回報錯誤時只保留狀態碼與網域,並刪除網址中的帳戶識別資訊和查詢參數。

節點顯示 timeout 或記錄出現 dial tcp,該先檢查什麼?

先查看完整錯誤訊息。dial tcp 本身不是原因,只是建立 TCP 連線時的上下文。若後面接著 i/o timeout,通常表示連線未能在期限內完成;connection refused 通常表示目標連接埠沒有程式監聽,或連線遭到明確拒絕;no such host 則應先檢查網域解析。確認訂閱仍有效、節點位址和連接埠已更新後,再換一個出口進行比對,並暫時關閉其他 VPN,以免路由衝突。所有節點同時失敗時,優先檢查本地網路、DNS 和用戶端的流量接管狀態;只有單一節點失敗時,再聯絡相關服務提供者。不要無止境地增加逾時時間,也不要關閉整體防火牆防護來取代問題排查。

系統代理已啟用,瀏覽器仍未透過 Clash 連線,怎麼辦?

先開啟「連線」頁,再重新載入目標網站。如果完全沒有新要求,問題較可能出在流量接管,而非分流規則。確認作業系統中的代理位址與連接埠是否對應目前的 mixed-port,再檢查瀏覽器是否使用自己的代理擴充功能或獨立網路設定;Firefox 等應用程式可能不會直接沿用系統設定。關閉其他代理用戶端,以免覆寫系統代理。若要求已進入核心,卻顯示 DIRECT,請檢查命中的規則與模式,不要只是不斷重新啟用系統代理。結束用戶端前先關閉系統代理;若關閉程式後所有網路都中斷,請回到系統代理設定,移除仍指向本機連接埠的手動代理。

出現 no such host,或啟用 TUN 後無法開啟網域,該怎麼處理?

先分辨是節點網域解析失敗,還是目標網站解析失敗;記錄中的網域有助於判斷問題所在。記下目前的 dns 設定,每次只調整一個環節:確認使用的解析器能連線、解析器網域本身能完成初始解析,並檢查 DNS 要求是否被其他 VPN 或安全軟體接管。使用 fake-ip 時,也要確認虛擬位址的流量能正確接管;單純清除快取無法修正錯誤路由。若瀏覽器啟用了獨立的安全 DNS,可暫時改成跟隨系統設定進行比對測試。修正設定後,再清除系統與應用程式快取並重新建立連線。不要拼湊多份教學中的 DNS 設定,尤其不要混用目前核心不支援的欄位。