設定與連線 / 問題索引

Clash 常見問題

依基礎認知、安裝設定、使用技巧和故障排除分類查找。先確認用戶端與核心,再分辨設定是否已載入、流量是否進入核心,以及節點是否可用。

點選問題即可展開答案。排查時一次只變更一項設定,並保留原始設定;分享記錄前,請移除訂閱網址、節點憑證與個人網路資訊。

基礎認知

分辨核心、用戶端與訂閱,避免將連線問題歸因於錯誤環節。

Clash、mihomo 與圖形化用戶端各自負責什麼?

Clash 通常指代理核心及其設定生態系;mihomo 是延續此設定生態系的核心專案。圖形化用戶端負責匯入訂閱、選擇策略及設定系統代理等操作,實際連線則由使用中的核心處理。因此,介面相同不代表支援相同的設定欄位,核心相同也不代表設定入口一致。查找教學時,請先確認用戶端名稱,再從「關於」頁面或執行記錄確認核心,避免將舊版 Clash 的限制套用到 mihomo。

安裝用戶端後還需要準備什麼?

用戶端只是設定及使用代理連線的工具,安裝完成後不會自動產生可用節點。你需要準備有權使用的訂閱連結,或包含代理節點、策略群組及規則的設定檔。訂閱通常由服務提供者或自行架設的服務產生,本網站的下載入口不等於訂閱服務。匯入前請確認訂閱適用的用戶端格式,並妥善保護連結中的身分資訊;不要將完整訂閱網址貼到公開討論區,也不要匯入來源不明的遠端設定。

規則、全域與直連模式有什麼差異?

規則模式會依設定中的規則順序,為連線選擇直連、代理或拒絕等處理方式。全域模式會將進入核心的連線交由全域策略處理,但仍需選擇可用節點。直連模式則讓進入核心的連線直接連至目標。這三種模式改變的是核心收到連線後的處理方式,不會決定應用程式是否將流量交給核心。因此,切換至全域模式不能取代系統代理或 TUN 設定,也不保證所有應用程式流量都會經過代理。

如何區分 Clash 官方網站、用戶端官網與下載中心?

Clash 生態系包含多個由不同團隊獨立維護的核心與圖形化用戶端,不能只因頁面標示「官方網站」就認定它代表整個生態系。請依特定用戶端核對專案名稱、維護說明及發布管道。本網站彙整下載入口與中文設定說明,不會將不同專案視為同一個維護團隊。尋找 Clash for Windows 替代用戶端時,請先確認維護狀態、平台支援與設定相容性,再比較介面;舊教學中的安裝檔與設定名稱可能已經變更。

桌面用戶端與 Android、iOS 用戶端可以共用設定嗎?

能否共用設定,取決於核心與欄位支援情況,不只看作業系統。基本規則與常見代理欄位可能相容,但桌面系統代理、TUN、檔案路徑及指令碼相關設定不能直接套用到行動裝置。行動裝置通常透過系統 VPN 介面接管流量,權限設定入口也與桌面不同。跨裝置匯入時,請先使用服務提供者標示為相容的設定,再檢查匯入記錄;遇到不支援的欄位,應查閱目前用戶端的說明,而不是任意刪除整個設定區段。

選型參考:用戶端比較;術語查閱:名詞解釋。

安裝設定

先載入有效設定,再處理監聽連接埠與系統授權。

如何匯入訂閱並確認已生效?

在用戶端的設定或訂閱頁面新增遠端設定,貼上完整網址並儲存,接著執行更新。清單出現新設定後,還要將它設為目前使用的設定,不能只停留在下載成功這一步。開啟代理頁面,確認預期的策略群組已出現,再選擇可用節點並啟用系統代理或行動裝置 VPN。最後前往實際需要使用的網站,並搭配連線記錄確認套用的策略;介面顯示訂閱已儲存,只代表網址儲存成功,不代表設定已載入或連線已接管。

Clash 訂閱更新失敗或訂閱失效時該怎麼處理?

先查看更新錯誤是網路逾時、HTTP 狀態碼錯誤,還是設定解析失敗。檢查網址是否完整、訂閱是否到期,以及服務提供者是否更換了入口;401 或 403 可能與授權或存取限制有關,404 則可能表示網址已變更。若目前代理無法使用,可嘗試切換至可用節點,或在用戶端支援時改用直連更新。下載到登入頁、驗證頁等 HTML 內容也會造成解析失敗。不要反覆重新安裝用戶端,應先確認訂閱端回傳的是有效設定。

