疑難排解手冊 / 依症狀排查

Clash 故障排除指南

先恢復基本連線,再找出設定、DNS 與流量接管方面的問題。每次只調整一個項目,並記下測試結果。

初次使用時,請先按照Clash 入門設定教學完成匯入訂閱、選擇模式及連線驗證。本頁適用於已發生異常時查閱,不重複說明安裝流程。介面名稱請以目前使用的用戶端為準;Clash Plus、Clash Verge Rev、FlClash 等用戶端的操作入口可能不同,判斷問題時,核心日誌與實際連線紀錄比按鈕位置更可靠。

無法連線:先釐清基本網路與代理連線

先關閉用戶端中的系統代理與 TUN,再開啟平時可直接連線的網站。只關閉視窗不一定會還原系統設定,有些用戶端關閉視窗後仍會在背景執行。關閉流量接管後仍無法連線,請先檢查無線網路登入、路由器、網路線及電信業者連線;此時反覆更換節點無法修復基本網路。公共無線網路也可能要求先完成網頁驗證,通常須關閉代理才能開啟驗證頁面。

先確認問題範圍,再決定檢查方向

分別測試一個可直接連線的網站、一個需要代理的網站及另一個應用程式,並記錄測試結果。全部失敗時,優先確認系統代理是否指向已停止運作的本機連接埠;只有代理目標失敗時,檢查策略群組與出口;只有單一網站失敗時,檢查該網域套用的規則、目標服務狀態與存取限制。不要用單一網站代表整個網際網路,也不要把瀏覽器快取中的舊頁面當成連線成功的證據。

接著確認核心是否已啟動。用戶端主視窗能開啟,不代表背景核心正在監聽連接埠。查看執行狀態與啟動日誌,留意連接埠遭占用、設定解析失敗或權限不足等訊息。若日誌停在載入設定之前,先處理啟動失敗;若已有連線紀錄,沿著紀錄確認請求被送往 DIRECT、某個策略群組還是 REJECT。若沒有連線紀錄,應回頭檢查流量接管方式,而不是繼續調整遠端通訊協定參數。

透過明確指定代理縮小問題範圍

在用戶端設定中確認本機混合連接埠,再使用命令明確指定代理。以下以本機連接埠 7890 為例;若實際連接埠不同,請替換數字,不要因為範例使用此連接埠就修改整份設定。Windows 可使用 curl.exe,避免終端機將同名命令解讀為其他工具。測試目標僅用於檢查連線,不保證在所有網路環境下都能成功。

curl --connect-timeout 10 --max-time 20 -I https://example.com
curl --connect-timeout 10 --max-time 20 -I -x http://127.0.0.1:7890 https://example.com

第一個命令沒有明確指定代理,但仍可能受終端機代理環境變數影響,測試前請先檢查這些變數。第二個命令若顯示本機連線遭拒,代表監聽位址、連接埠或核心狀態不符;若本機連線已建立,之後才發生遠端逾時,就應改查節點與連線路徑。明確指定代理後測試成功,但瀏覽器仍失敗,表示出口大致可用,應檢查瀏覽器擴充功能、系統代理與安全 DNS。HTTP 狀態碼只代表收到某種回應,不表示目標服務的所有功能都正常。

依可還原的順序恢復連線

切回規則模式,選擇先前可用的出口,關閉其他代理用戶端與重複的流量接管工具,再重新建立連線。暫時關閉 TUN、只保留系統代理,有助於區分路由與應用程式代理問題;但對不讀取系統代理的應用程式而言,這並非等效測試。每次切換後關閉舊的網頁連線,或重新啟動測試用的應用程式,因為已建立的連線通常不會隨策略變更立即切換。

若所有網站在結束用戶端後才無法連線,請開啟系統網路設定,移除殘留的手動代理位址,再恢復自動取得網路參數。不要直接執行完整的網路重設,這可能會刪除工作網路所需的虛擬介面卡與固定位址。還原後先確認可直接連線,再啟動用戶端並逐項啟用功能。記下最後一個導致故障的設定,之後才能針對性修復,不必每次都重新安裝。

