說明中心 · 操作與故障排除

Clash 常見問題

訂閱匯入、設定載入、流量接管與連線排查。先確認問題發生在哪個環節,再逐項檢查,避免同時變更連接埠、DNS 與路由。

以下操作位置以常見用戶端為例,實際名稱請以目前介面為準。點選問題即可展開答案;分類導覽可直接前往對應章節。

基礎認識

先區分訂閱、核心與用戶端,再決定使用哪種代理模式。

Clash 用戶端、mihomo 核心和訂閱各自負責什麼?

用戶端負責管理訂閱、切換模式及整合系統;核心負責解析設定、比對規則並建立連線。mihomo 是延續 Clash Meta 發展的核心專案,介面名稱不一定和核心名稱相同。訂閱則是遠端設定來源,通常由服務提供者維護。安裝用戶端不會自動取得可用訂閱;遇到問題時,應先確認是介面操作、核心錯誤還是訂閱內容異常。

訂閱連結和本機 YAML 設定檔有什麼差別?

訂閱連結用來重新取得遠端內容,本機 YAML 則是儲存在裝置上的設定快照。遠端訂閱更新後,可能會取代原有的代理項目、代理群組或規則;本機檔案通常需要手動修改或重新匯入。有些連結只會傳回代理項目,必須以代理提供者的方式加入完整設定,不能直接當成完整 Profile 使用。匯入前請確認用戶端要求的格式,並保留目前可正常使用的設定副本。

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

日常使用通常先選規則模式,讓連線依目前設定的規則進入對應策略。全域模式會將進入核心的連線交由全域策略群組處理,仍須在該群組選擇可用出口;直連模式則讓進入核心的連線直接連到目標。模式只會影響已由用戶端接管的流量,不代表裝置上的所有應用程式都已接入。排查時可暫時切換到全域模式作為對照,確認後再切回規則模式,避免把規則問題誤認為節點故障。

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

系統代理會向作業系統登記 HTTP 或 SOCKS 代理入口,主要供遵循此設定的應用程式使用。TUN 模式則透過虛擬網路介面接管符合路由條件的流量,較適合不讀取系統代理設定的程式,但需要相應權限、路由及 DNS 配合。初次設定建議先只啟用系統代理進行驗證,再依實際需求測試 TUN。部分用戶端允許同時啟用兩者,但並非必要;排查時應分開測試,減少變因。

Clash Fake-IP 是什麼?為什麼 DNS 查詢結果不是目標的真實位址?

Fake-IP 模式會回傳設定位址池中的映射位址給應用程式,核心再依據映射記錄辨識網域並處理連線,因此 DNS 查詢結果可能不是目標的真實位址。這不代表解析失敗。少數區域網路服務或依賴真實位址的程式可能不相容,應針對相關網域設定例外,而不是直接擴大排除範圍。變更 DNS 模式後,請依用戶端要求重新載入,並處理系統與應用程式保留的舊 DNS 快取。

安裝設定

從成功匯入到核心順利載入,設定狀態與執行記錄都需要分別確認。

匯入訂閱後,為什麼沒有代理群組,或仍在使用舊設定?

先到設定或訂閱頁面確認新項目已成功下載,再選取、啟用或設為目前使用的設定;不同用戶端的按鈕名稱可能不同。儲存訂閱網址不代表核心已載入該設定。接著查看載入記錄與代理群組頁面。如果下載成功卻沒有代理群組,請確認內容是否只有代理項目,或格式是否與用戶端不相容。先保留舊設定,不要連續重複匯入相同網址,以免搞不清楚目前啟用的是哪個項目。

訂閱更新失敗或訂閱連結失效,應依什麼順序檢查?

先確認裝置時間、一般網路連線及訂閱網址是否完整,尤其留意複製時是否帶入空格或換行。接著查看更新記錄:401 或 403 通常與授權或存取策略有關,404 可能表示網址已失效,逾時則需檢查連線路徑。狀態碼只能作為線索,請以服務提供者的說明為準。如果用戶端支援透過代理下載訂閱,可分別測試直連與現有的可用代理;仍失敗時,請向服務提供者確認連結狀態,切勿公開包含憑證的完整網址。

設定解析失敗,顯示未知欄位或不支援的代理類型,該怎麼辦?

先記下記錄指出的欄位、代理類型與行號,再確認用戶端實際執行的核心及版本。較新的設定可能使用舊核心不支援的協定或參數;介面更新也不代表核心一定同步更新。若是手動編輯,請檢查 YAML 縮排、冒號後的空格與清單層級,並避免使用定位字元。優先請訂閱提供者輸出相容格式,或改用支援該設定的用戶端;不要未經確認就刪除錯誤欄位並直接覆寫原檔。

TUN 模式無法啟用,該檢查哪些權限和服務?

先確認用戶端是否要求安裝或啟動服務模式,並透過作業系統的正常授權流程授予所需權限。Windows 通常需確認背景服務狀態;macOS 請留意系統授權提示;Linux 則應查看用戶端文件中的權限與虛擬介面要求。接著檢查記錄是否出現權限不足、介面建立失敗或路由衝突。不要把長期以最高權限執行當成通用解法;請先關閉其他 VPN 或 TUN 程式,再依用戶端文件修復服務。

更換用戶端時,如何移轉訂閱和本機設定?

移轉前分別備份訂閱來源、本機 YAML 與用戶端覆寫內容,必要時記下代理群組選擇和連接埠設定。先退出舊用戶端並關閉其系統代理與 TUN,再將副本匯入新用戶端,確認使用的核心支援設定中的協定與欄位。不要直接複製整個應用程式資料夾,因為介面設定和資料庫格式可能不同。新用戶端完成設定載入、連線測試與重新啟動驗證後,再決定是否移除舊程式和舊設定。

