概念 · 設定 · 維護

Clash 使用指南
從零開始學會

沿著流量進入用戶端、比對規則、選擇出口的路徑,逐章建立設定與排錯方法。

一、核心概念:分清用戶端、核心與流量入口

用戶端負責操作,核心負責轉送

Clash 生態系並非一個安裝包就能涵蓋所有功能。圖形化用戶端提供訂閱匯入、設定頁面、代理群組選擇和日誌檢視;核心讀取設定,執行網域解析、規則比對與連線轉送。mihomo 是這個生態系中常見的核心。兩款用戶端即使採用相近的核心,在覆寫方式、系統整合和設定儲存位置上仍可能不同,因此不能只看介面上的按鈕相同,就認定實際行為完全一致。

設定檔是串連兩者的約定,通常採用 YAML 格式。檔案中可能包含代理節點、代理群組、分流規則、監聽連接埠和 DNS 設定。訂閱則是取得這些內容的其中一種來源:有些網址會提供完整設定,有些只提供節點清單。匯入成功只代表用戶端接受了輸入內容,不代表規則正確、出口可用或所有應用程式都已經透過代理;這些環節都需要分別驗證。

用三個問題理解一次連線

排查連線問題時,先確認流量是否進入核心,再確認命中了哪條規則,最後檢查所選出口能否建立連線。系統代理主要為遵循系統設定的應用程式提供 HTTP 或 SOCKS 入口;應用程式自行設定代理時,也能直接連到本機監聽連接埠。TUN 則透過虛擬網路介面接管符合路由條件的流量。入口不同,涵蓋範圍與排錯方法也不同,不能因為瀏覽器連線成功,就認定所有應用程式都正常。

流量進入核心後,規則通常會由上而下依序檢查,命中後交由指定策略處理。策略可能是直接連線,也可能是代理群組;代理群組再決定使用哪個節點,節點負責連線到遠端代理服務。因此,「規則模式」不是一種節點協定,「系統代理」也不是代理群組。混淆這些不同層次的設定,容易發生不斷切換節點卻始終無法解決入口問題的情況。

層級主要職責優先檢查項目
流量入口將應用程式連線交給核心系統代理、應用程式代理、TUN 路由
規則與策略決定連線要前往何處比對規則、代理群組、最終出口
遠端連線透過所選節點連線至目標驗證、協定、解析與交握錯誤

先釐清能力範圍再設定

用戶端本身不等於可用的遠端代理服務。節點位址、連接埠、驗證資訊與可用範圍取決於設定來源;訂閱到期、驗證失效或服務受限,通常無法靠開啟 TUN 修復。另一方面,代理也無法解決目標網站本身的登入限制或服務故障。測試時請使用有權存取的服務,並遵守所在地法律、網路管理規範與服務條款,避免將服務端拒絕誤判為用戶端故障。

開始前先簡單記錄作業系統、用戶端名稱、設定來源、目前使用的入口,以及預計涵蓋的應用程式。不要將訂閱金鑰記在公開筆記中。接著先確認瀏覽器能正常連線,再逐步擴大到其他應用程式,最後才考慮全面接管。每次只增加一個變因,發生故障時才能回到上一條可用路徑。核心與圖形介面的關係,也可參閱Clash 生態系譜說明。

二、選擇用戶端:先配合平台,再考量設定功能

初次使用,優先選擇一致的操作流程

本下載頁優先推薦 Clash Plus,適合想透過同一款產品學習訂閱、策略與連線管理的使用者。實際選擇仍應以裝置支援情況和所需功能為準:桌面使用者可能更在意服務模式、規則覆寫與視窗管理;行動裝置使用者則更關心 VPN 授權、背景執行和耗電量。先列出必須解決的問題再比較用戶端,通常比同時安裝多款產品更容易獲得穩定結果。

Windows 下載區也提供 Clash Verge Rev、FlClash、Clash Nyanpasu,以及已停止維護的 Clash for Windows。macOS 提供 Clash Plus、Clash Verge Rev、FlClash 和已停止維護的 ClashX Meta。封存用戶端適合了解舊環境或處理移轉,不建議只因舊教學的截圖相同,就將它作為新安裝的預設選擇。移轉前應先備份訂閱來源與自訂規則,再於新用戶端重新設定系統整合功能。

