CONFIG.YAML / 欄位手冊

Clash 設定檔欄位參考

從 YAML 載入到規則命中:欄位型別、引用關係與生效範圍。

使用指南適合初次匯入與確認連線;本頁則依欄位整理寫法與排錯依據。還沒有可用的設定檔時,先跟著指南完成設定;遇到連接埠、解析或分流問題,再用下方目錄查找。本文以 mihomo 為參考,用戶端介面選項與覆寫機制請以實際產品為準。

01 YAML / STRUCTURE

YAML 結構、欄位型別與引用

先看頂層,再追查流量路徑

Clash 設定檔的頂層是映射結構,不是依檔案行號執行的一連串命令。先把頂層欄位視為入口索引:連接埠與執行模式決定請求如何進入核心;DNS 區段決定內建解析器如何回覆查詢;節點區段描述連線方式;策略群組列出可選的出口;規則區段則決定連線交由哪個出口處理。把規則區段移到檔案開頭,不會讓規則比核心初始化更早執行;但把某條規則移到同一清單的前面,確實可能改變最後的分流結果。因此,比較兩份檔案時,應分清頂層欄位的位置與清單項目的先後順序。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
  - name: 手動出口
    type: select
    proxies:
      - DIRECT
rules:
  - DOMAIN-SUFFIX,example.org,手動出口
  - MATCH,DIRECT

這份完整範例沒有遠端節點,適合先確認檔案能否載入,以及本機入口是否正常。規則比對到目標網域後,會先嘗試將連線交給名為「手動出口」的群組;群組內只有直連,其他請求也會由最後一條規則直連。用這份設定測試時,網頁能開啟只代表直連路徑可用,不代表已連上代理伺服器。若要確認特定規則是否命中,應一併查看用戶端的新連線記錄,不要只憑網頁是否開啟來推斷分流結果。若範例連接埠已被其他代理軟體使用,先改用未占用的連接埠,再讓測試應用程式連到同一個連接埠。

釐清同名欄位所在層級

同一個鍵在不同層級可能代表不同內容。頂層的 proxies 是節點物件清單;策略群組內的 proxies 則是成員名稱清單。前者每個項目都要寫成一組屬性,後者每個項目只寫一個名稱。若不小心把節點物件縮排到群組成員底下,即使文件仍是合法的 YAML,核心也可能因欄位型別不符而拒絕載入。修改群組名稱後,也要搜尋其他群組與規則中的引用;只改定義、沒改引用,原本可載入的文件可能就無法套用。

欄位資料型態編輯時先確認
mixed-port整數是否符合用戶端實際使用的入口
dns映射各鍵是否縮排在同一個父鍵之下
proxy-groups物件清單名稱及所有成員是否都能被引用
rules字串清單清單順序是否符合比對優先順序

分別檢查語法、設定驗證與執行結果

語法錯誤先檢查縮排、引號與清單標記;欄位錯誤再檢查型別與引用。請用空格縮排,不要用定位字元;同一父鍵下的同層欄位要對齊,清單項目的連字號後要留空格。值中若有可能被當成註解的井字號,或出現冒號後接空格,請用引號標示字串範圍。連接埠與布林開關應維持相應型別,只有原本就應是字串的值才視需要加上引號。直接複製帶格式的文字時,也要留意全形冒號與彎引號;它們看似相近,卻不能取代 YAML 的語法符號。

設定錯誤訊息提供的行號,是解析器發現問題的位置,不一定是最初寫錯的那一行。若某行顯示缺少鍵,先回頭檢查上一個項目的引號是否未閉合,或子項是否少縮排一層。YAML 解析成功後,再檢查是否有重複的頂層鍵、名稱衝突或未知引用。同一個映射中出現兩份規則鍵,不代表核心會合併兩份清單;不同的解析流程可能會拒絕或覆蓋其中一份。編輯時應讓同一層的鍵只保留一處。