節點逾時:區分測試失敗與出口無法連線

先實際開啟目標網站,再參考用戶端的延遲測試。測試逾時只表示某次探測未能在指定時間內完成,可能與測試網址、DNS、探測方式或目前的連線路徑有關,不能單憑此結果認定節點已永久失效。若實際網頁能開啟,但探測持續失敗,請先更換可連線的測試網址,或還原用戶端預設測試設定,不要因此刪除整份訂閱。關於測量方式的限制,可參閱延遲測試與實際網速的差異。

確認逾時發生在哪個環節

開啟日誌後重新送出一次失敗請求,依相同時間點查看目標、策略與錯誤訊息。若連線伺服器前出現網域解析錯誤,問題在入口位址解析;連線伺服器連接埠時逾時,可能是本機網路、連線路徑、遠端監聽或中間防火牆所致;若連線建立後交握失敗,則應檢查通訊協定、傳輸層、安全參數及伺服器狀態。不同用戶端的錯誤文字可能不同,請配合前後文判讀,不要只搜尋最後一個英文單字。

確認目前策略群組實際選用的出口。自動選擇群組可能隨健康檢查結果變動,備援群組也可能已切換到其他成員;介面顯示的群組名稱並不是伺服器位址。查看個別連線的出口路徑,確認沒有誤選 DIRECT 或已失效的成員。若節點需要透過其他代理連線,也要檢查前置出口;串接連線中任何一段失敗,最後都可能顯示為目標逾時。

交叉測試,判斷是網路還是伺服器問題

在同一台裝置上切換家用網路與手機熱點,保持用戶端設定不變,分別測試同一個出口。同一出口只在某種網路下失敗,較可能與網路路徑、連接埠限制或 DNS 差異有關;若在多種網路下都失敗,再用另一台裝置測試。兩台裝置都失敗,但同一訂閱中的其他出口正常,問題較可能出在該伺服器。交叉測試時請關閉自動切換,以免表面上測試同一個群組,實際上每次都經過不同出口。

接著確認訂閱是否更新成功、帳戶是否仍有可用權益,以及服務供應商是否更換入口。不要自行猜測伺服器連接埠、加密方式或傳輸路徑;這些參數必須與伺服器端設定相符,憑經驗修改通常只會讓逾時變成交握錯誤。裝置日期與時區也應設定正確,時間明顯偏差可能導致憑證驗證失敗。遇到憑證問題時,應核對伺服器網域與憑證設定,不要長期略過驗證。

日誌現象優先檢查項目下一步
本機連接埠拒絕連線核心是否正在執行、連接埠是否一致修復監聽設定後再測試出口
伺服器位址解析失敗節點網域與入口 DNS查看 DNS 章節
連線逾時網路路徑、遠端連接埠、伺服器狀態跨網路交叉測試
交握或憑證錯誤時間、網域、通訊協定與安全參數核對訂閱與伺服器端設定

別把局部通訊協定問題誤判為全面斷線

網頁文字能載入,但語音或遊戲逾時,可能與 UDP 支援、應用程式流量接管或目標限制有關。先確認節點通訊協定與伺服器是否支援所需流量,再查看用戶端連線紀錄。瀏覽器使用的 QUIC、一般 HTTPS 與應用程式自訂通訊協定,傳輸路徑並不完全相同,因此單次網頁測試無法涵蓋所有服務。暫時使用應用程式提供的相容傳輸選項可作為比對,但不要把關閉某項通訊協定當成所有裝置都適用的固定最佳化方式。

調整逾時值只能協助辨識回應緩慢,無法讓遭封鎖的連接埠恢復。請先保留預設值,確認故障可穩定重現後,再適度延長單次探測時間,並比較實際請求結果。回報問題時請附上失敗時間、網路類型、去識別化錯誤訊息與交叉測試結果;不要提供完整伺服器憑證。若只有個別出口異常,先切換到可用成員維持連線,再請服務供應商檢查該入口。

訂閱失敗:分別檢查下載、格式與設定載入

