Clash / mihomo · 問題索引
Clash 常見問題
設定與連線疑難排解
依序檢查訂閱、流量入口、規則與出站。先找出問題所在的環節,再調整設定;每次只改一項,並保留可還原的原始設定。
基礎認識
先分清用戶端、核心與服務設定,避免把安裝完成誤當成已成功連線。
Clash、mihomo 與用戶端分別負責什麼?
Clash 通常指代理核心及其設定生態系,mihomo 是這個生態系中持續發展的核心專案。Clash Verge Rev、FlClash 等用戶端提供設定匯入、策略選擇與系統整合介面,實際流量則由核心處理。同一份設定能否匯入,取決於用戶端內建的核心版本及其支援的欄位,不能只看應用程式名稱。回報相容性問題時,請一併記錄用戶端名稱、用戶端版本與核心版本。
安裝用戶端後,為什麼還需要訂閱或設定?
用戶端具備流量接管與規則執行功能,但安裝程式本身並不等於可用的代理服務。實際連線通常需要服務提供者提供的訂閱連結,或自行維護的代理伺服器參數。匯入後,請先確認設定已啟用,再檢查策略組是否有可選的出站。不要把一般網站網址當成訂閱網址,也不要將訂閱連結貼到來源不明的線上轉換頁面;連結可能含有可存取帳戶資源的憑證。
規則模式、全域模式和直連模式有什麼差異?
規則模式會依設定中的規則順序決定出站,適合日常區分不同網站和應用程式的流量。全域模式會將交由核心處理的連線統一交由全域策略選擇,但無法保證未被接管的應用程式也會走代理。直連模式則讓交由核心處理的連線直接連至目標。疑難排解時可暫時切換到全域模式作為對照,測試後記得還原原模式;若全域模式可用、規則模式不可用,通常要檢查規則是否命中及對應的策略組。
系統代理和 TUN 模式需要同時啟用嗎?
系統代理會向遵循系統設定的應用程式提供代理位址;TUN 則透過虛擬網路介面與路由接管更多連線。兩者不必同時啟用,功能也不完全相同。初次設定建議先只啟用系統代理,確認瀏覽器能正常連線後,再視遊戲、命令列或其他應用程式的需求嘗試 TUN。部分用戶端允許兩者並用,但發生異常時應一次只保留一種接管方式,避免與其他 VPN 或代理工具疊加,增加判斷難度。
Clash 免費節點可以長期使用嗎?
公開分享的代理出站可能隨時失效,其營運者、流量政策與維護週期往往難以確認,不適合作為長期穩定使用的依據。代理也無法取代網站本身的加密保護;登入敏感帳戶時,請確認 HTTPS 正常,並拒絕安裝來路不明的憑證。遇到連線失敗,先判斷是單一出站失效,還是本機接管異常;不要為了更換出站而反覆安裝陌生用戶端。使用網路服務時,也請遵守所在地法律與服務條款。
安裝設定
先確認訂閱有效、設定可載入,再檢查權限與監聽連接埠。設定未能成功啟動時,切換策略通常無法解決問題。
訂閱失效、更新失敗或回應 403,該怎麼處理?
先前往服務提供者的帳戶頁面,確認訂閱是否到期、連結是否已重設,再檢查複製時是否多了空格或漏掉查詢參數。403 通常表示請求遭拒,也可能與存取政策或用戶端識別資訊有關,請參照提供者的說明判斷。若只有透過代理更新才失敗,可在用戶端支援的情況下嘗試直連更新;若直連無法存取,再改用已確認可用的出站。問題仍未解決時,記下狀態碼與時間並聯絡提供者,切勿公開完整訂閱連結。
匯入設定時出現 YAML 錯誤或欄位不支援,該怎麼辦?
先確認是檔案格式錯誤,還是核心相容性問題。YAML 依賴縮排層級,請使用空格而非定位字元,並檢查冒號、清單連字號與引號是否成對。若日誌指出無法識別某個欄位,請確認設定所需的核心類型與目前核心版本;從網頁下載到的登入頁或錯誤頁也不能當成設定檔匯入。修改前先保留原始檔,每次只調整一處再重新驗證。訂閱產生的設定,建議優先透過用戶端的覆寫功能修改,避免更新時變更遺失。
TUN 啟用失敗,提示權限不足或服務未安裝,該怎麼辦?
先確認目前的用戶端與作業系統支援所選的 TUN 實作方式。Windows 用戶端通常需要安裝並啟動其提供的服務模式;macOS 可能需要依系統提示授權輔助服務;Linux 則應依用戶端文件設定虛擬介面與路由所需的權限。不要直接替所有程式授予高權限。完成授權後重新啟動核心,再確認介面是否成功建立;若仍失敗,關閉其他 VPN 後重試,並記錄建立介面或新增路由時的原始錯誤訊息。
系統代理已啟用,瀏覽器卻沒有走代理,該怎麼辦?
檢查系統代理位址是否指向本機、連接埠是否與目前設定的監聽連接埠一致,並確認核心正在執行。瀏覽器擴充功能、自訂代理設定與組織政策可能覆蓋系統設定,請先停用衝突項目再測試。開啟用戶端的連線記錄:若瀏覽網站時沒有新增連線,應著重檢查流量入口;若已有記錄卻選擇直連,則檢查模式與規則。不要只根據出口查詢頁面判斷故障,快取、網站分流與瀏覽器行為都可能影響結果。
連接埠被占用,或終端機不使用系統代理,該如何設定?
連接埠被占用時,先關閉重複啟動的用戶端,或找出占用的程序,再為 mixed-port 選擇未使用的連接埠,同時更新應用程式中的代理位址。HTTP 代理與 SOCKS 代理不能任意混用,請依應用程式支援的協定填寫。終端機工具不一定會讀取系統代理,可能需要另外設定 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。疑難排解時先採用暫時設定,確認生效後再決定是否保留;關閉用戶端前,也要清除不再需要的環境變數。
使用技巧
透過實際連線記錄驗證變更,並區分新舊連線、設定更新與網路環境變化。
策略組已切換,為什麼正在播放的影片沒有變化?
多數策略切換會先影響新建立的連線,既有連線可能繼續使用原本的出站。可以暫停播放、關閉相關網頁後重新開啟,或只在用戶端的連線面板中關閉相關連線,再查看新記錄的策略鏈。也要確認目標流量確實命中剛修改的策略組;部分設定會將影片、下載和其他流量分配到不同群組。不要把關閉所有連線當成日常操作,以免中斷檔案傳輸、會議或其他進行中的工作。
如何確認規則是否如預期命中?
在連線記錄中依目標網域或應用程式尋找剛發出的請求,查看命中的規則、策略組與最終出站。規則通常由上而下比對;較寬泛的規則若排在前面,可能會優先套用,蓋過後面的精確規則。調整前先記下目標網域與目前的命中結果,再將必要的精確規則放到適當位置。MATCH 通常作為最後的兜底規則。若涉及 GEOSITE 或規則集,也要確認相關資料檔與 rule-providers 是否成功載入。
手動修改的規則為什麼在訂閱更新後消失?
直接編輯訂閱產生的檔案,下次更新時可能會被遠端內容覆蓋。需要長期保留的規則,應使用用戶端提供的覆寫、合併或腳本擴充功能,並確認執行順序;不同用戶端的功能入口與合併機制各不相同。儲存前先匯出備份,更新後檢查最終生效的設定,而不只是查看編輯器中的文字。新增規則引用的策略組必須確實存在,否則可能導致載入失敗或出站參照錯誤。
節點延遲正常,為什麼下載和影片還是很慢?
延遲測試通常只反映單次請求的往返狀況,無法代表持續頻寬、壅塞程度或特定網站的存取品質。先固定同一個下載目標,比較直連與不同出站,再檢查本機無線網路、背景下載和伺服器限速。若只有某個網站很慢,請查看該網站實際命中的出站與解析位址,不要只比較測試按鈕的結果。疑難排解時保持測試條件一致,避免同時更換 DNS、模式和節點,以免無法判斷是哪項設定造成影響。
使用公共 Wi-Fi 後,需要重新匯入訂閱嗎?
通常不需要。飯店、校園或交通場站的網路可能要求先完成網頁登入認證,而代理或 TUN 可能影響認證頁面開啟。先暫時關閉流量接管,完成網路認證並確認一般網頁可以瀏覽,再恢復原有設定。若切換網路後部分連線仍異常,可重新建立相關連線並檢查 DNS 狀態。不要因為切換一次網路就刪除原有設定;只有帳戶連結確實失效,或服務提供者明確要求更換時,才重新匯入訂閱。
疑難排解
先確認故障範圍,再檢查錯誤類型。瀏覽器可用但單一應用程式失敗,與所有應用程式都無法連線,需要採取不同的檢查方式。
節點持續逾時,應依什麼順序排查?
先關閉代理,確認基本網路可用;再確認訂閱更新正常、帳戶狀態有效,以及裝置日期與時間正確。接著選擇另一個出站連線到相同目標:若只有單一出站失敗,優先聯絡服務提供者;若所有出站都失敗,再檢查防火牆、代理連接埠與其他 VPN 是否衝突。最後依據日誌判斷是連線伺服器逾時、網域解析失敗,還是目標網站拒絕連線。不要反覆測速取代問題定位,也別把所有逾時都歸咎於用戶端。
日誌出現 DNS 解析失敗或 fake-ip 相關異常,該怎麼辦?
先檢查設定中的 DNS 上游是否可連線,以及連線至代理伺服器所需的網域是否能解析,避免解析請求依賴尚未建立的代理而形成循環。若只有個別應用程式異常,確認該應用程式是否使用內建的加密 DNS、是否快取舊位址,以及是否與 fake-ip 相容。調整後,依用戶端提供的方法清除 DNS 快取並重新建立連線。不要任意疊加多種 DNS 劫持工具;切換 DNS 模式前應先備份原有設定,並確認 TUN 路由是否也隨之變更。
Windows UWP 應用程式無法連線,該如何檢查本機迴圈例外?
部分採用 AppContainer 隔離的應用程式,預設無法存取本機迴圈位址;即使瀏覽器可用,也可能無法連線至本機代理。先確認該應用程式是否屬於這種情況,再使用用戶端提供的 UWP 迴圈例外功能,只替需要的應用程式新增許可。管理員可使用系統命令 CheckNetIsolation LoopbackExempt -s 查看現有例外。這個問題並非所有 Microsoft Store 應用程式都會遇到;若已新增許可仍無法使用,請繼續確認應用程式是否讀取系統代理,以及連線是否進入核心。
退出用戶端後網路中斷,該如何恢復?
先檢查系統是否仍保留指向本機的手動代理;若核心已停止,該位址便無法提供服務。請關閉殘留代理,或重新啟動用戶端後正常停止流量接管。若先前使用 TUN,再確認虛擬介面、路由與 DNS 是否已還原,必要時使用用戶端的修復功能處理,然後重新連線網路。企業網路可能原本就需要指定代理,變更前請記錄原始設定。重設所有網路設定應列為最後手段,以免遺失既有 VPN、靜態位址或公司網路設定。
如何提供有用的日誌,同時避免洩漏訂閱資訊?
先記錄作業系統、用戶端與核心版本、使用的模式及問題發生時間,再重現一次並截取前後相關日誌。暫時提高日誌層級後,應儘快恢復原設定,避免長期記錄過多瀏覽細節。提交前刪除訂閱網址、認證參數、伺服器憑證,以及不希望公開的網域或 IP;必要時只保留錯誤類型與規則鏈。設定範例只提供重現問題所需的最小片段,並註明已刪減的內容。若訂閱連結曾公開,應向服務提供者重設連結,而不只是刪除貼文。