最後要以執行結果確認修改的是實際生效的檔案。用戶端可能顯示已下載的訂閱副本,但目前載入的其實是另一份本機設定;也可能因新設定驗證失敗而繼續使用上一份。記下目前的設定名稱、套用時間與一筆新連線的比對結果,再和預期結果核對。既有連線可能仍沿用建立時的出口;切換設定後,請重新發起請求。初次匯入檔案或訂閱時,先依設定匯入步驟確認目前啟用的項目,再開始排查欄位。

02 INBOUND / MODE

通用欄位:連接埠、監聽與執行模式

先確認應用程式連到哪個本機入口

入口連接埠描述的是應用程式到核心之間的連線,不是代理伺服器的連接埠。port 用於 HTTP 代理,socks-port 用於 SOCKS 代理,mixed-port 則在同一個連接埠接受這兩種入站協定。剛開始除錯時,保留一個入口會更容易判斷問題:瀏覽器或系統代理使用 HTTP 時,位址與連接埠必須對應 HTTP 或混合入口;只有支援 SOCKS 的程式才應使用相應的 SOCKS 設定。若應用程式同時儲存了自動設定網址與獨立的手動代理,請先確認實際採用哪一種。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

範例將混合入口限制在本機使用。用戶端的系統代理功能通常只是協助系統將代理指向核心,不代表所有程式都會跟著使用。有些應用程式有獨立的網路設定,有些服務會從環境變數讀取代理位址,另有程式使用自己的連線方式。要確認某個程式是否透過代理連線,先單獨發起一筆新請求,再查看用戶端連線資訊中是否出現對應的目標。若連線記錄完全沒有項目,應優先檢查應用程式的代理設定、系統例外清單與監聽連接埠,而不是反覆切換策略群組。

先排除監聽衝突,再調整可存取範圍

同一個位址上的同一個連接埠,不能任意分配給多個相同類型的監聽服務。設定中若同時讓 HTTP 入口與混合入口使用相同連接埠,或兩個用戶端同時接管相同連接埠,都可能導致綁定失敗。若啟動記錄顯示位址已被占用,先確認失敗的是混合入口、控制介面還是內建 DNS 監聽,不要一概修改節點連接埠。確認占用來源後,停用不再使用的監聽服務,或為這份設定選擇未占用的連接埠,並同步更新作業系統與應用程式中儲存的代理位址。

僅供本機使用時,保留 allow-lan: false 即可。若確實需要與區域網路共用,應另外確認允許範圍、監聽位址與防火牆規則,並在可信任的網路中驗證存取來源。也要分清 external-controller 與代理入口:前者供面板或程式管理核心,後者才負責接收代理請求。介面能連上控制介面,只能代表控制通道可連線,不能證明業務連接埠已成功監聽。在公共網路或接入範圍不明的環境中,讓管理與代理入口僅供本機使用,更容易控管存取範圍。

模式決定是否套用規則,不決定哪些連線會進入核心

規則模式會依清單為進入核心的連線分配出口;全域模式使用全域策略中選定的出口,不會逐條比對一般規則;直連模式則讓進入核心的一般代理流量直接連線。三種模式改變的是核心內部的處理路徑,不會自動替應用程式開啟或關閉代理。排查時可暫時切換模式進行比較:若同一個請求在直連模式下正常,改用指定出口後卻失敗,先檢查該出口及其解析依賴;若只有規則模式選錯出口,再回頭檢查命中的規則與群組選擇。測試完成後請恢復原本模式,避免誤以為規則仍在生效。

記錄層級應配合明確的排查目標。平時保留足以辨識啟動失敗的記錄;需要追查連線時,再短時間提高詳細程度並縮小測試範圍。一次只開啟一個目標並記下時間,分辨啟動錯誤、入站連線、網域解析與出站連線。路徑正常但網頁仍載入緩慢時,也要分清首次建立連線與既有連線後續傳輸的差異,不能只看單筆記錄就歸因於連接埠。對外分享記錄前,請刪除訂閱網址、內部主機名稱與帳戶相關欄位;保留錯誤類型及必要的連接埠資訊即可。