平台限制比介面外觀更重要

Android 可依設定相容性,在 Clash Plus、Clash Meta for Android、FlClash 和 Surfboard 之間選擇。Surfboard 的設定格式與 Clash YAML 不同,不能將任意完整 YAML 檔案直接當成通用輸入。iOS 下載區提供 Clash Plus 的商店連結,也列出官方網站 clashplus.io。行動作業系統通常透過系統提供的 VPN 功能建立通道,不應直接套用桌面系統代理連接埠的操作流程。

Linux 圖形化方案包括 Clash Verge Rev 和 FlClash;伺服器、路由器或希望自行維護服務的使用者,則可進一步考慮獨立部署 mihomo 核心。獨立核心需要自行處理啟動參數、執行目錄、權限、日誌與服務管理,不會自動提供圖形化用戶端的訂閱按鈕。若只是日常桌面使用,先用圖形介面建立可用設定,再學習核心部署,能減少同時需要處理的變因。

裝置類型選擇前確認常見誤區
桌上型電腦作業系統、處理器架構、服務權限誤以為系統代理會接管所有流量
手機與平板設定格式、VPN 授權、背景執行策略同時啟用多款 VPN 類應用程式
伺服器與路由器指令集、執行權限、路由與防火牆只複製設定,忽略執行環境

設定相容不代表支援所有擴充功能

比較用戶端時,請分別檢查節點協定、規則語法和用戶端擴充功能。某個核心能識別的欄位,可能會在另一個核心中遭到拒絕;圖形化用戶端支援的指令碼或覆寫格式,也不一定屬於標準設定。遇到教學要求新增欄位時,先確認教學適用的產品與核心。不要為了排除錯誤就隨意刪除整段 DNS 或代理群組設定,否則即使檔案成功載入,也可能改變原本的分流目的。

主要負責系統接管的用戶端,最後只保留一款。其他產品可以用來比較,但測試前應先結束舊用戶端、關閉其系統代理並確認背景服務狀態,以免發生連接埠或路由衝突。安裝檔與架構說明統一列於用戶端下載頁;舊版使用者可先閱讀停止維護用戶端移轉說明,了解哪些設定可以沿用、哪些需要重新建立。

三、安裝與初步檢查:建立可還原的本機環境

確認架構與舊有環境

下載前先查看系統資訊,不要只憑電腦品牌判斷處理器架構。macOS 需分辨 Apple Silicon 與 Intel;Android 應依裝置支援的指令集選擇安裝包;Linux 則還要考量架構與發行版的套件格式。安裝包能下載不代表適用於目前裝置。若無法執行、格式不支援或架構不符,應先核對系統資訊,而不是不斷重複安裝同一個檔案。

安裝前記下原有的系統代理設定、正在執行的 VPN,以及公司網路的相關要求。如果之前使用過其他代理用戶端,先從其介面關閉接管功能並正常結束程式,必要時再檢查背景服務。尚未確認用途前,不要刪除舊設定目錄;移轉時,目錄中可能存有自訂規則與訂閱來源。較穩妥的做法是保留一份僅本機可存取的備份,再建立新用戶端的獨立設定。

依功能授予權限

在 Windows 中,一般系統代理與需要較高權限的 TUN 是兩回事。服務模式通常用來將需要權限的操作交由背景服務執行,實際設定位置由用戶端決定。安裝服務前應確認授權提示確實來自目前使用的產品;只是為了讓瀏覽器連線,不必一直以系統管理員身分執行整個介面。如果安裝目錄受組織政策限制,應請裝置管理員處理,不要透過停用安全機制規避管理要求。

macOS 首次啟動時可能需要同意應用程式許可並授權網路延伸功能;Android 與 iOS 通常會顯示系統 VPN 設定確認畫面。完成授權後返回用戶端,確認狀態確實已連線。Linux 圖形化用戶端也可能依賴桌面環境元件或系統服務權限。遇到缺少相依套件、權限不足等提示時,請保留完整錯誤訊息,依照發行版和用戶端說明處理,不要將所有啟動問題都歸咎於訂閱。

首次啟動只檢查基本項目

