Clash 常見問題
訂閱、代理與連線排解
先確認問題出在哪一層,再調整相應設定。從設定匯入到 DNS,依症狀查找處理步驟。
基礎觀念
釐清用戶端、設定與流量入口的差異,避免混淆不同層面的問題。
Clash、mihomo 與圖形化用戶端有什麼關係?
Clash 是代理核心與設定生態系中常見的名稱,mihomo 是這個生態系中的開源核心實作,圖形化用戶端則提供訂閱、代理群組、記錄與系統設定介面。介面名稱相似,不代表使用相同核心,也不代表支援所有設定欄位。選擇用戶端時,先確認裝置平台、維護狀態與核心相容性,再評估是否需要 TUN 或區域網路共享。排解問題時,也要記下用戶端名稱與核心資訊;只說使用 Clash,通常不足以判斷是否支援特定欄位。
安裝用戶端後,還需要準備訂閱或設定檔嗎?
通常需要。用戶端負責讀取設定並處理連線,安裝完成後不會自動提供可用的代理服務。訂閱網址通常由服務提供者提供,連結可能包含個人存取憑證,應視為敏感資訊妥善保管。匯入前先確認目前使用的核心支援該設定格式,再檢查訂閱是否仍在有效期限內、帳戶是否還有可用額度。本網站提供用戶端下載入口與設定說明,不會產生訂閱或節點。尋求協助時只提供錯誤訊息,勿傳送完整訂閱網址、QR Code 或含個人憑證的設定檔。
規則、全域與直連模式各適合哪些情況?
規則模式依照 rules 的順序決定連線去向,適合日常使用;全域模式通常會將進入核心的連線交由全域代理群組處理,適合短暫比對測試;直連模式則讓進入核心的連線直接存取目標。全域模式不等於接管整台電腦,未經系統代理或 TUN 的應用仍可能略過用戶端。測試後應切回規則模式,並在連線清單確認目標網域符合哪條規則。切換模式無法修復失效的訂閱、過期帳戶或無法連線的節點,也不能取代對底層網路的檢查。
系統代理、TUN 與 mixed-port 有什麼差異?
mixed-port 是核心用來接收 HTTP 與 SOCKS5 代理連線的混合連接埠,常見範例為 7890,實際數值以目前的設定為準。系統代理會將代理位址寫入作業系統設定,主要影響遵循該設定的應用程式。TUN 則透過虛擬網路介面接管符合路由條件的流量,需要相應權限與網路元件。初次使用可先開啟系統代理,確認瀏覽器能正常連線後,再依應用需求測試 TUN。不必一直同時啟用兩者;遇到問題時分開測試,較容易找出連接埠、權限或路由衝突。
需要選擇適用於裝置的程式嗎?請查看用戶端與平台安裝入口。
安裝設定
匯入成功不代表流量已由用戶端接管。請依序確認設定已啟用、代理群組已選定,並具備所需的系統權限。
如何匯入訂閱網址或本機 YAML 檔案?
開啟用戶端的設定或訂閱頁面,使用新增訂閱功能貼上完整網址,儲存後執行更新,並將新設定設為目前使用的項目。匯入本機檔案時,選擇檔案匯入,確認副檔名與內容確實是 YAML,而不是下載失敗後存下來的網頁。匯入成功後,還要開啟代理群組選擇可用策略,再啟用系統代理。若曾編輯本機檔案,請保留原始檔並檢查縮排,避免混用定位字元。不同用戶端的按鈕名稱略有差異,但匯入、啟用設定、選擇策略、接管流量這四個步驟應依序完成。
訂閱更新失敗,如何判斷是訂閱失效還是網路問題?
先查看更新提示,區分 HTTP 狀態碼、連線逾時與設定解析失敗。401 或 403 通常需要檢查存取權限、連結憑證或帳戶狀態;404 則應確認網址是否完整,以及服務提供者是否更換了入口。這些狀態也可能由中間閘道回傳,需參照服務提供者的說明判斷。發生逾時時,先檢查基本網路,以及下載訂閱所使用的直連或代理路徑。若回傳 HTML 或 YAML 解析錯誤,可能取得的是登入頁面或格式錯誤的內容。不要反覆公開貼上網址測試;若確認憑證已外洩,應至服務提供者的管理後台重設訂閱網址。
TUN 模式顯示權限不足或服務未執行,該怎麼處理?
先關閉 TUN,確認一般系統代理可正常使用,再查看用戶端是否提供安裝服務、修復服務或授權網路延伸功能的入口。Windows 通常需要以系統管理員權限安裝或啟動服務;macOS 需依系統提示允許相應的網路元件;Linux 的權限與路由需求則視用戶端安裝方式而定。完成授權後重新啟動用戶端,再查看記錄中是否仍有權限或建立裝置失敗的錯誤。不要長期關閉防火牆來解決問題。若同時執行其他 VPN、虛擬網卡工具或另一個 TUN 用戶端,請先逐一結束後再測試,避免路由互相覆蓋。
iPhone 匯入設定後,為什麼仍提示需要 VPN 授權?
匯入設定與取得系統 VPN 授權是兩回事:前者提供代理與規則,後者允許用戶端建立系統網路通道。首次連線時,先確認授權提示是由目前使用的用戶端所觸發,再依系統要求確認並完成裝置驗證。以 Clash Plus 為例,可從下載頁前往 App Store,並至 clashplus.io 查看產品資訊。取得授權後仍無法連線時,請檢查設定是否已啟用、代理群組是否已選定,以及是否有其他 VPN 正在占用連線。訂閱格式的支援範圍以各用戶端說明為準,不應只憑檔名判斷相容性。
依步驟操作可參閱首次安裝與訂閱匯入教學;iPhone 用戶端下載入口請見iOS 下載專區。
使用技巧
保留可用副本,透過命中記錄驗證規則,並以實際連線確認設定結果。
如何新增自訂規則?為什麼新增後沒有生效?
先確認用戶端是否提供覆寫或擴充設定的入口,並優先將規則新增至不會被訂閱更新覆蓋的位置。規則會由上而下依序比對,例如 DOMAIN-SUFFIX,github.com,PROXY 應放在可能先比對到該網域的寬泛規則之前,而且 PROXY 必須是實際存在的策略名稱。儲存後重新載入設定,再透過新的連線查看命中記錄;既有的長連線可能不會立即依新規則重新建立。若仍未命中,請確認應用程式流量確實經過核心,並核對記錄中的實際網域,避免將網頁主網域與資源網域混為一談。
節點測速正常,為什麼下載或播放影片還是很慢?
延遲測試主要反映特定測試目標的回應時間,不等於持續傳輸量,也不保證所有網站都走相同路線。先在相同網路、相同目標與相近時間,比較直連和代理,並確認連線清單實際使用的是預期代理群組。接著檢查無線訊號、背景下載、伺服器壅塞、帳戶限速,以及目標網站的區域內容分發差異。不要只因一次測得最低延遲,就反覆切換節點。影片的既有連線可能繼續沿用舊策略,切換後應重新建立播放連線。測速網址無法連線時,測試失敗也不一定代表節點本身失效。
如何讓手機透過同一個區域網路使用電腦的代理?
先讓手機與電腦連上同一個可信任的區域網路,再於電腦用戶端開啟允許區域網路連線,確認 allow-lan 為 true、監聽位址可接受區域網路連線,並記下 mixed-port 的實際連接埠。手機的 Wi-Fi 手動代理設定中,填入電腦的區域網路 IP 與該連接埠;不要填 127.0.0.1,因為那會指向手機本身。電腦防火牆只需針對必要的網路設定檔允許該連入連接埠。此方法主要適用於遵循 Wi-Fi HTTP 代理設定的應用程式,不保證能接管所有流量。使用完畢後請關閉共享,也不要將代理連接埠暴露至公用網路。
為什麼開機自動啟動後仍要手動連線?設定變更如何保留?
開機自動啟動通常只會啟動用戶端,不一定會同時啟用系統代理、恢復 TUN 或選取上次使用的設定;這些行為分別由用戶端設定控制,沒有通用的 YAML 自動啟動開關。先檢查登入時啟動、啟動時連線與服務狀態,再重新啟動電腦確認。訂閱中的規則與代理可能在更新時被取代,本機變更應透過用戶端支援的覆寫、合併或獨立設定功能保存。修改前先匯出可用副本,並記下變更的欄位。更新用戶端後若行為有變,先確認設定是否保留,不要反覆將相同內容附加至原始訂閱檔案。
需要對照欄位關係?請閱讀YAML 結構與規則引用說明。
疑難排解
先確認流量是否進入核心,再區分規則、節點連線與網域解析問題。
系統代理已啟用,但瀏覽器或其他應用程式沒有走代理?
先確認核心正在執行、目前設定已啟用,並核對系統代理位址與實際監聽連接埠是否一致。只有用戶端在本機監聽時,系統代理指向 127.0.0.1 才能正常運作。接著檢查瀏覽器擴充功能、應用程式內建代理、自動設定指令碼,或其他代理工具是否覆寫了系統設定。開啟連線清單並送出一筆新請求:若有記錄,接著檢查規則與策略;若沒有記錄,則著重確認應用程式是否讀取系統代理。命令列工具、部分遊戲與商店應用程式可能需要個別設定或測試 TUN,不能只看系統代理開關就判定所有流量都已接管。
Windows 的 UWP 應用程式無法連線,需要設定回環豁免嗎?
部分受應用程式容器限制的 UWP 應用程式,存取本機回環代理時可能會受限,但並非所有商店應用程式的情況都相同。先確認一般瀏覽器使用相同代理時可正常連線,再檢查目標應用程式是否確實需要連接本機代理。若用戶端提供 UWP 回環工具,可視需要為指定應用程式新增豁免,通常需要系統管理員授權;也可先使用 CheckNetIsolation LoopbackExempt -s 查看現有記錄。不要直接一次對所有應用程式開放。若使用 TUN,則應另外檢查接管路由與 DNS;回環豁免並非所有 Windows 應用程式無法上網的通用解法。
節點一直逾時,記錄出現 timeout 或 connection refused,該怎麼辦?
先關閉代理並檢查基本網路,再確認訂閱已更新、帳戶有效,且目標代理群組沒有選到失效節點。timeout 表示連線未能在指定時間內完成,可能與網路封包遺失、位址無法連線、伺服器狀態或解析結果有關;connection refused 通常表示目標連接埠拒絕連線,也可能是本機代理連接埠沒有監聽。先確認錯誤中的目標位址是節點伺服器、目標網站還是本機回環位址,再決定檢查哪一層。以另一條已知可用的連線作比較,並記下錯誤發生時間。不要把所有逾時都歸咎於規則,也不要一次同時修改連接埠、DNS 與模式。
連線已建立,但網域無法開啟,如何排查 DNS 與 Fake-IP?
先確認問題是否只影響特定網域,再查看記錄中是否有解析失敗、上游 DNS 逾時或規則誤判。啟用 Fake-IP 時,查詢結果是保留位址可能是預期行為,不能只憑這點判定解析錯誤;關鍵在於後續連線是否由核心接管。若區域網路網域、遊戲或特定應用程式出現相容性問題,可先了解設定,再新增針對性的 fake-ip-filter,或使用支援的其他 DNS 模式作比較。修改後重新載入設定,並依作業系統方式清除 DNS 快取、重新建立應用程式連線。不要同時使用多個 DNS 接管工具,也不要隨意替換所有上游位址。
仍找不到問題原因時,請前往依症狀分類的疑難手冊,繼續檢查網路、記錄與系統設定。