03 DNS / RESOLUTION

DNS 設定:上游、引導解析與 Fake IP

先確認查詢是從哪裡發出

dns.enable 啟用的是核心 DNS 模組,不等於修改整個系統的 DNS。應用程式可能先向作業系統查詢,再將位址交給代理入口;也可能直接把目標網域交由核心處理。還有些應用程式會使用自己的加密 DNS,不經過系統預設路徑。排查時應分開記錄「哪個元件發起查詢」與「哪台解析器回覆查詢」。即使一般網頁能開啟,也不能據此判定所有應用程式都使用相同的上游;同樣地,查詢取得位址也不代表連到該位址的連線已成功。

dns:
  enable: true
  enhanced-mode: redir-host
  default-nameserver:
    - 1.1.1.1
  nameserver:
    - https://cloudflare-dns.com/dns-query
  proxy-server-nameserver:
    - 1.1.1.1

範例使用 redir-host 回傳實際位址,以加密 DNS 處理一般查詢,並明確區分引導上游與節點解析上游。這種寫法要求本機能連線至範例解析器;受管理的網路環境應改用管理員允許且目前網路可連線的上游。default-nameserver 主要用於引導解析以網域名稱表示的 DNS 服務。若加密查詢位址以網域名稱表示,卻又依賴尚未建立的加密查詢來解析自身,就可能形成循環。引導位址使用可獨立連線的數字位址,可將這個環節從主要解析路徑中拆開。

一般網域與節點網域不一定走相同路徑

nameserver 是預設解析上游;nameserver-policy 可為指定網域選用不同上游;proxy-server-nameserver 則用來解析代理節點伺服器的網域。若節點以網域名稱而非 IP 位址設定,核心必須先取得其位址,才有辦法建立連線。若該網域的解析查詢又被安排經過尚未連線的節點,首次連線就可能卡住。診斷這類問題時,先確認節點網域能透過獨立的解析路徑取得結果,再檢查取得的位址是否能建立連線。只反覆修改一般上游,很容易忽略節點解析這一層。

解析內部服務時,宜明確指定網域範圍,不要把公司內部網域交給公共解析器碰運氣。內外兩組上游可能對同一個名稱提供不同結果;公共上游查不到記錄,也不代表內部記錄不存在。調整網域策略後,分別測試一個內部網域與一個外部網域,確認回傳位址是否符合預期。切換網路後,原本可連線的內部 DNS 可能已無法使用;若內外網域都解析失敗,先恢復可正常運作的最小設定,再逐項加入指定策略,不要一次替換所有上游。

Fake IP 是映射位址,不是服務的實際位址

fake-ip 模式會向查詢端回傳合成位址。核心收到連往該位址的連線後,再依映射還原原始網域。要讓這條路徑正常運作,取得合成位址的應用程式所發出的連線,必須能回到負責該映射的核心。若請求離開了接管範圍,或系統快取了切換設定前的位址,應用程式可能取得無法依一般方式路由的位址。若本機裝置探索或內部服務發生異常,先確認該情境是否適合使用合成位址,再考慮透過 fake-ip-filter 讓所需名稱回傳實際記錄,避免將所有網域都加入例外。

切換增強模式後,請用同一個應用程式重新發起查詢與連線,避免快取掩蓋差異。可分別確認三件事:查詢是否收到回覆、連線是否正確關聯目標網域,以及規則是否依預期選到出口。第一項失敗,先檢查上游是否可連線;第二項失敗,先檢查應用程式的解析來源與接管範圍;第三項失敗,才檢查規則順序。若記錄先出現解析逾時,網頁隨後顯示連線失敗只是下游症狀。若節點或系統代理也有疑問,可參考節點逾時的分層排查順序,逐步縮小範圍。

