FAQ · 桌面用戶端使用指南

Clash 常見問題與連線疑難排解

從匯入訂閱到系統代理、TUN 與 DNS,依問題所在環節逐步排查。先確認設定已啟用,再檢查流量是否進入核心,最後核對規則與遠端連線。

不同用戶端的選單名稱可能略有差異,以下以設定頁、代理頁、連線頁、記錄頁與設定頁說明操作位置。

點選問題即可展開答案,也可同時展開多個項目進行比對。分類連結可直接跳至對應章節。

概念與使用範圍

基礎概念

先釐清核心、用戶端、設定與流量入口,避免混淆不同層面的問題。

Clash、mihomo 與桌面用戶端有什麼差異?

Clash 通常泛指一類規則代理工具及其設定生態;mihomo 是負責協定連線、規則比對與 DNS 處理的核心;桌面用戶端則提供匯入設定、選擇策略組、系統代理及查看記錄等圖形介面。即使使用相同核心,不同用戶端的選單位置、服務安裝方式與覆寫功能也可能不同。排查問題時,應一併記錄用戶端名稱與版本、核心版本,不能只寫使用了 Clash。設定欄位是否可用,應以實際執行的核心支援範圍為準。

下載用戶端後,還需要訂閱或設定檔嗎?

用戶端負責讀取設定並建立連線,安裝完成不代表已有可用的代理服務。通常需要匯入自行準備的 YAML 設定,或向服務提供者取得訂閱連結,再到設定頁下載並啟用。只有規則、沒有可用代理項目的檔案,無法憑空建立遠端連線。匯入後先確認已選取該設定,再到代理頁查看策略組中是否有可選項目。訂閱屬於敏感資訊,分享截圖時請遮住完整連結、使用者識別資訊與存取參數。

規則、全域與直連模式各適用於哪些情況?

規則模式依照設定中的規則順序選擇策略,適合日常依網域、位址或地區分流;全域模式通常會將進入核心的連線交由全域策略組處理;直連模式則讓進入核心的連線直接連往目標。全域模式不代表接管裝置上的所有流量,應用程式仍須透過系統代理或 TUN 等入口進入核心。遇到特定網站異常時,可暫時切換至全域模式進行比對測試,再切回規則模式。若全域模式可用、規則模式不可用,應優先檢查命中的規則與策略組。

系統代理和 TUN 模式需要同時啟用嗎?

不一定。系統代理會將代理位址寫入作業系統設定,主要影響會讀取該設定的應用程式;TUN 則透過虛擬網卡與路由接管符合條件的網路流量,常用於不讀取系統代理的程式。初次設定建議先只啟用系統代理,確認訂閱、策略組與連線正常後,再視需要測試 TUN。部分用戶端支援同時啟用兩者,但不應把雙開當成解決所有問題的方法。若同時執行其他 VPN 或代理工具,請先停用其中一個,避免路由與 DNS 設定互相覆蓋。

相關操作:系統代理設定步驟 →

訂閱、連接埠與權限

安裝設定

依序完成匯入、啟用、選擇策略與接入流量。修改前請先保留可用設定。

訂閱連結要貼在哪裡?匯入後還要做什麼?

開啟用戶端的設定頁,找到新增設定、遠端設定或匯入訂閱的入口,將服務提供者給的完整網址貼到 URL 欄位並確認匯入。下載成功後,還須啟用或選取該設定,再前往代理頁選擇策略組中的可用代理。最後到設定頁啟用系統代理,並用瀏覽器開啟目標網站確認連線。不同用戶端的按鈕名稱可能略有差異;若要匯入本機 YAML 檔案,請選擇檔案匯入,不要將檔案路徑填入訂閱網址欄位。

訂閱更新失敗或設定解析錯誤,該先檢查什麼?

先在設定頁手動更新一次,並查看同一時間的記錄。若要求逾時,請檢查目前網路,以及更新訂閱時使用的代理路徑;若出現 401、403 等回應,請向服務提供者確認連結權限與有效期限;若回傳的是網頁或登入頁,則不能當成 YAML 設定匯入。若記錄指出特定行號,再檢查縮排、冒號後的空格、重複欄位,以及核心不支援的設定項目。不要連續更改多個設定來掩蓋原始錯誤,也不要公開含有完整訂閱網址的記錄。

混合連接埠 7890 被占用,該怎麼修改?

7890 是常見的混合連接埠範例,實際值請以用戶端設定或生效設定中的 mixed-port 為準。記錄顯示位址已被占用時,先關閉其他代理用戶端,確認是否有舊程序仍在背景執行;若仍有衝突,可將混合連接埠改成未被占用的本機連接埠並套用設定。接著同步修改瀏覽器擴充功能、終端機環境變數,以及其他手動填寫的代理位址。不要只修改設定檔,卻保留應用程式中的舊連接埠;也請回到系統設定確認自動系統代理是否已同步更新。

啟用 TUN 時顯示權限不足或建立虛擬網卡失敗,該怎麼辦?

先確認用戶端提供的服務模式是否已安裝並啟動。Windows 通常需要授權安裝服務,或以系統管理員權限完成相關操作;macOS 可能需要在系統設定中核准網路延伸功能或輔助服務,實際情況視用戶端實作而定。記下記錄中有關權限、驅動程式或建立網卡的原始錯誤,再依照該用戶端的說明修復服務。不要反覆安裝來源不明的驅動程式。若裝置受到組織管理政策限制,請聯絡管理員;修復前可先關閉 TUN,使用系統代理確認基本連線是否正常。