匯入設定時出現 YAML 解析錯誤,該怎麼辦?

先依記錄中的行號檢查前後幾行,特別留意縮排、冒號後的空格,以及清單項目開頭的連字號。YAML 縮排應使用空格,複製內容時混入定位字元或全形標點很容易破壞結構。若檔案來自訂閱,請先重新下載原始設定,不要直接在訂閱網址末尾加上未經說明的參數。語法正確仍然報錯,可能是目前核心不支援該欄位。修改前請保留副本,每次只改一處,才能分辨是格式錯誤還是欄位相容性問題。

TUN 模式提示權限不足或建立虛擬網卡失敗,該怎麼辦?

先停止 TUN,再檢查用戶端要求的服務元件、管理員授權或系統網路延伸功能是否已安裝並獲准執行。Windows 通常需要安裝並啟動用戶端的服務模式;macOS 可能需要在系統設定中允許相關網路延伸功能,請以用戶端提示為準。行動裝置則需允許建立 VPN 連線。不要把長期提高整個用戶端的執行權限當成唯一解法。完成授權後重新啟動核心;若仍然失敗,請檢查其他 VPN 是否占用網路介面,並保留記錄中的具體錯誤訊息。

mixed-port 是什麼?連接埠被占用時如何更改?

mixed-port 是可同時接受 HTTP 與 SOCKS 代理連線的本機監聽連接埠,實際值以目前生效的設定為準,不能假定永遠是 7890。啟動時若提示位址已被占用,請先確認是否有其他用戶端或核心程序重複執行。你可以關閉重複程序,或改用尚未占用的連接埠。變更後,請同步更新瀏覽器、終端機及手動設定的應用程式代理位址,並重新啟動核心;如果只修改設定檔而未重新載入,舊的監聽連接埠可能仍在使用。

完整操作步驟請參閱快速入門;欄位結構請參閱YAML 手冊。

使用技巧

透過連線記錄驗證設定,不要只看開關是否已開啟。

日常使用該選規則模式,還是 Clash 全域模式?

日常使用通常先選規則模式,讓設定依目標位址決定連線路徑。某個網站連線異常時,可暫時切換至全域模式進行比對,並確認全域策略選用了可用節點。若全域模式正常、規則模式異常,請查看該連線套用了哪條規則,再調整對應策略或規則順序。排查完成後請恢復原本模式,避免其他連線也經由相同出口。全域模式測試只能協助縮小問題範圍,不能單獨證明問題一定出在規則;也要比較兩種模式實際選用的節點是否相同。

如何讓指定網站直連,其他網站仍依原有規則處理?

為目標網域新增精確網域或網域後綴規則,並將它放在可能優先比對的廣泛規則與 MATCH 預設規則之前。若要匹配主網域及其子網域,可使用 DOMAIN-SUFFIX;只需匹配單一主機名稱時,則可考慮 DOMAIN。修改訂閱設定前,優先使用用戶端的覆寫或自訂規則入口,避免下次更新時變更遭到覆蓋。儲存並重新載入後,建立新連線查看比對記錄;既有連線可能仍沿用原本路徑。網站若依賴多個網域,也要逐一確認資源請求的處理方式。

開啟系統代理後,為什麼終端機仍未走代理?

系統代理主要影響會讀取系統代理設定的應用程式;部分命令列工具只會讀取自身參數或代理環境變數。先查明目標工具支援的代理設定方式,再依目前的監聽位址與連接埠設定 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY;變數名稱及優先順序請以工具文件為準。已開啟的終端機可能需要重新開啟,某些工具也可能以自身設定覆蓋系統設定。排查時請查看實際連線記錄;測試結束後清除暫用環境變數,避免停用用戶端後,終端機仍指向失效的本機連接埠。

DNS 與 Fake-IP 該如何選擇?

Fake-IP 會為網域回傳虛擬位址,再由核心將連線對應回原始網域,有助於依網域分流,但前提是應用程式的 DNS 查詢經過核心管理。是否啟用,應以用戶端預設設定及目前網路的相容性為依據,而不是只切換單一選項。區域網路裝置、部分遊戲,或依賴真實解析位址的應用程式可能需要例外處理。特定網域發生異常時,先核對記錄,再依目前核心支援的 fake-ip-filter 語法設定例外;變更後清除相關快取並重新連線。