先找出設定、代理群組、連線和日誌頁面,確認知道如何開啟這些項目後,再匯入訂閱。監聽連接埠應以目前用戶端的設定為準;本指南中的 7897 僅為範例,不能據此認定所有產品的預設連接埠都是這個值。若連接埠遭占用,應查明占用程序,再決定結束舊服務或調整新連接埠。修改後也要同步更新曾手動設定代理的應用程式,避免它們繼續連到舊位址。

初次排錯時,可在本機終端機查看環境變數,確認命令列工具是否受到舊代理設定影響。不同終端機的檢查方式有所不同;以下命令只會讀取目前程序可見的變數,不會修改系統。若發現代理變數,還要確認它來自目前終端機工作階段、使用者設定檔還是開發工具,不能只關閉圖形介面中的開關,就認定這些變數也已清除。

# Linux / macOS:檢視常見代理環境變數
env | grep -iE '^(http|https|all|no)_proxy='

# Windows PowerShell:檢視目前程序的代理環境變數
Get-ChildItem Env: | Where-Object Name -Match '^(HTTP|HTTPS|ALL|NO)_PROXY$'

安裝完成的驗收標準不只是介面能開啟,還要確認設定可載入、監聽入口沒有衝突、接管功能可以關閉,而且能正常檢視日誌。先完成這些基本檢查,之後遇到異常時才有可靠的比對依據。Windows 的服務授權與開機自動啟動設定,可參閱Clash Verge Rev 安裝說明;其他用戶端不要直接套用同名選單。

四、訂閱與設定:分清遠端來源和本機修改

先確認輸入內容的類型

訂閱網址可能回傳完整的 Clash 設定,也可能是節點清單、編碼後的連結列表,或其他產品使用的格式。匯入前先查看提供者對格式的說明,優先使用明確標示適用於目前用戶端的入口。在用戶端的訂閱或設定頁面新增遠端設定,貼上網址後執行下載,再檢查載入結果。若出現解析錯誤,應先確認回傳內容是否為設定檔,而不是直接反覆重新整理節點。

訂閱連結通常包含可識別帳戶的參數,應比照帳戶憑證妥善保管。截圖、公開提問或複製日誌前,請遮蔽完整網址與驗證欄位;不要為了轉換格式,就將私人訂閱交給不熟悉的資料處理服務。教學中可用 https://example.com/sub?token=xxxx 表示網址格式,但這只是示例,不含實際訂閱內容,也不能用來連線。實際網址應只從獲授權的來源取得。

匯入後的檢查順序

下載完成後,先切換到新設定,確認它確實成為目前使用的項目。接著檢查代理群組是否存在、群組中是否有可選出口,以及規則是否引用了有效策略。有些用戶端顯示「訂閱已更新」,只代表檔案已儲存,核心仍可能因語法或引用錯誤而拒絕重新載入。請搭配目前設定的狀態標記與日誌確認實際生效結果,不要只看更新按鈕旁的成功訊息。

YAML 對縮排與結構很敏感,建議使用空格,避免混用定位字元。清單項目通常以連字號開頭,同一層級的縮排須保持一致;包含特殊字元的字串可加上引號。錯誤位置有時會出現在真正問題的下一行,因此要連同前後結構一起檢查。以下只展示設定結構,不包含代理節點,也不能直接取代完整訂閱檔;實際設定應保留來源提供的有效節點與策略。

# 結構範例:須與實際訂閱合併使用
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

將訂閱更新與個人化設定分開

直接編輯遠端訂閱檔的風險在於,下次更新時修改內容會被覆蓋。需要長期保留的規則、DNS 或連接埠調整,應優先放在用戶端支援的覆寫、合併設定或獨立規則檔中,並了解其套用順序。部分產品會先合併設定再產生最終檔案,另一些則透過指令碼修改設定物件;這些機制並不通用。修改後應檢查最終生效的設定,確認欄位沒有再次被訂閱中的同名項目覆蓋。

更新失敗時,請分別從網路、回應內容與設定解析三個方向排查。逾時或憑證錯誤通常發生在取得階段;若已下載卻出現 YAML 錯誤,應著重檢查回應是否變成登入頁面、到期通知或錯誤訊息;若節點存在但連線失敗,則應轉而檢查驗證資訊與出口。若目前已有可用設定,請先保留;來源暫時無法連線時,不要刪除本機快取,以免失去最後一份可運作的環境。