先確認失敗發生在哪個步驟:無法取得網址內容、內容下載成功但無法解析,或匯入設定後核心無法啟動。三種情況的處理方式不同。請保留最後一份可用設定,避免更新失敗時連原本可用的環境也一併覆蓋。用戶端顯示訂閱項目,只能證明本機曾儲存該筆記錄;還須查看更新時間與結果,才能確認目前內容是最近一次成功取得的版本。

檢查連結完整性與取得方式

向服務供應商重新複製適用於 Clash 或 mihomo 的訂閱網址,留意通訊軟體自動換行、前後空格,以及從網頁複製時附帶的標點。訂閱網址通常包含帳戶存取憑證,請比照密碼妥善保管。不要將完整網址貼到公開的轉換服務,也不要為了排查問題而把網址寫進截圖標題。若網址曾經公開,請在伺服器端重新產生;單純刪除貼文無法撤銷已外洩的存取權限。

留意更新時的錯誤訊息:沒有收到回應,通常應檢查網路與 DNS;明確回覆未授權或禁止存取時,優先確認連結權限與帳戶狀態;若收到網頁內容卻解析失敗,可能下載到登入頁、錯誤訊息或存取驗證頁面。瀏覽器能開啟服務網站,不代表用戶端能使用訂閱介面,因為兩者的請求路徑、登入狀態與網路出口可能不同。請勿反覆重試,以免觸發伺服器的頻率限制。

部分用戶端允許選擇訂閱更新時使用直連或代理。已有可用設定時,可比較這兩種取得方式;初次匯入尚無可用出口時,應先使用目前網路可存取的合法方式。若更新必須經過目前已失效的節點,就會陷入無法自行修復的循環。此時切回最後一份可用設定、暫時改用其他可用出口,或聯絡供應商確認訂閱入口,都比隨意修改 DNS 更直接。

確認格式與核心支援能力相符

YAML 完整設定、編碼後的節點集合與單筆 URI 連結是不同類型的檔案。能匯入某個用戶端的內容,不一定能直接當作另一個用戶端的完整設定。查看匯入入口的要求,分清新增單一節點、匯入設定與更新訂閱。若取得的格式不符,優先向服務供應商索取對應格式;確實需要轉換時,可參考訂閱格式與轉換說明,了解策略群組、規則及額外欄位可能遺失的內容。

解析錯誤通常會提供行號與欄位名稱。回到原始檔案查看該行及上一行,檢查縮排、冒號、引號與清單符號。YAML 縮排必須使用空格,不可混用定位字元。設定即使通過語法解析,也可能有策略參照錯誤:規則引用不存在的群組,或群組包含不存在的節點,都可能導致載入失敗或運作異常。含空格與特殊符號的名稱必須保持完整;重新命名後,請同步修改所有參照。

mode: rule
mixed-port: 7890
allow-lan: false
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

以下是僅供確認基本載入功能的直連設定,不包含遠端代理。若用戶端允許匯入本機設定,可先備份,再另建測試項目,不要覆蓋原訂閱。最小設定可以啟動、原設定卻無法啟動,表示應檢查原始檔案欄位、參照或外部資源;兩者都無法啟動,則繼續檢查連接埠、目錄權限與核心執行環境。

處理更新覆蓋與外部資源載入失敗

訂閱內容成功載入後,規則集或代理集合仍可能下載失敗。請分別檢查外部資源網址、檔案路徑及錯誤訊息,不要把所有下載失敗都歸咎於訂閱網址。若用戶端支援覆寫或合併設定,請透過專用入口保存本機調整,避免下次更新時遭覆蓋;不確定合併順序時,查看最終生效的設定。連續失敗後先還原備份,再逐項加入自訂內容。若用戶端與核心能力不相容,請前往用戶端下載頁選擇合適的用戶端;一般使用者可優先考慮 Clash Plus,再依平台確認其他選項。

速度緩慢:分別檢查 DNS、交握與持續傳輸

先釐清慢在哪個環節:點擊連結後等很久、頁面開始載入後速度很快、檔案下載持續緩慢,還是只有尖峰時段卡頓。等待首位元組時間、傳輸量與互動延遲是不同指標。用戶端測得的延遲較低,只表示某次短請求回應較快,不代表線路有足夠頻寬。不要同時執行多個測速工具與下載工作,否則測試本身就會占用出口與本機無線網路資源。