使用技巧

將長期設定與遠端訂閱分開保存,並以實際連線驗證修改結果。

如何安排訂閱自動更新,避免覆蓋本機修改?

到訂閱項目的設定中查看自動更新開關與更新間隔,依服務提供者建議安排頻率;過於頻繁的請求可能觸發存取限制。遠端訂閱通常會重新下載內容,因此直接編輯下載檔案可能遭到取代。需要長期保留的規則或 DNS 調整,應優先放進用戶端支援的覆寫、合併或延伸設定中。更新後請檢查最終生效的設定與記錄,確認自訂內容仍存在,而不只是查看編輯頁面。

代理群組中的手動選擇和自動選擇有什麼差別?

手動選擇群組通常對應 select,由使用者指定目前的出口;自動測試群組通常對應 url-test,依照設定中的測試網址、間隔與容差選擇。fallback 著重依序使用可用出口,不能簡單理解成永遠選擇最快的線路。測試結果反映的是對指定網址的探測情況,不等於所有服務的實際使用體驗。切換後應以新建立的連線進行驗證,既有的長連線可能仍會使用先前的出口。

區域網路中的裝置如何使用同一台電腦上的 Clash?

先在用戶端確認已允許區域網路連線,並檢查監聽位址與混合連接埠設定,再讓同一個可信任網路中的裝置填入電腦的區域網路位址和對應連接埠。也要檢查系統防火牆是否允許來自該網路的連線。只開啟區域網路監聽,不會自動讓其他裝置使用代理;需要在要連線的裝置上設定代理,或採用明確的閘道方案。不要將代理連接埠暴露於公網;使用完畢後,請視需要關閉區域網路存取並移除防火牆例外。

終端機和命令列工具為什麼沒有使用系統代理?

許多命令列程式只讀取自身參數或 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 等環境變數,不會讀取桌面系統的代理設定。先確認用戶端的本機監聽位址與連接埠,再查閱所用工具支援的變數、代理協定與大小寫慣例;HTTPS_PROXY 的值也不一定要使用 https 協定標頭。建議先在目前的終端機工作階段測試,不要立刻寫入全域啟動檔。測試結束後移除暫時設定的變數,避免用戶端退出後,終端機仍指向舊連接埠。

排查問題時應提供哪些記錄?如何隱藏敏感資訊?

記下作業系統、用戶端名稱、核心版本、錯誤時間與重現步驟,再截取該時段的載入或連線錯誤即可。分享前請刪除完整訂閱網址、存取權杖、帳號密碼、私人網域及其他可識別資訊。可暫時提高記錄層級以定位問題,完成後再恢復常用層級。不要直接上傳整個設定資料夾或未經檢查的診斷壓縮檔;若需展示 YAML,請保留欄位結構,並將敏感值改為明確的示範假資料。

故障排除

先確認基本網路可用,再區分流量未接管、規則比對錯誤與出口連線失敗。

節點連線逾時,如何區分網路、節點和 DNS 問題?

先關閉代理,確認基本網路可用,再檢查訂閱是否更新成功,以及目前代理群組是否選到有效出口。使用同一出口連線不同目標,情況允許時也可更換網路交叉比對。若記錄顯示網域名稱解析失敗,應先檢查 DNS;若連線在建立階段逾時,則檢查節點位址、連接埠與連線路徑。內建測試只代表測試目標的結果,單一節點逾時也不表示所有訂閱都失效;不建議一開始就重設所有設定。

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

先核對作業系統登記的代理位址與連接埠,是否和用戶端實際監聽值一致,並確認核心正在正常執行。接著檢查瀏覽器代理擴充功能、個別代理設定、PAC 與略過清單,必要時以臨時瀏覽器設定檔交叉比對。開啟用戶端的連線記錄並發出新請求:若完全沒有記錄,優先檢查流量接管路徑;若有記錄卻走直連,再檢查命中的規則。不要只根據網頁能否開啟判斷代理是否生效,也不要同時修改所有 DNS 與路由設定。

瀏覽器可以連線,但 Microsoft Store 等 UWP 應用程式無法連線,該怎麼辦?

部分採用 AppContainer 隔離的 Windows 應用程式無法直接存取本機回送代理,因此可能出現瀏覽器正常、特定應用程式無法連線的情況。先確認受影響的應用程式確實使用本機代理,再查看用戶端是否提供 UWP 回送或回送豁免工具。只為需要的應用程式設定豁免,並依工具要求授權;也可參考 Microsoft 文件,使用 CheckNetIsolation 檢查。並非所有 Microsoft Store 應用程式都受到相同限制;若問題仍在,還需檢查帳戶、系統網路與防火牆。

啟用 TUN 後,區域網路、印表機或公司 VPN 無法連線,該怎麼辦?

先關閉 TUN 進行比對,確認問題是否確實與虛擬介面或路由接管有關。接著檢查其他 VPN、虛擬機網路或安全軟體是否也修改了路由,並確認目標服務是否依賴區域網路探索或專用 DNS。確有需要時,請依所用核心與用戶端文件,為特定網段、介面或網域設定略過;不要一次排除過大的位址範圍。每次只調整一項並進行測試;工作網路的設定應先遵循網路管理員的要求。

退出用戶端後,整台裝置都無法上網,該如何恢復?

先確認作業系統是否仍保留指向本機連接埠的手動代理或 PAC 位址,並關閉已失效的代理設定。若先前啟用了 TUN,可重新啟動原用戶端,先關閉 TUN 與系統代理,再正常退出,讓程式執行清理。接著檢查其他 VPN、終端機代理變數與 DNS 設定是否仍在生效。不要直接刪除網路介面卡或重設所有網路;若基本網路仍異常,請依據系統診斷結果處理,並保留修改前的設定記錄。

下載用戶端