訂閱轉換是為了適配格式,無法讓失效節點恢復,也不能保證所有欄位都能完整對應。轉換後尤其要檢查代理群組名稱、規則順序與 DNS 設定,避免只剩節點卻遺失原有策略。最後應重新載入設定並實際測試連線;想先走簡化流程,可返回訂閱匯入教學,常見失敗原因則可參閱常見問題繼續排查。

五、代理模式與驗證:確認連線使用哪條路徑

規則、全域與直連改變的是策略

規則模式依照設定中的規則選擇出口,適合需要同時存取本機服務與遠端資源的日常使用環境。全域模式通常會將進入核心的連線交給全域策略,方便暫時確認某個出口是否可用;直連模式則讓進入核心的連線直接存取目標。這三種模式都不會自動確保所有應用程式都進入核心,因此開啟 Clash 全域模式後,某個應用程式仍可能完全繞過用戶端,首先應檢查流量入口。

開始驗證時,只保留一種主要入口。桌面裝置可先啟用系統代理、選擇規則模式,並在常用代理群組中選定一個明確的出口;行動裝置則先建立系統 VPN 連線。接著開啟一個已知可連線的測試目標,同時查看連線清單,核對目標網域、比對規則與最終策略。若頁面載入成功,連線清單卻沒有相應紀錄,應進一步檢查瀏覽器快取、連線重用,或應用程式是否使用了預期的入口。

用對照測試縮小排查範圍

瀏覽器與終端機不一定使用同一套代理設定。命令列可以明確指定本機 HTTP 代理,排除環境變數不同造成的影響,確認監聽入口是否正常。以下範例假設混合連接埠為 7897,請依目前設定替換後再使用。範例會連線至公開示例網域,只能證明這次請求的連線狀況,不能據此認定所有網站、協定與應用程式都正常。

# 明確透過本機 HTTP 代理
curl -I --proxy http://127.0.0.1:7897 https://example.com

# 明確略過代理,作為對照
curl -I --noproxy "*" https://example.com

若第一條命令顯示無法連線至本機連接埠,請檢查用戶端是否正在執行、連接埠是否正確,以及監聽是否已建立;若已連上本機但遠端請求失敗,再檢查所選節點、規則與日誌。若直連正常但代理失敗,可換另一個已知可用的出口進行比對;若兩者都失敗,也要考慮目標服務、目前網路與系統時間。一次測試不要同時修改節點、DNS、入口和規則,否則無法判斷哪項變更有效。

了解代理群組與連線重用

手動選擇群組適合需要固定出口的情境;自動測試群組會依設定中的探測條件選擇候選出口;故障切換群組則著重於目前候選項無法使用時自動切換。探測網址、間隔與容許誤差都會影響選擇結果;探測成功也不代表所有服務都能存取。排錯初期可暫時手動指定一個出口,減少自動切換造成的干擾,確認路徑後再恢復自動策略。

切換模式或節點後,已建立的長連線不一定會立即切換。瀏覽器連線集區、下載工作與即時通訊程式可能繼續使用舊連線。需要驗證新策略時,先重新發出請求;必要時在用戶端關閉相關連線,或重新啟動目標應用程式,不必每次都重開整台裝置。觀察連線建立時間與最終出口,比只看代理群組目前選取的項目,更能確認實際使用的路徑。

還要分清連線成功與隱私目標。連線透過代理,不代表 DNS、應用程式遙測與帳戶行為都受到相同保護;瀏覽器安全 DNS、應用程式內建解析和 UDP 流量可能需要另外檢查。若商店應用程式未依預期使用代理,可參閱Windows UWP 迴圈豁免說明,先確認應用程式類型與限制,再決定採用迴圈豁免或調整入口。

六、規則分流:依照可解釋的順序安排連線

先列出例外,再設定一般規則

分流規則通常會由上而下依序比對,第一條命中的規則決定後續策略,因此排列順序本身就是設定邏輯。常見的組織方式是:先處理明確的服務例外,再處理區域網路等位址範圍,接著套用涵蓋範圍較大的規則集合,最後設定預設兜底規則。不要把範圍過廣的直連或代理規則放在所有細項前面,否則後續條目即使語法正確,也可能永遠不會命中。