進行可重複的對照測試

固定裝置、網路、出口與目標,關閉大型檔案同步、系統更新及其他占用頻寬的工作,再進行少量重複測試。先測試可直接連線的目標,判斷本機網路是否已壅塞;再測試需要代理的服務,比較結果。比較出口時請使用相同目標,並選擇相近時段,避免將伺服器快取、資源大小及不同地區的內容傳遞差異誤認為節點差異。用手機熱點測試時,也要考慮資費方案限速與訊號波動。

下載速率通常以每秒位元組表示,寬頻標示速率通常以每秒位元表示,兩者不可直接比較。無線網路的協商速率也不等於應用程式能持續取得的實際速率。路由器效能、無線干擾、裝置省電模式、共用出口的使用人數及目標伺服器限速,都可能形成瓶頸。先比較有線與無線連線,或靠近路由器測試;若直接連線也一樣慢,應先改善本機網路條件,調整代理規則並不會增加無線連線的容量。

確認慢速請求實際使用的出口

在連線頁面找到正在載入的網域,查看套用的規則與策略。一個網頁通常會呼叫多個網域;首頁直接連線、靜態資源卻走代理,或登入介面連到另一個地區,都可能造成部分內容延遲。不要因為主網域的規則正確,就假設所有子請求也都正確。依連線紀錄補上必要規則,並將更明確的規則排在較寬泛的規則之前;修改後重新建立連線,避免舊連線繼續使用原本的出口。

規則會依序比對,過早出現的寬泛條件可能將原本應直連的內容送往遠端,增加往返時間。反過來,若需要代理的網域被設為直連,也可能等待很久才顯示錯誤。請檢查最終生效的設定,而不只是編輯器中的片段,因為訂閱合併與覆寫可能改變規則順序。想了解比對方式時,請參閱自訂規則與比對順序,再調整規則,不要靠大量重複項目碰運氣。

若只有首次連線較慢、後續恢復正常,優先檢查 DNS、連線交握與遠端喚醒;若一開始速度正常、持續傳輸後逐漸下降,則較可能是壅塞、限速或裝置負載。查看工作管理員中的處理器、記憶體與網路用量,判斷是否有單一程序持續占滿資源。圖形介面用戶端的日誌量過大也可能增加介面負擔;完成排查後請恢復一般日誌層級,不要長期維持詳細除錯日誌。

謹慎調整 MTU、通訊協定與並行連線

啟用 TUN 後,小型網頁正常,但大型檔案或部分網站停住,這時才值得檢查路徑 MTU 與封包分段問題。先關閉 TUN、保留明確指定代理的連線方式作為對照,確認故障是否與虛擬網卡接管有關。MTU 應依鏈路測試與用戶端文件調整,不要把網路上看到的數值當成通用設定。每次變更後請用相同服務重新測試,並保留原始數值;盲目調低 MTU 會增加封包數量,不一定能提升速度。

同樣地,不要把增加並行連線、開啟所有進階選項或更換任意公共 DNS 當成加速組合。並行連線可能增加連線負載,某些通訊協定也受伺服器端能力限制。優先選擇與目標服務距離及路徑合適的可用出口,減少不必要的代理串接。自動選擇策略有助於維持可用性,但健康檢查通常無法評估大型檔案的傳輸量;持續下載時,可先完成對照測試,再手動固定出口,避免出口頻繁切換影響判斷。

DNS 問題:確認由誰解析,以及解析結果如何使用

先區分網域解析失敗與目標連線失敗。日誌出現找不到主機、解析逾時或沒有可用位址時,才應優先檢查 DNS;若已取得位址但連線逾時,問題仍可能出在路由或出口。直接把網址中的網域換成 IP 並不是可靠的驗證方式,因為 HTTPS 憑證、伺服器名稱及虛擬主機路由都可能依賴原始網域。請搭配解析工具與用戶端日誌判斷,不要只憑瀏覽器錯誤頁面下結論。