04 PROXIES / OUTBOUND

代理節點欄位與連線邊界

先區分節點顯示名稱與連線參數

一個節點是建立單一出站連線所需的參數集合。name 是設定中的引用名稱,type 用來選擇協定,server 與 port 則標示實際連線位址。節點名稱可使用方便辨識的文字,但必須與策略群組中的引用一致,也不應與其他出口名稱衝突。修改節點顯示名稱不會改變遠端伺服器,也無法修復連線失敗;反過來說,替換遠端參數但保留原名稱,策略群組通常仍會引用該節點。修改設定前,先確認要改的是顯示名稱,還是實際連線條件。

proxies:
  - name: 本機測試出口
    type: socks5
    server: 127.0.0.1
    port: 1081
    udp: false
proxy-groups:
  - name: 節點檢查
    type: select
    proxies:
      - 本機測試出口
      - DIRECT
rules:
  - DOMAIN-SUFFIX,example.org,節點檢查
  - MATCH,DIRECT

這段範例依賴另一個已在本機執行的 SOCKS5 服務,而且該服務會在範例連接埠接受連線。它不是內建節點,也不會替你啟動服務。若本機沒有這項服務,請保留直連作為比較,或將節點換成自己獲准使用的代理。不要把伺服器連接埠填成本設定自己的混合入口;這會讓出站連線回到入站,無法作為獨立的測試路徑。套用設定後,請在群組中明確選取測試出口,再造訪範例網域,避免把群組中儲存的直連選項誤認為節點已正常運作。

分別確認協定、傳輸方式與身分驗證

不同協定的附加欄位不能只看名稱推測。有些協定使用使用者名稱與密碼,有些需要協定專用識別碼;有些在傳輸層啟用 TLS,有些還需要與伺服器端一致的傳輸選項。應先依節點來源提供的欄位清單設定協定,再確認位址、驗證方式與傳輸參數。能連上伺服器,只代表位址與連接埠可達,不代表驗證已成功。若記錄已指出交握或身分驗證錯誤,請檢查名稱、時間與伺服器憑證設定,不要透過關閉驗證來掩蓋問題。

連線位址與憑證比對的伺服器名稱可能不同。若伺服器確實要求特定名稱,應填入該協定支援的欄位,不要把節點顯示名稱當成交握名稱。同樣地,傳輸選項中的路徑也不是訂閱網址:訂閱網址用於取得整份設定,路徑則是節點連線參數的一部分,兩者影響範圍不同。確認設定來源時,請查看正常匯入後的實際設定,避免把分享連結中經過編碼的字串直接貼進不接受該格式的欄位。比較多份設定時,只比較相同協定中的同類欄位。

用單一出口區分網路故障與選擇錯誤

排查 UDP 時應另外驗證。欄位允許 UDP,只代表核心在這個出站連線上的行為,不保證代理伺服器、底層傳輸方式與目標應用程式都支援相同流量。網頁透過 TCP 連線成功,不代表語音或即時應用程式也能正常運作;反過來說,將 UDP 測試失敗視為節點整體故障,也可能誤判正常的網頁連線。先用單一手動群組確認基本出站連線,再透過確實會發出 UDP 的應用程式觀察新連線記錄,分別記下協定、目標、命中規則與所選出口,不要用一次網頁測速取代整條路徑的驗證。

節點載入失敗時,先保留一個可重現的最小設定物件;若群組可見但個別連線失敗,再依錯誤發生階段檢查參數。解析失敗可能與節點網域有關;連線遭拒通常指向連接埠或服務狀態;交握逾時則也可能涉及網路路徑或傳輸參數,無法只憑症狀判定原因。清除節點前,先搜尋名稱是否出現在多個策略群組或規則中。若要先確認用戶端是否具備所需核心,可前往下載中心,依平台優先查看首推的 Clash Plus,再確認該產品實際支援的欄位。