網域規則適合表達服務用途,位址規則則適合表達網路範圍。DOMAIN 比對完整網域;DOMAIN-SUFFIX 可涵蓋指定網域及其子網域;IP-CIDR 依位址範圍比對;GEOIP 使用地理位置資料判斷;MATCH 作為最後的兜底規則。網域後綴比對不是任意的字串包含;撰寫時應使用正確的網域邊界,避免將路徑、通訊協定前綴或查詢參數填入網域欄位。

先確認策略名稱,再檢查語法

規則的最後一項必須指向實際存在的策略。以下的 PROXY 是代理群組名稱範例,使用前請確認目前設定中確實有同名群組;否則應換成有效名稱。DIRECT 是內建的直連策略。範例呈現由具體到兜底的順序,並非適用所有人的完整規則清單;現有訂閱可能包含更細緻的服務規則,合併時應保留必要邏輯。

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

no-resolve 用來避免某些位址規則為了比對網域而額外觸發解析,並不代表停用所有 DNS。它可減少不必要的解析,但也表示只有在已具備目標位址等條件時,規則才能依預期進行判斷。地理位置資料也不能絕對代表服務的實際歸屬:內容傳遞網路、跨區域服務與位址配置變動,都可能讓僅依 GeoIP 設定的策略偏離實際需求。

規則集合與本機覆寫各有用途

規則數量增加時,可透過規則提供者維護集合,再使用 RULE-SET 引用。提供者通常需要宣告行為類型、取得方式、儲存路徑與更新間隔,集合內容必須符合宣告的類型。網域集合不能直接當成任意規則文字使用。初學時應先理解幾條手動撰寫的規則,再導入集合;否則發生錯誤分流時,很難判斷問題來自引用、下載失敗,還是集合本身。

新增規則後,先檢查最終生效檔案中的位置,再存取目標並查看連線詳情。若沒有命中,依序確認目標實際使用的網域、是否被前面的規則攔截、應用程式是否只提供了位址,以及是否仍在重用舊連線。網站通常會依賴多個網域,首頁命中代理但登入介面直連,仍可能造成服務無法使用。應依實際連線補上必要範圍,而不是直接將所有流量改成同一種策略。

長期維護時,應為自訂規則註明原因,並與訂閱內容分開保存。過期的例外可能讓服務長期繞過新策略,因此每次服務恢復或規則集合更新後,都應重新檢查是否還有保留的必要。Clash GeoIP 更新應納入資料維護,而不是當成每次網路中斷時的通用修復方法。遇到不熟悉的術語可查閱術語指南;重點是每條規則都能說明「為何放在這裡、要比對什麼、最後交由誰處理」。

七、TUN 與 DNS:先理解解析,再擴大接管範圍

TUN 解決入口問題,不會取代出口設定

TUN 透過虛擬網路介面與路由,將連線交給核心處理,適合不遵循系統代理的程式,以及需要統一處理更多協定流量的情境。它依賴系統權限、網路堆疊和用戶端實作,各平台使用的開關或參數不一定相同。桌面端啟用前,應先確認系統代理路徑正常,再暫停其他會修改路由的 VPN 工具,避免基本出口尚未驗證,就又增加一層故障因素。

啟用後,依序檢查虛擬介面是否建立、目標流量是否出現在連線清單、規則是否命中,以及區域網路資源能否正常存取。若同時使用公司 VPN、容器網路或虛擬機器,自動路由可能與它們的位址範圍衝突。此時應依實際網路設定排除範圍或改用其他入口,不要盲目反覆切換網路堆疊。遠端管理裝置時尤其要小心,調整路由可能會中斷目前的管理連線。

DNS 決定網域如何轉換為連線目標

應用程式可能使用系統 DNS、瀏覽器安全 DNS,或自行內建的解析機制。用戶端 DNS 設定只會影響進入其處理路徑的查詢,因此「已填入解析伺服器」不等於「所有查詢都會經過它」。排查 Clash DNS 外洩時,應先釐清哪些查詢需要走哪條路徑,再根據用戶端日誌與系統設定進行驗證;不能只靠一次網頁測試,就判定整部裝置的行為。