釐清目前實際的解析路徑

系統、瀏覽器、用戶端與遠端代理都可能參與 DNS 解析。瀏覽器啟用安全 DNS 後,可能會略過系統解析器;應用程式內建解析功能的結果也可能與終端機工具不同。TUN 的 DNS 劫持是否生效,還取決於路由與請求類型。請先記錄目前模式、用戶端 DNS 選項、系統 DNS 及瀏覽器設定,再檢查發生問題的應用程式實際使用哪條路徑。只修改系統 DNS,不一定會改變應用程式的查詢結果。

使用系統工具查詢一個穩定網域,同時查看用戶端日誌。以下命令用於查看系統解析結果,不一定代表瀏覽器或代理出口取得的位址。分別查詢故障網域與正常網域;若只有一個網域失敗,可能與權威 DNS 紀錄、快取或分流解析設定有關;全部失敗時,再檢查解析伺服器是否可連線。不要直接把終端機結果與用戶端日誌中的不同位址判定為異常,因為內容傳遞網路本來就可能回傳不同位址。

nslookup example.com

# Linux 或 macOS 已安裝 dig 時可使用
dig example.com A
dig example.com AAAA

檢查代理伺服器本身的網域如何解析。若用來解析代理入口的請求也必須經過尚未建立的代理,就會形成啟動循環。mihomo 的 proxy-server-nameserver 用於解析代理節點網域,default-nameserver 可用來解析加密 DNS 服務的網域;實際行為也會受其他設定項目影響。請先確保啟動時所需的解析路徑可用,再處理目標網域分流,不要將所有查詢都強制送往無法連線的出口。

了解 fake-ip 與快取的適用範圍

fake-ip 模式會回傳供應用程式對應使用的虛擬位址,再由核心依照映射處理連線。看到這類位址不代表 DNS 解析遭到污染。問題在於應用程式取得虛擬位址後,連線是否仍由同一個核心接管;若應用程式保留舊快取,但用戶端已關閉或映射已遺失,就可能無法建立連線。切換模式後請關閉舊連線、重新啟動受影響的應用程式,必要時清除相關快取,不要立刻新增大量排除規則。

部分裝置探索、區域網路服務與特殊應用程式依賴真實位址;確認相容性問題後,可加入 fake-ip 排除項目。排除項目只會改變相關網域的解析方式,不會自動確保後續流量直連,仍須檢查規則與路由。區域網路主機名稱也可能依賴路由器、搜尋網域或多播探索,公共 DNS 服務通常不會提供這些紀錄。遠端辦公環境尤其要保留企業內部 DNS 路徑,不要用單一公共解析器取代所有用途。

使用最精簡的 DNS 設定進行對照

以下片段用來說明欄位之間的關係,請合併到獨立測試設定中,不要覆蓋既有訂閱的整個 DNS 區段。此例使用一般 DNS 作為基本對照,不包含加密傳輸;若解析器在目前網路中無法連線,請改用網路管理員或服務供應商確認可用的位址。測試成功只表示這條解析路徑可用,不代表已符合隱私與分流需求。

dns:
  enable: true
  enhanced-mode: redir-host
  nameserver:
    - 1.1.1.1
  proxy-server-nameserver:
    - 1.1.1.1

若 IPv4 正常,但雙堆疊環境間歇性失敗,請分別檢查 IPv6 解析結果、預設路由與代理支援。不要只關閉某個應用程式的 IPv6,就認定問題已排除;系統中的其他應用程式仍可能使用另一條路徑。還原設定時,請分別測試節點網域、一般目標與區域網路目標,再逐項恢復加密解析與分流規則。完整的 TUN 接管關係請參閱TUN 模式與虛擬網卡設定。

系統代理未生效:確認應用程式是否讀取代理設定

先釐清系統代理的作用:它提供一組代理參數,供應用程式讀取,並非強制接管所有網路流量。部分終端機工具、遊戲、服務程序及自行建立連線的應用程式不會讀取這些設定。啟用後瀏覽器能連線,某個程式仍直接連線,不一定是用戶端故障。先用明確指定代理的工具驗證本機入口,再確認目標應用程式是否支援代理設定;若需要接管更多應用程式,再評估 TUN,不要反覆切換系統代理。