更換節點或更新設定後,需要關閉既有連線嗎?

既有 TCP 連線通常不會因策略選擇改變而自動切換至新出口,應用程式也可能重複使用連線池,因此切換後短時間內看起來仍走舊節點。先關閉目標應用程式的相關連線,或在用戶端的連線頁面中斷對應連線,再重新發出請求。更新規則或 DNS 設定後,也可能需要重新啟動應用程式、清除 DNS 快取或重新載入核心。不要只憑已開啟網頁的狀況判斷修改無效;應查看新連線的策略記錄,也避免一次清除所有連線,以免中斷正在進行的工作。

延伸閱讀:代理模式設定、Fake-IP 設定。

故障排除

依序檢查流量入口、規則比對、節點出口與 DNS 解析。

Clash 系統代理無效、瀏覽器無法開啟網頁,該如何排查?

先確認核心已啟動且目前設定有效,再檢查系統代理位址是否指向正在監聽的本機連接埠。確認瀏覽器擴充功能、瀏覽器個別代理設定及其他代理軟體沒有覆蓋系統設定。接著在連線頁面發出新請求:若沒有記錄,先排查流量入口;若有記錄,再查看套用的策略與錯誤訊息。可暫時改用另一個瀏覽器比對,判斷問題出在瀏覽器設定還是網路。不要同時修改 DNS、規則與節點,依序檢查入口、策略、出口會更容易找出問題。

節點測試逾時,但其他節點正常,該怎麼辦?

先切換至其他節點存取相同目標,確認故障是否只發生在單一節點。測試逾時可能是節點無法連線、測試網址異常、通訊協定不相容或目前網路受到限制,不能只憑一次測試就認定整份訂閱失效。檢查訂閱是否已更新、裝置時間是否正確,並查看連線至該節點時的記錄。若只有測試失敗、實際存取正常,可檢查測試 URL;若實際存取也失敗,先使用可用節點,再向服務提供者回報發生時間、網路類型,以及已移除敏感資訊的錯誤摘要。

Windows UWP 應用程式未使用本機代理,如何檢查回環設定?

部分受到應用程式容器隔離限制的 UWP 應用程式,無法直接存取本機回環代理位址。若瀏覽器正常、某個 UWP 應用程式卻無法使用,先確認它確實受到此限制,再使用用戶端提供的回環豁免工具,只授權需要的應用程式。若沒有工具,可依照 Windows 的 CheckNetIsolation 文件檢查對應套件的豁免狀態。此操作可能需要管理員權限,也不適用於所有 Microsoft Store 應用程式。完成授權後重新啟動目標應用程式;若它本身不讀取系統代理,還需另外檢查流量接管方式。

如何檢查 Clash DNS 外洩?瀏覽器的安全 DNS 會造成影響嗎?

先確認應用程式的 DNS 查詢由哪個元件處理,再比對核心 DNS 設定、系統 DNS 與瀏覽器安全 DNS 設定。瀏覽器內建的加密 DNS 可能採用獨立的解析路徑,不一定遵循核心的解析策略。外洩測試顯示的解析服務位置只能作為線索,不能單憑地區判斷是否外洩。應搭配 DNS 記錄與流量路徑,確認查詢是否依預期送出。切換 TUN 或 DNS 設定後,重新發出查詢,必要時清除快取;也要確認 IPv6 查詢與區域網路裝置的解析路徑是否已納入設定。

關閉用戶端後無法上網,或啟用 TUN 後區域網路無法使用,該怎麼辦?

關閉用戶端後無法上網時,先檢查系統是否仍保留指向本機連接埠的手動代理,再確認 DNS 與 VPN 連線狀態,並優先透過用戶端正常關閉系統代理和 TUN。啟用 TUN 後若只有印表機、路由器或區域網路服務異常,應檢查私人網段的路由排除設定與直連規則,而不是直接關閉所有防火牆。不同用戶端的自動路由方式各不相同,修改前請記下原設定。網路恢復正常後再逐項啟用功能;若問題持續,保留路由與記錄資訊,避免盲目重設所有網路設定。

DNS 欄位與範例請參閱YAML 手冊:DNS 設定。需要重新挑選相容的用戶端時,請前往下載中心。