Fake-IP 會為網域指派保留位址範圍內的對應位址,由核心保存網域與連線之間的對應關係,以利後續分流。這些位址不是目標伺服器的真實位址,看到它們不一定代表解析異常。部分區域網路探索、裝置控制或需要驗證真實位址的應用程式可能不適用此機制;應依用途設定篩選條件或改用其他解析模式,優先縮小例外範圍,不要在不了解影響時就全面關閉解析處理。

# mihomo 局部範例:先確認監聽連接埠與平台支援
dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - https://dns.alidns.com/dns-query

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

這段設定必須合併到有效的 mihomo 設定中,並非所有圖形化用戶端都適用;用戶端也可能透過介面重新產生這些欄位。DNS 僅監聽本機連接埠,不會自動修改系統解析設定;TUN 接管 DNS 也不代表能接管應用程式自行建立的加密解析連線。範例中的上游伺服器只是選項,未必適合所有網路;選用前應考量連線可用性、信任關係與所在地網路規範。

發生故障時,依影響範圍回復設定

若開啟 TUN 後所有連線都失敗,先關閉 TUN 並回到之前已驗證的入口,確認基本網路能否恢復,再檢查權限、路由與 DNS 日誌。若只有內網網域無法使用,應核對內網解析器、搜尋網域與路由,而不是直接更換遠端節點。若只有特定應用程式異常,可比較系統解析、應用程式解析與 Fake-IP 例外,找出差異。行動裝置還須考量背景執行策略,相關設定可參閱Android 耗電與背景執行排查。

八、日常維護:更新、備份與故障紀錄

分清四種更新項目

用戶端更新、核心更新、訂閱更新與規則資料更新是不同操作。用戶端更新會影響介面與系統整合;核心更新可能改變協定支援或欄位行為;訂閱更新會調整節點與來源設定;GeoIP、GeoSite 或規則集合更新則會影響比對結果。出現變化時,先確認更新的是哪一項,不要將所有異常都籠統歸因於「軟體升級」。維護紀錄不必複雜,但應能還原變更前後的主要差異。

環境穩定時,不要一次更新所有元件,還順手重寫 DNS。先備份,再逐項變更,每完成一項就驗證常用服務。若桌面用戶端支援獨立切換核心,也應先閱讀相容性說明,不要只憑檔名替換執行檔。保留上一份可用設定,比保留一堆來源不明的舊安裝包更重要;回復時也要考量設定語法,舊版核心未必能讀取新增欄位。

備份不只要存檔案,也要記錄設定目的

有效的備份應包含訂閱來源、自訂規則、覆寫內容、代理群組選擇與必要的系統整合說明。用戶端匯出的設定可能包含節點密碼與訂閱憑證,存放時應限制存取權限,不要提交到公開程式碼儲存庫。系統代理、開機啟動與服務安裝狀態不一定會包含在匯出檔中,因此更換裝置後仍須重新授權並檢查連接埠。備份檔案存在,不代表已經確認可以還原。

可以在不影響日常使用的情況下測試還原:建立暫存設定、匯入備份、檢查策略引用和規則順序,再切回原本設定。跨用戶端移轉時,先還原通用 YAML 內容,再依新產品的方式重建覆寫與系統設定。不要將整個資料目錄直接覆蓋到新用戶端;舊快取、資料庫或用戶端專屬欄位可能不相容。移轉完成後仍應保留原始備份,直到常用情境都通過驗證。

排錯紀錄應聚焦於一次具體故障

發生故障時,先記下發生時間、目標應用程式、目標網域、目前入口與所選策略,再重現一次。暫時提高日誌詳細程度時,請留意磁碟空間與敏感資訊外洩;排查結束後應恢復適當等級。公開回報只保留必要的錯誤背景,並遮蔽訂閱、驗證資訊與個人路徑;同時保留錯誤類型,若刪減到只剩「連線失敗」,就會失去判斷價值。

現象先確認下一步
所有應用程式都無法連線基本網路、入口、核心狀態關閉接管,進行直連比對
只有一個網站無法連線目標網域、規則與出口檢查相關網域與連線重用
更新後無法載入錯誤行與欄位相容性還原備份並逐項比對