核對監聽位址、連接埠與代理類型

查看用戶端目前使用的連接埠,確認系統手動代理指向相同位址。常見的本機位址是 127.0.0.1,但連接埠並沒有固定值。HTTP 代理連接埠、SOCKS 連接埠與混合連接埠支援的功能不同,不可任意互換。若應用程式要求 SOCKS,請填入支援 SOCKS 的連接埠;若使用 HTTP CONNECT,請選擇相對應的入口。兩種通訊協定有時可共用混合連接埠,但前提是用戶端確實已啟用該監聽。

檢查是否有第二個用戶端、瀏覽器擴充功能或企業管理原則反覆改寫系統設定。可能的情況是啟用後一度正常,過一會兒代理位址又改變。請先結束其他流量接管工具,觀察設定是否穩定,再逐一重新啟用。不要讓多個用戶端同時自動啟動,以免互相搶占設定。若系統設定由公司管理,請依管理員要求處理;擅自覆寫原則可能導致工作網路與驗證服務失效。

環境檢查重點常見限制
Windows 桌面應用程式系統代理、應用程式個別設定服務與部分工具使用另一套代理設定
macOS目前網路服務的代理設定切換網路服務後須重新確認
Linux 桌面與終端機桌面代理、環境變數、應用程式設定桌面設定不一定會傳遞給終端機程序
容器與虛擬環境網路命名空間、可連線的主機位址容器內的回環位址並非主機

分別設定終端機與隔離環境

終端機通常需要設定工具參數或環境變數。以下只會在目前的類 Unix 終端機工作階段設定 HTTP 與 HTTPS 代理,並排除本機位址;Windows PowerShell 請使用相應的環境變數語法。環境變數名稱是否區分大小寫,會因工具而異,使用前請查看工具說明。已在執行中的程序不會自動繼承之後修改的變數,請從新的環境重新啟動測試程式。

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,::1

# 結束目前工作階段中的臨時設定
unset http_proxy https_proxy no_proxy

https_proxy 的值使用 HTTP 位址不一定有問題,它可以表示透過 HTTP 代理建立通往 HTTPS 目標的通道。不要只憑變數名稱,就把位址前綴改成不支援的通訊協定。容器、虛擬機器與部分子系統中的 127.0.0.1 指向環境本身,不能直接套用主機的回環位址。若要跨環境連線,請先確認主機位址、監聽範圍與防火牆設定,並限制可存取的來源,避免將本機代理暴露在不可信任的網路中。

確認有需要時才啟用 TUN

若目標應用程式不支援代理,可使用用戶端提供的 TUN 功能,但應先檢查所需權限、虛擬網卡、路由與 DNS 接管。部分用戶端可讓系統代理與 TUN 協同運作,但同時開啟不代表連線更可靠。診斷時一次只保留一種流量接管方式,避免請求被重複轉送,或被另一套 VPN 路由截走。即使已建立虛擬網卡,也不代表路由設定正確,應以目標應用程式的實際連線紀錄為準。

若瀏覽器正常、命令列失敗,先明確指定代理進行驗證;若所有應用程式都未出現在連線紀錄中,先檢查監聽與流量接管;若已有紀錄但走錯出口,再檢查規則。修復後測試代理目標、直連目標與區域網路裝置,確認沒有影響印表機、檔案共享或工作網路。結束用戶端後,也要確認系統代理已正常還原,並實際驗證復原流程,避免下次開機因殘留位址而無法連線。

用戶端閃退:分別檢查介面、核心與背景服務

先確認是哪個程序結束。介面無法開啟、視窗卡住、核心停止及背景服務啟動失敗,並不是同一種故障。若視窗關閉後代理仍可用,可能只是介面程序異常;若視窗正常,但連接埠已不再監聽,就應查看核心與服務日誌。記錄作業系統提示、異常時間與最後一次操作,例如更新設定、切換 TUN、喚醒裝置或更換網路,避免只留下無法重現的「突然閃退」描述。