相關操作:訂閱匯入教學 →

策略與本機設定

使用技巧

以連線頁顯示的實際命中結果為準,不要把測速結果當成完整的可用性驗證。

測速有結果,為什麼網頁還是打不開?

測速通常只會連線到設定中指定的測試網址,探測成功不代表所有網站、協定或 DNS 要求都能正常使用。先確認目前策略組實際選用了哪個代理,再開啟一個明確使用 HTTPS 的網站,並查看連線頁。檢查目標網域命中了哪條規則、最後使用哪個策略,以及記錄中是否出現解析失敗或連線重設。必要時可更換代理比對,但每次只修改一項。若只有瀏覽器無法連線,其他應用程式正常,還應檢查瀏覽器擴充功能、自訂代理與安全 DNS 設定。

如何讓特定網站固定直連或固定使用代理?

優先使用用戶端提供的本機規則或覆寫入口,在較廣泛的規則與最後的 MATCH 規則之前加入目標網域規則。DOMAIN 用於比對完整網域;DOMAIN-SUFFIX 可涵蓋指定網域及其子網域。規則末尾的策略名稱必須與目前設定中的策略組名稱一致。儲存並套用後,重新建立一次連線,再到連線頁確認命中結果。網頁可能還會載入其他資源網域,必要時請逐一補上。直接編輯遠端訂閱產生的檔案,可能會在下次更新時被覆蓋。

如何讓手機或其他電腦使用這台電腦的代理?

在用戶端設定中啟用允許區域網路連線,確認監聽位址不限於 127.0.0.1,並記下電腦的區域網路位址與實際混合連接埠。其他裝置應填入這台電腦的區域網路位址,而不是自己的回環位址;兩台裝置也必須能互相連線。若連線失敗,請檢查主機防火牆、訪客網路隔離及無線基地台隔離設定。只在可信任的區域網路中開放,視需要設定驗證並限制存取範圍,切勿將代理連接埠轉送至公網。電腦進入睡眠或位址變更後,其他裝置也會中斷連線。

更新訂閱後,手動修改的規則為什麼不見了?

遠端訂閱更新通常會重新產生設定,直接寫入下載檔案的規則、DNS 與策略組設定可能因此被覆蓋。請先備份可用設定,再使用用戶端支援的本機覆寫、設定合併或指令碼擴充入口,保存個人化設定。不同用戶端的合併順序各異,新增規則也不一定會自動排在 MATCH 前面,因此套用後必須查看最終生效的設定並確認命中結果。若同時啟用了多個覆寫來源,請逐一停用並比對,避免同一欄位在不同位置重複定義或互相取代。

設定參考:規則與分流設定 →

由流量入口逐層檢查至遠端

故障排查

先保留錯誤發生時的記錄與設定,再逐項比對。涉及系統權限時,不建議直接關閉安全防護。

系統代理已啟用,但瀏覽器或終端機仍未走代理,該怎麼辦?

先確認系統代理的位址與連接埠指向目前的用戶端,並確認核心正在執行、設定已啟用。瀏覽器擴充功能可能會覆蓋系統代理;部分終端機工具只讀取 HTTP_PROXY、HTTPS_PROXY 或自身的代理參數,需另外設定。連線至目標網址時,請觀察用戶端的連線頁:若沒有對應連線,通常應先檢查流量入口;若有連線但策略不正確,再檢查規則。排查時暫時關閉其他代理軟體,並檢查系統的代理略過清單,避免排除目標網域或整個位址範圍。

Windows 市集等 UWP 應用程式無法使用系統代理,該怎麼辦?

部分使用 AppContainer 隔離的 UWP 應用程式預設無法存取本機回環位址,因此即使瀏覽器正常,市集或郵件應用程式仍可能無法連線。若用戶端提供 UWP 回環豁免工具,可依提示以系統管理員權限開啟,只為確實需要的應用程式啟用豁免,然後完全關閉並重新開啟應用程式。熟悉 Windows 的使用者也可使用 CheckNetIsolation 管理豁免清單,不應直接批次放行所有應用程式。若啟用豁免後,連線已進入核心但仍失敗,請繼續檢查規則、DNS 與應用程式本身的服務狀態。

節點持續逾時或突然無法上網,如何判斷故障位置?

先關閉代理,確認基本網路能否連上原本可直連的服務;若同樣無法連線,應先處理無線網路、閘道或網路驗證問題。基本網路正常後,啟用設定並分別測試兩個可選代理,查看記錄中的網域解析、交握及連線逾時資訊。若只有單一代理失敗,重點檢查遠端服務狀態;若全部失敗,再確認訂閱是否有效、系統時間是否正確、出口網路是否受限,以及是否與其他 VPN 衝突。不要只憑測速逾時就認定設定損毀;測試網址本身無法連線,也會導致探測失敗。

啟用 TUN 或 Fake-IP 後出現 DNS 異常,該如何檢查?

先分辨是網域無法解析,還是網域已解析但連線失敗,再查看最終生效的 DNS 設定。Fake-IP 回傳對應位址是預期行為,不能只因解析結果不是公網位址就判定故障。請確認 DNS 要求是否進入預期的解析流程、直連與代理的解析路徑是否可用,以及瀏覽器安全 DNS 是否繞過用戶端設定。修改後請關閉並重新建立測試連線,必要時清除系統與瀏覽器快取。若區域網路服務不相容,可視需要設定 Fake-IP 過濾規則;不要一次更換所有 DNS 與 TUN 參數。

進階參考:DNS 設定 · TUN 與 Fake-IP