Clash Meta
故障排除指南
依症狀追查連線路徑。先確認本機連接埠,再檢查規則、DNS 與遠端連線;每次只修改一個變數。
首次安裝與匯入訂閱,請依照入門指南操作。本頁適用於已完成設定但出現異常的情況,可依章節查閱;問題排除後,可回到教學繼續測試連線。不同用戶端的選單名稱可能不同,文中的「設定檔、連線、日誌、設定」皆指相應功能區,實際運作設定與核心日誌才是判斷依據。
無法上網:從本機連線入口開始檢查
先分辨原始網路與代理連線
先中斷用戶端連線、關閉系統代理,並確認 TUN 已停用,再嘗試瀏覽原本可直接連線的網站。若仍無法開啟,請優先檢查 Wi-Fi 登入驗證、網路線、路由器與系統網路狀態,先不要繼續修改規則。飯店和校園網路可能需要先透過網頁完成驗證;驗證尚未完成時,即使代理伺服器正常也無法建立連線。原始網路恢復後,重新啟動用戶端,只載入一份已知可用的設定檔。
如果結束用戶端後整個網路都中斷,請檢查系統是否仍保留指向本機的代理位址。監聽程式已停止,但應用程式仍向該位址送出要求時,就會持續收到連線遭拒的錯誤。Windows 請到「設定 → 網路和網際網路 → Proxy」檢查手動 Proxy;macOS 請到目前網路服務的「詳細資訊 → Proxy」檢查。調整前先記下原設定;企業裝置的自動設定網址可能由管理政策提供,請勿直接清除。
確認核心已啟動並監聽連接埠
開啟用戶端日誌,從最近一次啟動的位置往下查看。設定解析失敗、連接埠遭占用或權限不足,都可能讓介面看似已啟動,核心卻沒有提供代理服務。若出現 address already in use,請檢查是否啟動了第二個用戶端,或有殘留的核心程序。不要只把連接埠改成其他數字:若系統代理與終端機環境變數仍使用舊連接埠,問題只會從連接埠衝突變成連線入口不一致。
mixed-port 是 HTTP 與 SOCKS 共用的本機入口,不是節點伺服器連接埠。以下片段僅供比對現有設定,不能取代完整訂閱。確認執行連接埠為 7890 後,再使用明確指定代理的指令測試;若實際連接埠不同,指令中的位址也要一併修改。請選擇原始網路可連線的網站測試,先確認本機入口正常,避免把目標網站本身的限制混為一談。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
curl -I --connect-timeout 10 --max-time 20 --proxy http://127.0.0.1:7890 https://example.com
透過連線記錄找出中斷位置
如果指令一開始就顯示無法連線至本機,代表入口沒有在監聽,或遭本機安全政策阻擋;若進入連線記錄後才失敗,才繼續追查規則與出口。在 Windows PowerShell 中建議明確使用 curl.exe,避免命令別名改變參數意義。只要收到有效的 HTTP 回應,就表示要求已到達某個 HTTP 服務;狀態碼不是成功碼,也不能直接據此認定代理未啟動。
在連線頁面篩選目標網域,核對套用的規則、策略群組與最終出口。規則會依序比對,前面的寬泛規則可能先於後面的精確規則生效。即使選取了策略群組,若群組內仍指向無法使用的代理,單純切換外層群組也無法恢復連線。可暫時切換至全域模式,手動指定同一個已知可用的出口作為對照;測試後請恢復規則模式,不要長期使用全域模式掩蓋錯誤分流。
明確指定代理後運作正常、瀏覽器卻無法連線,請查看系統代理章節;日誌出現網域解析錯誤,請查看DNS 章節;只有某個出口失敗,請查看節點逾時章節。每次測試都記下目標、模式、出口與結果,避免在不同網站及節點間反覆切換,失去可比較的條件。
節點逾時:分別檢查解析、連線與交握
延遲測試失敗,不代表所有連線都失敗
用戶端的延遲測試通常會透過指定代理向測試網址送出要求,反映的是該次測試結果,並非單純確認伺服器連接埠是否連通。測試網址無法連線、回應狀態不符預期,或伺服器限制頻繁探測,都可能顯示逾時。請先透過同一出口開啟實際需要的網站並查看連線日誌;若網站正常,應檢查測試網址與測試間隔,不要立即刪除訂閱。
請區分單一出口、同一服務商的所有出口,以及所有服務商的出口三種範圍。只有一個出口失敗時,優先檢查該伺服器與參數;一整組同時失敗,請檢查帳號狀態、訂閱更新及伺服器維護情況;所有出口都失敗,則回頭檢查本機網路、DNS、時間與防火牆。可用手機熱點對照不同的網路連線,但切換網路後必須重新建立連線;舊連線的失敗結果不能代表新網路。
依錯誤發生階段判讀日誌
lookup 或 no such host 通常表示伺服器網域解析有問題;connection refused 表示目標主動拒絕連線,常見原因是連接埠未監聽或伺服器設定不符;連線逾時只代表在時限內未完成某個階段,不能據此斷定帳號失效。若日誌已進入 TLS 或通訊協定交握階段,接著檢查驗證資訊、SNI、傳輸方式與系統時間,不要繼續反覆更換 DNS。
| 日誌線索 | 優先核對項目 | 不要直接推論 |
|---|---|---|
| 伺服器網域解析失敗 | 節點網域解析器與直連網路 | 節點驗證資訊錯誤 |
| 連線遭拒 | 伺服器連接埠與監聽狀態 | 本機規則順序錯誤 |
| TLS 憑證錯誤 | 時間、憑證鏈、伺服器名稱 | 停用驗證就能修復 |
| 交握後連線中斷 | 通訊協定參數、驗證資訊、伺服器限制 | 延長逾時時間一定有效 |
手動維護代理時,請逐項核對 type、伺服器位址、連接埠、驗證資訊與傳輸層設定。TLS 的伺服器名稱不一定等於連線位址;WebSocket 的路徑與 Host 也不能任意互換。請以服務提供者給的 mihomo 設定為準,保留大小寫與欄位層級。訂閱轉換後若出現未知欄位或不支援的通訊協定,請檢查實際使用的核心,不要只憑用戶端名稱判斷支援能力。
分辨通訊協定支援度與網路限制
某些出口使用 UDP 傳輸,能瀏覽一般 TCP 網站,不代表該出口的傳輸通道正常。反過來說,TCP 代理正常但遊戲無法連線,也可能是因為應用程式使用 UDP、代理不支援該流量,或策略群組未採用預期的出口。請先用一般 HTTPS 要求建立基準,再單獨測試需要 UDP 的應用程式,避免用同一個延遲數值判斷兩種需求。
檢查系統日期、時區與自動校時狀態。時間偏差可能使憑證被判定為尚未生效或已過期。若只有特定 Wi-Fi 網路出現憑證錯誤,也要考慮驗證入口或網路檢查設備的影響。不要把 skip-cert-verify 當成通用解法;它會改變連線的信任界線,卻無法修正伺服器名稱、憑證鏈或驗證參數本身的問題。
向服務提供者回報時,請保留錯誤發生時間與時區、網路連線類型、通訊協定名稱及已移除敏感資訊的錯誤行。不要傳送完整訂閱、QR Code 或含有密碼的設定。如果更換網路後恢復,表示故障與網路連線路徑有關;若同一出口在多台裝置與不同網路上都失敗,才較有理由請服務端檢查。延長逾時時間只能用來確認回應較慢,無法讓未監聽的連接埠或錯誤的驗證資訊變得可用。
訂閱失敗:檢查要求與設定檔產生流程
分開檢查下載失敗與匯入失敗
訂閱更新會經過要求網址、接收回應、解析內容及產生執行設定等階段。先確認提示屬於網路錯誤、HTTP 狀態異常,還是 YAML 解析錯誤。網址無法連線與內容無法解析是兩回事:前者要檢查網路、網域與存取授權;後者則要檢查格式及用戶端相容性。原因未明前,不要連續新增相同訂閱,否則會出現多份名稱相似、更新狀態不同的設定檔,增加選錯的機會。
複製網址時請保留完整查詢參數,並確認通訊軟體沒有插入空格、換行或省略號。訂閱 URL 通常包含存取憑據,不應放進公開截圖、客服單或線上轉換網站。瀏覽器能開啟也不代表內容正確:登入頁面、驗證碼頁面與流量用盡提示都可能以網頁形式回傳。請在本機檢查回應類型與開頭內容,確認取得的是用戶端支援的設定,而不是 HTML。
根據回應判斷伺服器端或本機問題
HTTP 401 或 403 通常需要核對授權、帳號狀態與伺服器存取政策;404 可能表示網址失效或路徑複製不完整;429 表示要求過於頻繁,請停止手動重新整理並稍候。伺服器錯誤則應保留目前可用的設定檔,稍後再試或聯絡服務提供者。這些狀態無法只靠更換本機連接埠解決,也不應因一次更新失敗就刪除已快取的設定檔。
如果訂閱網址只能透過代理存取,而目前設定檔剛好沒有可用出口,就會形成更新依賴循環。先嘗試用戶端提供的直連更新或代理更新選項,並記下這次使用的連線方式;必要時改用可存取該網址的網路。在保留舊設定檔的情況下,可先選擇可用出口完成更新。不要為了下載訂閱,把尚未取得內容的同一份訂閱設為唯一網路入口。
核對 YAML 與最終合併結果
出現縮排錯誤時,先查看日誌中的行號及附近內容。YAML 使用空格表示層級,Tab、全形冒號及未成對的引號都可能造成解析失敗。欄位能解析不代表型別正確,例如把清單寫成字串,或將布林值放在錯誤層級,可能要到核心載入時才報錯。先復原最近一次手動修改,再逐段恢復,不要一次重寫整份檔案。
mode: rule
proxy-groups:
- name: 出口選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,出口選擇
上例僅用來檢查清單與縮排結構,只包含直連出口。實際訂閱中的代理群組名稱必須與規則引用完全一致,包括空格與大小寫。若日誌顯示找不到代理或策略群組,請檢查產生後的執行設定,而不只是原始訂閱檔案。用戶端下載後可能還會執行覆寫、合併或指令碼處理,問題也可能是這些後續處理步驟所造成。
proxy-providers 提供代理來源,rule-providers 提供規則集合,兩者的內容格式不同。規則提供者還要核對 behavior 與檔案內容:網域集合、IP 集合及 classical 規則不能只改一個欄位就混用。遠端資源的路徑也應分開設定,避免不同提供者寫入同一個快取檔案,導致更新後內容互相覆蓋。
依照「停用覆寫 → 更新原始訂閱 → 確認可載入 → 逐一恢復覆寫」的順序定位問題。更新成功後,檢查目前啟用的設定檔、代理群組成員與規則數量是否合理,並重新建立連線驗證。多裝置同步時尤其要區分訂閱來源與本機設定,連接埠與 TUN 權限不適合直接照搬,細節請參考多裝置設定同步比較。
網速慢:分辨頻寬、延遲與負載
先建立可重複比較的條件
網速慢可能是網頁初次載入久、影片緩衝、下載速度低或操作卡頓,四種情況不能用同一個標準判斷。先固定裝置、網路、目標與出口,再比較調整前後的結果。網頁首次開啟較慢、後續傳輸正常時,優先檢查 DNS、連線建立與交握;持續下載緩慢,才著重檢查可用頻寬、伺服器負載與目標網站限制。記下實際症狀,比反覆測試所有節點更有幫助。
先用可直接連線的資源確認本機網路基準,再透過代理存取同一資源;若目標必須經代理連線,則比較兩個可用出口。測試時暫停系統更新、雲端硬碟同步與其他大量傳輸工作,避免多台裝置共用頻寬造成誤判。Wi-Fi 訊號、路由器負載與行動網路壅塞都位於代理之前,換用戶端無法排除這一段的瓶頸。
延遲測試不等於傳輸速度排名
延遲較低的出口不一定有較高的傳輸速度,也不一定適用所有網站。自動選擇策略通常依據測試要求做決策,不會持續測量下載頻寬。如果只有一個網站很慢,請檢查該網站的 CDN、帳號限制及出口到目標的路徑;若所有目標都很慢,再查看網路連線與伺服器整體狀態。不要將單次大型檔案下載的結果套用到所有應用程式。
透過連線記錄確認實際流量經過的策略群組。規則雖選了自動群組,但自動群組內可能又引用另一個選擇群組;介面顯示的外層名稱不等於最終出口。修改策略後,既有的長連線可能仍沿用舊路徑,可關閉目標應用程式的連線,或只中斷相關連線後重試。重要下載或遠端工作階段進行中,不要直接清除所有連線,以免排查造成額外中斷。
檢查 DNS、通訊協定與 TUN 負擔
如果每次開啟新網域都會先停頓,請查看 DNS 要求是否多次逾時後才改用其他方式解析。上游伺服器不只愈多就一定愈快:其中一個無法連線、引導解析依賴設定錯誤,或查詢經過不穩定出口傳送,都可能拖慢新連線。先保留一條目前網路可用的解析路徑,確認基準後再依需求增加分流。快取只會影響重複查詢,無法取代正確的首次解析路徑。
瀏覽器可能優先嘗試 HTTP/3,但出口或目前網路的 UDP 路徑不穩定,最後回退至 TCP,使用者可能會感覺先卡住再恢復。可暫時關閉該應用程式的 QUIC 作為對照,但不宜把永久封鎖所有 UDP 當成最佳化方案,因為語音、遊戲與部分通訊協定都依賴 UDP。排查時也要查看連線類型與目標連接埠,確認緩慢的要求是否確實使用 UDP。
TUN 會接管更大範圍的流量,啟用後可能讓原本未經系統代理的背景流量也受到影響,或與安全軟體、其他 VPN 及虛擬網卡搶用路由。針對同一目標比較「明確指定 HTTP 代理」與「TUN 接管」的結果:前者正常、後者緩慢時,優先檢查路由與網路堆疊,不要急著更換訂閱。修改 stack 前,先確認目前核心與平台支援該設定,並記下原值以便還原。
小型要求正常、大型回應卻停滯時,可以懷疑路徑 MTU 或中間設備的行為,但仍應先排除目標限速與封包遺失。調整 MTU 必須針對實際隧道介面,並比較調整前後的結果;不要照抄任意數值套用到所有網卡。頻繁關閉防火牆也不是加速方法;請查看具體的封鎖事件,再只調整與用戶端相關的程式或介面規則。
排查結束後,請保留一組可重現的紀錄:相同目標、相同時段、兩個出口、兩種網路連線方式的結果,以及 TUN 是否啟用。若瓶頸穩定出現在特定伺服器路徑,將這些資訊提供給服務提供者更有幫助。沒有證據時,不應把清除快取、重新安裝軟體或增加並行連線數當成預設的提速步驟。
DNS 問題:檢查解析入口與出口路徑
先確認由哪個元件發起解析
DNS 故障不一定發生在核心。系統解析器、瀏覽器安全 DNS、應用程式內建解析器與 mihomo DNS 可能同時存在。先確認失敗的要求是否進入用戶端,再查看日誌中的解析錯誤。瀏覽器能開啟、終端機卻失敗,可能是兩者使用不同的解析路徑;終端機能解析、瀏覽器卻失敗,也可能是應用程式自己的加密 DNS 無法連線。只看單一查詢工具的結果,不能代表所有應用程式。
透過明確指定的 HTTP 代理以網域連線時,目標名稱通常可交由代理入口處理;SOCKS 則要分辨本機解析與遠端解析。以下指令使用 socks5h,將網域交由代理端解析,藉此與應用程式的本機解析進行比較。若指令正常、應用程式卻失敗,請繼續檢查應用程式的解析方式,不要立刻修改所有系統 DNS。指令中的連接埠必須與實際混合連接埠一致。
curl -I --connect-timeout 10 --max-time 20 --proxy socks5h://127.0.0.1:7890 https://example.com
了解 fake-ip 的正常運作方式
enhanced-mode: fake-ip 會為符合條件的網域回傳虛擬位址,由核心保留網域與連線之間的對應關係。看到 198.18.0.0/16 範圍內的位址,不應直接判定為 DNS 汙染。關鍵在於存取該位址的流量是否仍由同一個核心接管;應用程式取得虛擬位址後繞過代理,或核心重新啟動後仍沿用過期對應,才可能造成連線異常。
先關閉相關應用程式,再重新啟動核心,清除與這次問題相關的系統或應用程式 DNS 快取後重試。Windows 可使用 ipconfig /flushdns;其他系統則應依實際使用的解析服務處理。尚未確認快取來源前,不要刪除整個用戶端資料目錄。區域網路裝置、印表機或特定驗證網域發生相容性問題時,可評估針對性地過濾 fake-ip,而不是排除所有網域。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://1.1.1.1/dns-query
這只是 DNS 設定片段,上游位址必須能從目前網路連線。監聽 1053 不會自動讓系統使用該服務,也不會自行接管所有 DNS 要求;必須透過用戶端的接管機制,或明確指定解析入口。使用 nslookup example.com 127.0.0.1 檢查的是本機 53 連接埠,無法據此驗證上例的 1053。若系統已安裝 dig,可用下方指令指定連接埠。
dig @127.0.0.1 -p 1053 example.com A
避免引導解析與代理出口互相依賴
上游採用網域格式的 DoH 網址時,連上游之前必須先解析該網域;代理伺服器若也使用網域,還需要解析節點網域。請分清 default-nameserver 的引導解析用途,以及 proxy-server-nameserver 的代理節點網域解析用途。不要讓節點網域必須透過尚未建立的節點才能解析,也不要把所有解析要求都強制送入同一個尚未驗證的出口。
企業網域與家庭區域網路名稱可能只有內部 DNS 才能解析。設定公共上游後,這些名稱無法解析不代表公共 DNS 服務故障,而是查詢送到了沒有內部記錄的伺服器。請保留內部解析路徑,並透過適當的網域規則指定處理方式;同時檢查內部網段是否被錯誤送入代理。修改前記下原網路提供的 DNS,尤其不要覆蓋企業裝置上的管理設定。
判斷「DNS 洩漏」時,必須依預期的解析路徑一併檢查。測試頁面顯示某個遞迴解析器,只能說明該測試網域最後由它查詢,不能直接證明其他連線繞過代理。先確認哪些網域應由哪條路徑解析,再搭配瀏覽器安全 DNS、TUN 的 DNS 接管與連線記錄進行檢查。加密解析只能保護查詢傳輸,不會自動確保解析要求使用指定的代理出口。
系統代理未生效:確認應用程式的連線方式
系統代理不會接管所有網路流量
系統代理是提供給應用程式使用的代理設定,應用程式是否採用則取決於本身與使用的網路程式庫。瀏覽器正常,但命令列工具、遊戲或商店應用程式無法連線,不一定是規則錯誤。先透過明確指定代理的指令驗證核心入口,再確認目標應用程式是否讀取系統設定。有些應用程式必須個別填入 HTTP 或 SOCKS 位址,有些會使用環境變數,另有一些較適合透過 TUN 接管;不能假設一個開關就能涵蓋所有程序。
Windows 的使用者代理、自動代理指令碼與 WinHTTP 設定是不同的連線入口。netsh winhttp show proxy 可查看 WinHTTP 狀態,但不代表目前瀏覽器使用的設定。不要為了修復單一應用程式,就直接把代理設定套用到所有系統服務;服務帳號、更新元件與使用者工作階段可能有不同的網路需求。先確認故障程式使用哪種網路程式庫,再選擇對應的設定方式。
核對本機位址、連接埠與環境變數
本機應用程式通常使用 127.0.0.1 與實際監聽的連接埠。若系統代理仍指向舊連接埠,或應用程式把 HTTP 位址填入只支援 SOCKS 的欄位,就會連線失敗。allow-lan: false 不會影響本機回送位址的連線;但其他裝置不能把自己的 127.0.0.1 當成這台電腦的位址。只有在需要區域網路共用時,才另外檢查監聽位址、防火牆與信任界線。
終端機環境變數會由新啟動的子程序繼承。用戶端切換連接埠後,已開啟的終端機仍可能保留舊值;關閉系統代理也不會自動移除手動設定的變數。下例用於類 Unix Shell 的目前工作階段比對,不會修改永久設定。先查看現有變數並記下來源,再設定測試值;還原時也要檢查 Shell 啟動檔、開發工具設定與專案指令碼是否重新加入代理設定。
env | grep -i proxy
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
curl -I --max-time 20 https://example.com
unset http_proxy https_proxy
此處 https_proxy 的值仍使用 http://,代表用戶端先連線到本機 HTTP 代理,再建立 HTTPS 通道,並不是將目標連線降級為明文。不同工具對變數大小寫與優先順序的處理方式不同,ALL_PROXY 與 NO_PROXY 也可能改變連線行為。檢查時要一併查看這些變數,尤其留意是否有範圍過大的略過網域或網段。
處理 UWP、容器與 TUN 情境
Windows 部分商店應用程式會受到回送連線限制,即使系統代理設定正確,也可能無法連上本機代理入口。先確認一般桌面應用程式透過同一個連接埠能正常運作,再評估為目標應用程式新增回送流量豁免,或改用 TUN。不要預設要為所有應用程式新增豁免;相關指令與影響範圍請參考UWP 回送限制排查。這類問題不需要修改遠端代理驗證資訊。
容器、虛擬機器與 WSL 都有各自的網路視角,其中的回送位址不一定指向主機。請依目前的網路模式找出主機可連線的位址,並確認防火牆與監聽範圍。不要一開始就將本機代理開放給所有網路介面;同一網路中的其他裝置也可能使用共用代理。確實需要開放時,請限制可信任的來源,並依用戶端支援的方式設定存取控制。
TUN 透過虛擬介面與路由接管流量,通常需要額外權限或服務元件。啟用後請查看日誌中的裝置建立、路由安裝與 DNS 接管狀態。兩套 VPN 同時修改預設路由,或虛擬機器網段與隧道網段重疊,都可能導致部分目標無法連線。先停用其他流量接管程式進行比對,恢復後再判斷能否透過明確路由共存,不要反覆重新安裝網卡。
最後請在目標應用程式中送出新要求,並在連線頁面確認程序或目標、套用的規則與出口。網頁顯示出口已變更,只能證明該網頁使用的連線路徑正常。修復後請分別測試瀏覽器、命令列與原先故障的應用程式;結束用戶端後也要確認系統代理已還原,避免留下指向已停止連接埠的設定。
用戶端閃退:區分介面、核心與設定
先確認是哪個元件結束運作
圖形介面、背景服務與 mihomo 核心是不同元件。視窗消失但流量仍可正常傳輸,可能只是介面異常;視窗仍在但所有連線中斷,則應檢查核心是否已停止。先記下故障發生於啟動、匯入設定、開啟 TUN,還是執行一段時間後,並查看相應時間的日誌。只說「閃退」無法分辨設定解析失敗、權限錯誤、程序崩潰或遭系統強制結束。
第一次異常後不要立刻清除資料。先結束用戶端,備份設定目錄、覆寫檔與必要日誌,再檢查背景是否仍有殘留程序。反覆開啟介面可能啟動第二個核心,進一步造成連接埠衝突,讓原始問題更難判斷。若用戶端提供「開啟日誌目錄」或「診斷資訊」功能,請優先使用;目錄路徑會因平台與用戶端而異,不要照抄其他軟體的路徑。
使用最小設定驗證核心
將核心啟動與訂閱內容分開驗證。以下設定只監聽本機並使用直連規則,目的是確認程式能否啟動,不可取代實際代理設定。請另存為獨立測試檔,不要覆蓋原始設定。若最小設定運作穩定,但完整訂閱失敗,再逐步加入代理提供者、規則提供者、DNS 與 TUN,找出具體的觸發項目。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
- MATCH,DIRECT
單獨使用 mihomo 時,可先執行設定檔測試。下例假設目前目錄包含核心與測試設定檔,圖形介面用戶無須額外下載核心來執行。測試指令成功只代表設定檔可解析與檢查,不代表遠端資源可下載或代理能連線。外部規則檔案路徑、相對目錄與執行時權限仍須在實際啟動環境中驗證。
# Linux 或 macOS
./mihomo -t -f ./config.yaml
# Windows PowerShell
.\mihomo.exe -t -f .\config.yaml
檢查處理器架構、權限與升級遺留問題
確認安裝套件適用於目前的作業系統與處理器架構。能下載檔案不代表檔案能在目前系統執行,命令列核心也不是圖形介面用戶端安裝程式。一般使用者可先從安裝套件頁面選擇 Clash Plus,再依平台需求比較其他用戶端。不要在不同用戶端間直接複製核心檔案與設定目錄;介面預期使用的控制介面與啟動參數可能不同。
若只有在啟用 TUN 或安裝服務後才結束,請優先檢查管理員授權、背景服務狀態與安全軟體的封鎖記錄。macOS 應依系統提示允許必要的網路元件;Windows 應確認服務是否安裝成功;Linux 應檢查實際啟動使用者與裝置權限。不要遞迴放寬整個設定目錄的所有權限,也不要長期用最高權限執行所有介面操作來掩蓋單一服務的權限問題。
介面啟動後出現白畫面,可能與渲染環境或應用程式快取有關;若核心日誌持續正常,就不要修改代理通訊協定。先完全結束程式再重新啟動;若用戶端提供支援的渲染相容選項,可單獨測試。重設介面快取前請先備份資料,並確認該操作不會一併刪除設定。系統日誌中的應用程式當機記錄,可協助判斷是否與圖形元件或底層執行環境有關。
程式執行一段時間後才結束,請觀察系統記憶體壓力、磁碟空間與日誌成長情況,不要臆測固定的「正常記憶體用量」。只在重現問題期間啟用偵錯日誌,結束後恢復為 info;長期記錄大量連線會占用空間,也會保留敏感的瀏覽記錄。若只有啟用某個遠端規則集合後才出現異常,請保存已移除敏感資訊的最小重現設定,並記下觸發步驟。
原用戶端停止維護時,改用其他方案比反覆安裝同一個封存版本更適合長期使用。Clash for Windows 與 ClashX Meta 的封存版本,並不代表設定檔能未經檢查就直接匯入其他用戶端。請分別遷移訂閱、自訂規則與覆寫邏輯,完成一次連線測試後再移除舊軟體;流程請參考遷移至 mihomo 核心用戶端。
行動裝置專項:VPN、背景執行與網路切換
Android:先檢查 VPN 服務狀態
Android 用戶端通常透過系統 VPN 服務接管流量。同一使用者或設定檔下,其他 VPN、部分本機流量過濾工具或企業安全應用程式可能會占用這項功能。請先停止其他流量接管程式,再於 Clash Plus、Clash Meta for Android 或 FlClash 中重新連線,並確認系統 VPN 圖示與授權狀態。不要只看應用程式首頁的按鈕顏色,就判定背景服務仍在執行。
若只有部分應用程式無法連線,請先檢查應用程式分流清單。列入排除清單的應用程式不會依預期使用代理;若只代理已選取的應用程式,未勾選的應用程式也不會受到接管。系統工作資料夾與個人資料夾可能使用不同的應用程式及 VPN 環境;個人空間連線正常,不代表工作空間也使用相同通道。請先確認故障應用程式位於哪個資料夾,再判斷是否需要管理員處理企業政策。
鎖定螢幕後斷線:分辨省電限制與路由殘留
前景使用正常、鎖定螢幕後斷線時,先確認 VPN 服務是否仍在執行,再檢查系統是否限制背景活動、背景數據或自動啟動。各家 Android 裝置的設定路徑不同,可從「設定 → 應用程式 → 對應用戶端 → 電池」尋找背景執行權限,再查看行動數據限制。每次只修改一項並在鎖定螢幕後重測,不要一次關閉所有省電措施,否則無法判斷實際需要保留哪些例外設定。
若系統啟用了「一律使用 VPN」或「封鎖未經 VPN 的連線」,服務遭系統回收後,可能導致整台裝置無法上網。這是封鎖政策與服務狀態共同造成的結果,不一定是節點突然失效。若要暫時恢復網路,請先了解該選項的保護目的,再到系統 VPN 設定調整;用戶端恢復後再重新驗證。完整排查步驟請參考Android 背景執行與電池最佳化排查。
耗電偏高時,也不能只看應用程式耗電排名。VPN 程序會承載其他應用程式經過隧道的流量,系統統計可能會將部分網路耗電歸到 VPN。請比較相近使用時段的螢幕開啟時間、傳輸活動與網路類型,再檢查是否有過於頻繁的健康檢查、訂閱更新或持續重新連線。閒置時若仍有大量日誌,先找出重複要求的來源,不要立刻關閉所有 DNS 功能。
iOS:檢查隧道與隨選連線
iOS 使用者可從安裝套件頁面前往 Clash Plus 的 App Store 頁面,官方網站為 clashplus.io。連線異常時,先確認系統 VPN 設定與應用程式中的目前設定檔是否一致,再確認是否有其他網路延伸功能參與流量接管。應用程式切換至背景不代表隧道已中斷;請一併檢查系統 VPN 狀態與新要求的結果。
若啟用了隨選連線,系統可能在網路變更後自動重建隧道。手動中斷後又立即連線,不一定代表操作未生效;請檢查目前的隨選規則及適用網路。若 Wi-Fi 正常、行動網路卻失敗,先確認應用程式已獲准使用行動數據,再核對目前網路能否存取訂閱與出口。切換手機網路會改變原連線的來源位址,少數長連線中斷後需要重新建立。
切換網路、驗證入口與區域網路存取
從 Wi-Fi 切換至行動網路後,請等候系統網路穩定,再重新送出目標要求。若仍然失敗,先重新連線 VPN,不要直接刪除設定。公共 Wi-Fi 的驗證頁面可能需要本機網路或特定網域才能載入;必要時暫停代理以完成驗證,再重新啟用。如果系統一律封鎖隧道外的流量,還要依前述內容檢查 VPN 政策,避免驗證要求被擋在無法建立的隧道之外。
手機投影、列印或存取家庭伺服器失敗時,請檢查區域網路位址是否被錯誤送往遠端,以及 VPN 設定是否允許必要的本機存取。不要為了單一印表機就將所有流量改成直連;請記下目標內網位址與網域,使用範圍最小的規則處理。若應用程式使用裝置探索通訊協定,只新增一條 TCP 目標規則可能仍不夠,也要考慮本機廣播或多點傳送。
行動裝置的重現記錄至少要包含系統平台、網路連線方式、鎖定螢幕前後狀態、VPN 是否維持連線,以及發生問題的應用程式範圍。求助時不要公開分享完整設定檔。問題恢復後,請依序測試前景連線、短暫鎖定螢幕、Wi-Fi 與行動網路切換,以及區域網路存取;基本概念可參閱疑難排解,重新匯入設定則請回到入門指南的設定步驟。