05 PROXY-GROUPS / SELECTION

策略群組類型、成員與健康檢查

策略群組負責管理出口,不會取代規則比對

規則負責將連線交給某個出口或策略群組;群組則負責從成員中選出實際出口。若規則命中正確但連線走錯路徑,應同時檢查命中的群組名稱與群組目前選用的成員。建議先在單層手動群組中驗證實際節點,再加入自動群組;若一開始就把多個自動群組互相套用,健康狀態、測試結果與使用者選擇會同時影響結果,難以判斷單筆連線最後走哪個節點。群組名稱適合說明用途,例如「工作連線」或「備用出口」,不要使用容易在更新後失效的節點名稱。

proxy-groups:
  - name: 自動出口
    type: url-test
    proxies:
      - 本機測試出口
    url: 'https://example.org/'
    interval: 300
    tolerance: 50
  - name: 手動入口
    type: select
    proxies:
      - 自動出口
      - DIRECT

這段內容應用來取代整份頂層策略群組清單,不要在原檔中再新增第二個同名頂層鍵。節點來自上一章;若要沿用上一章的規則,也要把規則中的「節點檢查」改為「手動入口」。此處只放一個節點來示範語法,因此不會在候選項目間切換。測試網址僅供範例使用,實際部署時宜選擇輕量、穩定、預期回應明確,而且各候選路徑都能連線的網址。自動群組會向這個網址發送探測請求;測得的不是測試電腦到節點伺服器之間的單程延遲,也不能代表其他業務網站的連線狀況。

依切換需求選擇群組類型

類型選擇依據適用情境
select由使用者選擇手動指定路徑、固定出口排查
url-test探測結果與容差比較各候選項目的探測回應
fallback成員順序與可用性優先使用主要出口,失效時改用備用出口
load-balance負載分配策略在多個可用成員間分配連線

需要固定主要出口時,使用 fallback 表示優先順序,不要把它當成最快節點選擇器。需要依探測結果比較時,url-test 的容差可避免因些微差異而頻繁切換出口;tolerance 以毫秒為單位,interval 則以秒設定探測間隔。探測間隔太短會增加探測流量,太長則可能延後發現狀況變化。先觀察不同時段的實際波動,再調整這兩個欄位,不必只因單次探測結果就重寫整個群組。

load-balance 分配的是連線,不會把單一下載請求拆分到多個節點。需要維持工作階段的服務可能對出口變動很敏感,適合單獨導入固定群組,而不是和其他連線共用輪替策略。若要在不同方案間取捨,先確認想維持的是主備優先順序、連線親和性還是平均分配,再參考自動策略群組選型與欄位比較。切換群組前後,請以相同目標發起新連線並多次觀察;既有連線不適合用來判斷切換是否成功。

群組引用應維持單向關係

群組可以包含其他群組,但不能直接或間接引用自己。由面向規則的入口群組引用下層自動群組,再由自動群組引用節點,是較容易檢查的結構。透過代理集合提供成員時,群組中的 use 引用的是提供者名稱,不是其中任一節點的名稱。若群組啟動後沒有可選成員,先確認本機定義與引用是否存在,再檢查集合是否載入成功、篩選條件是否排除了所有成員,最後才檢查探測失敗。群組已定義但沒有成員,與有成員但全部無法連線,是兩種不同問題。

判斷自動群組異常時,先在獨立的手動群組中使用相同候選節點與相同目標網址。若手動連線也失敗,應優先排查節點路徑;若業務連線正常但探測失敗,則確認探測網址是否受目標網站限制、該出口的回應是否符合預期,以及探測是否已執行。部分用戶端會保留手動群組上次的選擇,修改 YAML 不代表介面會自動切回第一個項目。每次記錄設定中的候選順序、實際選擇與探測時間,才能分辨設定變更與用戶端保留的執行狀態。

06 RULES / MATCH ORDER