先保留紀錄,再進行最小化啟動

先透過用戶端匯出必要日誌,或在程式資料目錄中尋找相關時段的紀錄。分享前請刪除訂閱網址、節點憑證、瀏覽紀錄與本機使用者名稱等資料。不要直接上傳整個設定目錄,其中可能包含帳戶資料與控制介面參數。日誌過長時,截取啟動到報錯附近的片段,並保留錯誤前的上下文;只貼最後一行,通常無法判斷問題出在設定還是執行環境。

備份後切換到最精簡的本機設定,暫時關閉自動更新、外部規則下載、TUN 與開機啟動,再啟動用戶端。精簡設定能正常執行,表示應逐項還原原有設定,找出觸發異常的功能;精簡設定仍無法執行,則檢查安裝檔、系統元件、目錄權限與程序衝突。不要同時刪除設定、重新安裝與更新系統,否則即使問題解決,也無從確認真正有效的修復步驟。

檢查權限、處理器架構與連接埠衝突

請前往用戶端下載頁,依作業系統與處理器架構選擇安裝檔;一般使用者可優先考慮 Clash Plus,若需要其他介面或部署方式,再選擇 Clash Verge Rev、FlClash 等合適選項。舊版系統的支援情況請以用戶端目前要求為準,不要假設所有新版安裝檔都能在舊環境執行。Clash for Windows 與 ClashX Meta 已停止維護;遷移時請保留可用設定,重新核對流量接管與服務設定,不要複製整個舊程式目錄來覆蓋新用戶端。

若啟動日誌指出位址遭占用,先確認是哪個程序占用,不要隨機結束系統程序。Windows 可使用以下命令查看範例連接埠對應的程序編號,再到工作管理員確認程式;Linux 可使用 ss 查看監聽狀態。若確實是另一個代理執行個體,請結束重複執行的程序,或在設定中更換連接埠,並同步修改系統代理與應用程式入口。日誌中的連接埠可能是控制介面,而非代理連接埠,請依欄位分別處理。

# Windows:查看範例連接埠
netstat -ano | findstr :7890

# Linux:查看 TCP 監聽狀態
ss -lntp

安裝服務、建立虛擬網卡與一般介面執行所需的權限可能不同。只在文件要求的步驟授予必要權限,不要長期以高權限啟動所有程式,藉此掩蓋目錄權限錯誤。安裝目錄受保護、資料目錄唯讀或磁碟空間不足,都可能導致設定寫入失敗。若安全軟體隔離了元件,請先確認來源與事件紀錄,再依裝置管理規定處理;不要直接關閉整套防護來測試。

處理休眠喚醒與資源持續增加

若只在裝置從休眠喚醒或切換網路後發生異常,先重新連線網路,再重新啟動核心並觀察是否恢復。網路介面編號、預設路由與 DNS 伺服器都可能在喚醒後改變,舊的 TUN 狀態不一定還適用。確認用戶端具備相應的復原設定後,再決定是否啟用自動重新連線;不斷重啟會抹去故障現場,也可能中斷正常連線,不能取代問題排查。

若執行時間越長越卡,請觀察記憶體、處理器與磁碟寫入是否持續增加,並記錄資源增加的時間與當時的工作。過量日誌、龐大的規則集合與頻繁健康檢查都值得進一步比對,但不能只憑資源用量偏高就認定有特定缺陷。逐項減少自訂設定、恢復一般日誌層級,並比較相同長度的執行時間。更新或遷移後,先確認程式能穩定執行,再恢復開機啟動;Linux 背景服務的目錄與日誌檢查方式可參閱mihomo 與 systemd 部署說明。

行動裝置專項:檢查 VPN 授權、背景執行與網路切換

先確認系統是否已建立目前用戶端的 VPN 連線,再測試目標應用程式。行動裝置通常透過系統 VPN 介面接管流量;狀態列圖示只表示連線狀態,無法證明訂閱、DNS 與遠端出口都正常。裝置若還有公司 VPN、防火牆或其他網路過濾應用程式,可能會互相競用流量接管位置。先確認目前由哪個應用程式負責接管,再處理規則與節點,避免多個工具輪流改寫設定。