Clash 開機自動啟動也需要另外驗收:重新啟動後確認用戶端是否啟動、背景服務是否可用、設定是否載入,以及接管方式是否符合預期。有些應用程式會在登入後才啟動,有些服務則會先於桌面執行,不能用同一套標準判斷。自動更新訂閱也要考量首次連網條件;若下載訂閱需要依賴尚未恢復的代理路徑,應保留本機有效設定,避免啟動後陷入取得設定與建立連線互相依賴的狀態。

故障排除後,請撤銷臨時全域模式、除錯日誌與範圍過大的例外規則,並記下問題原因及處理結果。不要將排錯時的應急設定永久留在環境中。若問題反覆發生,可先到常見問題依基本觀念、安裝設定、使用技巧與故障排查尋找相關項目;需要進一步求助時,提供可重現的步驟與已遮蔽敏感資訊的設定片段,會比只附上一張失敗截圖更有幫助。

九、進階路線:從可用設定打造易維護的環境

以可驗證的目標為準,不以開關數量衡量

完成前八章後,進階重點不是啟用所有功能,而是讓設定易於理解、移轉與還原。先選定一個明確目標,例如讓工作服務固定使用某個策略、讓一組裝置採用獨立出口,或將重複規則整理成集合。為目標訂出驗收條件,再決定需要哪些欄位。若現有規則已經解決問題,繼續加入嗅探、指令碼與複雜群組鏈,反而會增加維護成本並擴大排錯範圍。

第一階段可將設定分為基本監聽、DNS、節點來源、代理群組與規則五個部分,並註明各部分由誰維護。遠端訂閱負責提供節點,本機覆寫處理個人需求,規則提供者管理可重複使用的集合;這種職責劃分比直接保存一個龐大的檔案更清楚。若用戶端會自動產生設定,也要了解輸入檔與最終檔案的差異;最終檔可用來檢查結果,卻不一定適合作為長期編輯的入口。

先做靜態檢查,再驗證實際服務

獨立使用 mihomo 時,可先透過設定檢查確認語法與引用關係,再啟動實際網路接管。以下命令假設執行檔已加入命令搜尋路徑,而且目前目錄中有待檢查的設定檔。通過檢查只代表核心接受檔案,不代表節點憑證有效、上游解析可連線,或路由符合需求。若圖形化用戶端提供設定驗證功能,應優先使用產品支援的入口,不要隨意操作內部工作目錄。

# 獨立 mihomo:檢查目前設定
mihomo -t -f ./config.yaml

# 獨立 mihomo:指定設定檔執行
mihomo -f ./config.yaml

接著建立一份精簡的回歸測試清單:一個直連目標、一個代理目標、一項區域網路服務,以及實際需要的 UDP 或長連線服務。每次修改後,分別檢查入口、規則與出口是否符合預期,並記錄結果。測試目標應由使用者依實際環境決定,不要將公開探測位址的結果直接視為業務服務品質。對於登入、付款或需要固定地區的服務,也要留意切換出口可能觸發帳戶風控或使工作階段失效。

自動化與遠端管理需要嚴格控管範圍

使用控制介面或管理面板前,先確認監聽範圍與存取驗證方式。若只需在本機管理,應將監聽限制於迴圈位址;不要只為了讓手機存取面板,就將管理連接埠開放給所有網路介面。若確實需要區域網路管理,還須搭配存取控制與防火牆,並了解代理監聽與控制介面是不同服務。開放區域網路連線不等於授權所有裝置使用,必須依實際需求限制網路暴露範圍。

在伺服器與路由器上部署,還需要了解服務的生命週期:以哪個使用者身分執行、從哪個目錄讀取資料、重新啟動後能否恢復、日誌如何輪替,以及異常結束時如何處理。涉及透明代理、防火牆轉送與策略路由時,應另外設計還原方案,避免直接在同一台遠端裝置上試用不熟悉的路由規則。先在可就近操作的測試環境中驗證,再部署至長期運作的裝置,有助於降低失去連線的風險。

持續學習時,優先查閱目前核心與用戶端的設定說明,尤其留意欄位所屬層級、預設行為與相容性限制。舊文章可以幫助理解原理,但不能取代對目前生效設定的檢查。需要複習時,可從本頁核心概念重新梳理流量路徑;需要重建環境時,回到快速入門流程。能說明每項設定要解決什麼問題、如何驗證及如何撤銷,才代表設定從「暫時可用」進一步達到「長期易於維護」。