規則語法、命中順序與兜底

先比對範圍較小的規則,再放寬範圍

在規則模式下,規則清單會由上往下處理,第一條命中的規則就決定出口。精確網域規則應排在涵蓋範圍更廣的後綴規則之前;範圍較小的網段也應排在涵蓋它的較大網段之前。設定的重點不是規則越多越好,而是範圍與優先順序清楚易懂。新增規則前,先確認是否已有較前面的廣泛規則涵蓋相同目標;若有,應把新例外排在它前面。若將例外放在最後一條兜底規則之後,即使設定成功載入,也不會產生預期的分流效果。

mode: rule
proxy-groups:
  - name: 文件出口
    type: select
    proxies:
      - DIRECT
rules:
  - DOMAIN,upload.example.org,DIRECT
  - DOMAIN-SUFFIX,example.org,文件出口
  - IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
  - MATCH,DIRECT

範例第一條只比對上傳子網域,第二條涵蓋範例主網域及其子網域,第三條示範位址範圍的比對寫法,其中的網段是文件專用保留位址。最後一條規則會接手未符合前面條件的連線。範例群組只有直連成員,因此要查看連線記錄中的規則或策略路徑,才能分辨前兩條規則的差異。MATCH 不需要網域或網段參數,只要指定出口。此寫法中,包含逗號的整條規則是 YAML 清單的一個項目;不要用多個連字號把條件與策略拆成不同項目。

目標網域、連線位址與資料來源是三種判斷依據

網域規則仰賴核心能取得或還原目標網域。若應用程式只傳遞數字位址,沒有可用的網域資訊,網域規則就不會自行命中。IP-CIDR 會依位址範圍比對;遇到只有網域名稱的目標時,某些 IP 類規則可能會觸發解析。支援的規則類型可以加上 no-resolve,避免只為這條比對額外發起查詢;若已取得目標位址,仍可依位址進行比對。加入此選項後,應分別以網域名稱與數字位址測試,否則很容易把「未解析就無法判斷」誤認為網段設定錯誤。

GEOIP 依據地理位置 IP 資料庫判斷,不會根據網域後綴推測地區;RULE-SET 則引用已在 rule-providers 中定義的集合。資料庫更新後,相同位址的分類可能改變。規則集合也有自己的行為類型與資料格式,檔案下載成功不代表核心已成功讀取其中的規則。將這兩種條件加入正式清單前,先確認資料已由目前設定載入,再分別測試涵蓋與未涵蓋的目標。故障排除 FAQ可先用來查詢更新失敗、節點異常與分流不符等常見狀況。

用正例、反例與兜底案例確認順序

每次驗證至少涵蓋三種目標:應命中精確例外的目標、應命中較廣條件的同類目標,以及應略過前序規則並落到兜底的目標。先記下每個目標預期命中的規則與出口,再建立新連線。若精確目標被廣泛規則接手,請檢查規則順序;若兩個網域都落到兜底,請確認目標值、核心是否能看到網域,以及目前是否使用規則模式;若規則正確但出口不符,再檢查群組成員。網站可能同時連線多個子網域與第三方資源,排查時應逐筆檢查連線,不要把網址列中的主網域當成整個頁面的唯一目標。

修改兜底規則前,先確認未分類流量應如何處理。使用 DIRECT 作為兜底,方便隔離已知規則的影響,適合用來驗證設定;正式使用時,應依網路與業務需求選擇明確的兜底出口,並檢查常用應用程式在此路徑上的表現。儲存變更時,也要記下哪條規則因修改而提前接手。日後移除臨時例外時,才能確認它原本取代了哪條路徑,不必只靠記憶整理。對於經常更新的外部規則集,保留一兩個可重複驗證的目標,更新後以相同順序重新檢查。

07 OVERRIDES / EFFECTIVE CONFIG

設定覆寫、合併與還原

分開保存原始訂閱、本機修改與有效設定