Android:先檢查授權與背景限制

啟動 Clash Plus、Clash Meta for Android 或 FlClash 時,請依系統提示確認 VPN 授權;拒絕授權後,介面可能仍可查看設定,但應用程式流量不會如預期進入通道。若點選連線時沒有出現授權提示,請檢查系統 VPN 設定中是否有舊設定、永遠開啟連線,或封鎖未經 VPN 連線的選項。變更前先記下原本狀態;公司裝置也應遵守管理原則,不要擅自移除單位要求的連線。

若前景運作正常,但鎖定螢幕一段時間後失效,優先檢查電池最佳化、背景活動與自動啟動限制。不同品牌的系統設定位置各異,請以裝置設定為準。允許用戶端必要的背景執行後,進行一次鎖定螢幕與喚醒測試,觀察連線是否維持。不要一次解除所有應用程式的限制,只調整實際負責網路接管的用戶端,並留意系統是否提示耗電或背景服務遭終止。

若只有部分應用程式未經代理,請檢查是否啟用了按應用程式納入或排除的清單。清單模式與全域接管的作用不同;應用程式更新、工作設定檔隔離或應用程式分身,也可能讓原本的選擇不再涵蓋實際程序。先用一般瀏覽器作為基準,再測試目標應用程式。應用程式內建的安全 DNS、獨立網路堆疊與帳戶地區限制,都可能造成與瀏覽器不同的結果,不要只憑單一應用程式失敗就判定整個 VPN 無效。

iOS:檢查連線設定與目標服務

iOS 使用者可前往iOS 用戶端入口查看首選的 Clash Plus,並核對官方網站 clashplus.io。首次連線時,請依系統要求完成 VPN 設定授權,再返回用戶端確認已啟用的訂閱與策略。若系統中儲存了多份 VPN 設定,請確認目前啟用的是哪一份;刪除舊設定前先確認用途,避免誤刪工作連線或仍需使用的網路設定。

若瀏覽器能連線,但某個應用程式失敗,先查看連線紀錄中是否出現目標,再區分是未接管、規則錯誤還是伺服器拒絕。部分服務會依帳戶地區、裝置位置或既有工作階段決定可用功能,切換出口不會自動改變這些條件。重新啟動目標應用程式可排除舊連線造成的影響,但不要優先清除所有應用程式資料。若涉及付款、帳戶驗證或工作驗證,請先恢復穩定網路,再依服務供應商指引處理。

切換無線網路與行動網路後重新驗證

從無線網路切換到行動網路時,本機位址、解析器、IPv6 條件與出口路徑可能同時改變。若切換後立刻斷線,先等待系統網路就緒,再重新建立用戶端連線。分別記錄兩種網路的測試結果:只有無線網路失敗時,檢查驗證頁面與路由器;只有行動網路失敗時,檢查訊號、資費方案狀態與電信業者路徑。請勿在駕駛或其他不適合操作裝置的情況下連續測試。

手機已透過用戶端連線,不代表開啟熱點後,連線的電腦也會自動經過代理。熱點轉送的流量是否會被接管,取決於系統能力、路由與用戶端實作,不能只憑手機上的 VPN 圖示推斷。透過其他裝置共享代理也涉及監聽範圍、驗證與防火牆,請依明確的區域網路方案設定;一般使用者可優先在每台裝置安裝合適的用戶端並分別驗證,不要將手機的回環位址填入電腦代理設定。

排查完成後,依序測試前景連線、鎖定螢幕後恢復、無線與行動網路切換,以及一項需要直連的本機服務。保留必要的背景權限,並還原暫時啟用的除錯設定。若問題仍能重現,請整理裝置系統、用戶端名稱、網路類型、失敗時間與去識別化日誌,再回報給相應的維護方或服務供應商。基本術語可參閱術語手冊;需要重新建立設定時,請回到入門指南依照主要步驟逐一驗證,不必繼續疊加未知參數。

下載最新版 Clash