Clash config.yaml 設定檔結構解析:從連接埠、DNS、proxies 到 rules
依設定檔順序解析通用連接埠、運作模式、DNS、proxies、proxy-groups、rule-providers 與 rules,並整理常見設定錯誤。
通用連接埠與運作模式:先確認流量入口
判斷設定是否生效,先確認應用程式連線到哪個入口,再查看核心如何分流。以下以 mihomo 為例。舊版 Clash 與 mihomo 支援的欄位不同;用戶端版本也不代表核心版本。獨立執行時,可用 mihomo -v 查看核心版本;圖形介面用戶端則以顯示的核心資訊為準。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
mixed-port 同時接受 HTTP 與 SOCKS 代理連線。依照此範例設定應用程式時,代理位址填入 127.0.0.1,連接埠填入 7890,再依應用程式支援的選項選擇協定。若設定使用獨立的 port 和 socks-port,兩者分別對應 HTTP 與 SOCKS;請勿將 DNS 監聽連接埠或控制介面連接埠填入應用程式的代理欄位。此處的 7890 僅為範例,並非所有用戶端通用的固定連接埠。
mode: rule會依rules進行比對;測試網域規則前,請先確認目前運作模式為 Rule。mode: global使用全域策略組目前選取的項目,不會依一般規則清單分流。mode: direct會讓進入核心的連線直連;這不等於關閉系統代理,也不代表退出核心。
是否啟用系統代理,以及應用程式是否遵循系統代理,屬於設定以外的因素。TUN 則透過虛擬網卡接管符合路由條件的流量,設定位於獨立的頂層 tun 區段。修改 mixed-port 不會啟用 TUN;啟用 TUN 後,也不能只憑瀏覽器能開啟網頁,就判斷某個應用程式採用了哪條連線路徑。
DNS:區分監聽位址、上游伺服器與 Fake-IP
dns 是頂層映射。enable 用來啟用核心 DNS 功能,listen 指定核心接收 DNS 查詢的位址,nameserver 則列出用於解析的上游伺服器。以下使用迴路位址上的 1053 進行本機測試,避免將範例監聽位址開放至區域網路。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
fake-ip-filter:
- localhost
- '*.lan'
在預設的過濾模式下,符合 fake-ip-filter 的網域不會取得 Fake-IP,但這不代表上游伺服器一定能解析這些網域,也不代表連線會直連。Fake-IP 是核心用來將連線對應回網域的位址映射;是否透過代理連線,仍由運作模式與規則決定。萬用字元項目 '*.lan' 必須加上引號,避免開頭的星號被 YAML 解讀為別名語法。
可執行 nslookup -port=1053 example.com 127.0.0.1,單獨檢查監聽連接埠。此範例中,未遭過濾的 A 記錄查詢會取得設定網段內的 Fake-IP。這只能確認查詢已送達核心並收到回應,無法證明系統 DNS 已切換,也無法證明目標網站可以連線。若手動查詢成功,但應用程式的結果不同,請再檢查應用程式內建的加密 DNS、系統快取,以及啟用 TUN 時的 DNS 劫持設定。
proxies 與 proxy-groups:分開定義節點與選擇策略
頂層 proxies 是出站節點清單。每個項目通常包含 name、type、server、port,其他參數則依協定而定。節點的 port 指向遠端服務,與本機的 mixed-port 無關。請勿將訂閱 URL 填入節點的 server:用戶端可能會將訂閱轉換成完整設定,而 mihomo 的 proxy-providers 則用來依設定載入節點集合。
頂層 proxy-groups 用來定義策略組。組內的 proxies 是候選項目的名稱清單,不是節點物件清單;透過節點提供器引入候選項目時,請在組內使用 use 引用提供器名稱。可先建立只包含內建出站的群組,確認引用關係,無須填入節點憑證:
proxy-groups:
- name: Lab-Select
type: select
proxies:
- DIRECT
- REJECT
select 群組會使用目前選取的項目。規則命中 Lab-Select 後,目前選取的是 DIRECT 就會直連,選取 REJECT 就會拒絕連線。測試前請在用戶端確認群組內的選項,因為介面可能會還原上次的選擇。將節點加入群組時,請複製節點完整的 name,並確認大小寫、空格與標點符號。重新命名策略組後,也要同步修改引用該組的規則。
rule-providers:定義規則集不等於啟用分流
rule-providers 提供比對條件,不提供出站節點。在此宣告規則集,只會建立名稱與內容的對應;還需要在 rules 中加入一條 RULE-SET,指定命中後使用的出站。可先使用內嵌規則集驗證,排除下載與快取問題。
rule-providers:
lab-domains:
type: inline
behavior: domain
payload:
- '+.example.org'
behavior: domain會讀取網域項目,例如+.example.org;請勿在項目結尾指定策略組。behavior: ipcidr會讀取 IP 網段,例如192.0.2.0/24;請勿加上IP-CIDR,前綴。behavior: classical會讀取含類型的條件,例如DOMAIN-SUFFIX,example.org;最終出站仍須寫在外層的RULE-SET中。
改用 HTTP 提供器時,需另外設定 type: http、url、本機快取 path 與更新間隔 interval。interval: 86400 代表 24 小時,單位為秒。format 必須符合資源的實際格式;不可將回傳登入頁面的連結當成規則檔,也不能只靠更改副檔名就把文字檔變成 MRS。圖形介面用戶端的核心工作目錄可能與原始訂閱檔所在目錄不同;尋找快取時,請先確認工作目錄,再核對相對路徑。
rules:依清單順序比對,不依條件具體程度排序
將以下清單接續加入前面的設定。rules、rule-providers、proxy-groups 與 dns 都是頂層鍵,彼此不需縮排。核心會由上而下檢查規則,並採用第一條命中規則指定的策略;不會自動將條件較具體的網域規則移到前面。
rules:
- DOMAIN,example.org,DIRECT
- RULE-SET,lab-domains,Lab-Select
- MATCH,DIRECT
當核心可以取得連線的目標網域時,example.org 會先命中第一行;www.example.org 則會命中規則集,交由 Lab-Select 處理。如果將規則集那一行移到完整網域規則之前,根網域也會先由規則集處理。若將 MATCH 放在前面,後續規則就沒有比對機會。測試時可在 Lab-Select 選擇 REJECT,查看子網域請求是否在連線記錄中命中預期規則;請勿以範例網站是否實際提供網頁作為判斷依據。
設定錯誤與分流異常:從解析、載入到連線逐層排查
- 先驗證 YAML 語法與引用。 使用空格縮排,並讓同一層的鍵保持對齊。清單項目使用連字號,映射項目使用鍵值對。不要為了新增一條規則而再建立一個頂層
rules;請將規則加入既有清單。獨立執行時,可在設定目錄中使用mihomo -t -f config.yaml測試設定;若用戶端使用獨立的工作目錄,則應依實際目錄與設定檔進行測試。先查看第一筆錯誤,修正結構後再處理名稱。 - 確認測試的是目前生效的設定。 圖形介面用戶端可能會先合併訂閱、覆寫內容與本機偏好設定,再交由核心載入。原始檔通過測試,不代表執行中的設定包含相同規則。請查看目前啟用的設定與用戶端顯示的合併結果,重新載入後確認模式、連接埠及策略組選項。
- 先確認連線入口,再追蹤出站路徑。 可使用本文的連接埠範例執行
curl --proxy http://127.0.0.1:7890 https://example.org/進行測試。若無法連線至代理連接埠,先檢查監聽服務是否已啟動或連接埠是否遭占用;如果連線已出現在記錄中,則核對目標網域、命中的規則及最終出站。若命中正確但請求仍失敗,再檢查 DNS 上游伺服器、所選出站或目標服務。
每次只變更一個項目。先使用 DIRECT、REJECT 與兩條可區分的網域條件驗證規則,再逐步換回訂閱節點與遠端規則集。發生異常時,便能判斷問題是來自本機入口、設定合併、規則資料,還是特定出站。