排查修改未生效時,應比對核心實際載入的設定,而不是只看編輯器中的訂閱副本。用戶端可能先取得基礎訂閱,再合併本機覆寫,最後依介面設定補上執行參數。覆寫檔並非所有用戶端共用的核心語法;必須先確認產品提供的是整份取代、依鍵合併、清單追加、指令碼處理,還是其他機制。若產品沒有相應功能,在 YAML 中自行新增合併指令,不會讓核心自動執行。

保留未修改的訂閱來源,另外儲存一份本機設定供驗證。只需修改入口時,可用下方 YAML 作為修改清單,或依支援映射式覆寫的用戶端規則套用。請勿將這段內容單獨當成原設定的替代檔案,否則原有節點、群組與規則都不會一併載入。先套用這兩項設定,確認實際監聽狀況符合預期,再繼續修改 DNS 或規則。分批套用多項修改的好處是,發生問題時能判斷是哪一次變更造成行為不同。

mixed-port: 7891
allow-lan: false

合併前先確認值的資料型態

連接埠是純量,替換後通常只需同步更新使用該連接埠的應用程式;DNS 區段則是巢狀映射,有些工具會逐一合併子鍵,有些則會用新區段完整覆蓋舊區段。因此,只修改增強模式也可能意外刪除既有上游或內部網域策略。正確做法是檢查產生的設定中舊欄位是否仍然存在,並重新測試一個原本可解析的內部目標。不要用空值測試刪除行為:欄位不存在、空清單與 YAML 空值是不同狀態,用戶端與核心也可能分別處理。

清單還需要確認項目是被取代、插入前端還是追加到後端。尤其是規則清單,合併後所有項目都存在,不代表順序正確。下方示範的是保留舊規則時的最小結果:第一條是新增例外,第二條與兜底規則來自基礎設定。若工具只支援整段取代,應將需要保留的舊項目一併放入最終清單;若工具支援插入前端,只提交新項目,避免重複加入舊規則。例外本身也必須引用現有出口,不能只因兩份 YAML 都能讀取,就認定合併後一定能載入。

rules:
  - DOMAIN,status.example.org,DIRECT
  - DOMAIN-SUFFIX,example.org,文件出口
  - MATCH,DIRECT

用載入測試確認結構,用還原測試確認操作流程

若獨立使用 mihomo,且本機已有可執行檔,可用測試模式檢查準備載入的完整設定。在用戶端環境中,優先使用用戶端提供的驗證功能;若改用命令列,工作目錄與所需規則資源應和實際部署一致,否則外部資源相關錯誤可能只是測試環境不同所致。測試通過後仍需重新載入設定,並確認監聽、網域解析及一筆新連線的出口。靜態測試無法保證遠端節點或解析服務可連線,也不能取代作業系統代理的接入驗證。

mihomo -t -f ./config.yaml

訂閱更新前後,應留意名稱與順序的變化。更新可能刪除節點、變更節點名稱,或將策略群組成員替換成另一批項目。若本機覆寫依節點名稱綁定,更新後可能找不到引用;若策略群組從提供者取得可用候選項目並套用篩選條件,則應重新確認篩選結果。需要在多部裝置間共用設定時,建議將節點、群組與規則列為共用部分,並將監聽連接埠等環境設定留在各裝置的本機層;詳細取捨請參閱多裝置設定同步方案比較。

備份應能區分更新前的基礎檔案、本機覆寫與用於還原的有效設定。每次修改都應附上一則簡短說明,包含修改目的、影響範圍與驗證結果,例如「調整監聽連接埠,瀏覽器已使用新連接埠完成連線驗證」。若有效設定包含帳戶資訊,應限制存取,不要將原始檔案直接附在公開問題中。如此一來,即使訂閱更新與本機修改恰好發生在同一天,也能先恢復已知可用的路徑,再從修改記錄找出造成差異的步驟。

下載 Clash