Clash config.yaml 逐段解析:連接埠、DNS、proxies 與 rules 怎麼設定

依序拆解完整設定檔,說明 mixed-port、dns、proxies、proxy-groups、rule-providers 與 rules 的用途及常見寫法。

完整範例:先看各設定項如何互相引用

這份範例適用於支援內嵌規則集的 mihomo(原 Clash Meta),透過網域規則與明確指定代理的請求測試分流,不依賴訂閱更新或 TUN。Clash 原版也能辨識部分同名欄位,但這份檔案並非所有核心都通用,尤其要先確認是否支援該規則集類型。

mixed-port: 7890
allow-lan: false
mode: rule

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - 223.5.5.5

proxies:
  - name: "本機 SOCKS5"
    type: socks5
    server: 127.0.0.1
    port: 1080

proxy-groups:
  - name: "辦公出口"
    type: select
    proxies:
      - DIRECT
      - "本機 SOCKS5"

rule-providers:
  office-domains:
    type: inline
    behavior: domain
    payload:
      - "+.example.org"

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - RULE-SET,office-domains,辦公出口
  - MATCH,DIRECT

請求從 mixed-port 進入後,核心會在規則模式下依序檢查 rules。符合 office-domains 時,會轉到「辦公出口」,再使用該群組目前選取的出口。即使最後選擇 DIRECT,規則仍可能符合策略群組;要判斷分流是否正確,必須同時查看符合的規則與實際出口。

mixed-port:分清本機入口與上游連接埠

mixed-port: 7890 會讓核心在同一個本機連接埠接收 HTTP 代理與 SOCKS5 代理連線。應用程式填入的是 127.0.0.1:7890;proxies 中的 1080 則是核心選用示範節點後才會連線的上游連接埠。一個是應用程式連到核心,另一個是核心連到上游,兩者不能混用。

allow-lan: false 適用於僅在本機使用的情境。設定監聽連接埠不會自動開啟系統代理。只想測試特定應用程式時,先讓該應用程式明確連線至此連接埠;若要讓不使用系統代理的應用程式也能連線,再另外評估 TUN。TUN 會透過虛擬網卡接管符合路由設定的流量,與應用程式主動連線至 7890 的入口不同。

連接埠被占用時該怎麼改

如果記錄顯示 address already in use,先確認是否同時執行了第二個核心執行個體。若要改用 7891,也要將手動設定的瀏覽器代理、終端機參數等一併改為 7891。桌面用戶端可能會覆寫設定中的連接埠;診斷時請以啟動記錄顯示的實際監聽值為準。

dns:上游解析與 fake-ip 的差異

dns.enable: true 會啟用核心的 DNS 模組,nameserver 則指定該模組用於一般解析的上游 DNS。本例使用 IP 為 223.5.5.5 的傳統 DNS 服務,執行前請確認目前網路可連線,且符合所在地網路的 DNS 需求。只修改這個區段,不會讓系統或瀏覽器的所有 DNS 查詢都經過核心。瀏覽器內建的安全 DNS、應用程式明確指定的代理,以及 TUN 的 DNS 接管,需分別判斷。

在 enhanced-mode: fake-ip 模式下,符合條件的網域 A 查詢會由核心回傳臨時映射位址。看到 198.18.0.0/16 範圍內的位址,不代表網站架設於該網段。後續連線必須由同一個核心接手,才能透過映射找回網域。使用 HTTP 代理瀏覽 HTTPS 網站時,應用程式通常可在 CONNECT 請求中直接提供目標主機名稱,因此不必先取得 fake IP 才能符合網域規則。

啟用 fake-ip 後無法連線到區域網路服務

先確認該網域是否由核心解析,再檢查同一個應用程式的連線是否也經過核心。如果應用程式取得映射位址後,卻繞過核心建立連線,單改 nameserver 通常無法解決。若確認該服務必須取得真實位址,可在現有的 dns 區段加入 fake-ip-filter,例如明確排除 printer.home.arpa。同時也要確保上游 DNS 能解析這個私有名稱;篩選只會改變回傳位址的方式,不會讓公用 DNS 自動新增區域網路記錄。

proxies 與 proxy-groups:分開管理節點與策略群組

頂層的 proxies 用來描述連線至上游所需的參數。每個節點都包含名稱、通訊協定、伺服器與連接埠,其他欄位則依通訊協定而異。範例使用 type: socks5;改用其他通訊協定時,不能只改 type 而沿用舊欄位。若節點來自訂閱,請先確認訂閱是否已產生完整設定檔,或是由用戶端透過 proxy-providers 載入節點清單。

proxy-groups 用來宣告路由可選擇的出口。群組中的 proxies 只列出名稱,不必重複填寫伺服器位址;DIRECT 是內建的直連策略。「辦公出口」使用 select,由用戶端手動選擇,不會依據測速自動切換節點。若節點來自具名的 proxy-providers,策略群組可透過 use 引用提供者;請勿將提供者名稱誤當成節點名稱。

更改名稱時,請依引用方向逐一檢查:將節點「本機 SOCKS5」改名後,必須同步修改群組成員清單;將群組「辦公出口」改名後,則要修改規則的目標。名稱中多一個空格也會被視為不同名稱。對於會定期更新的訂閱,建議使用用戶端提供的覆寫或合併功能保留本機修改;直接編輯訂閱快取,可能會在下次更新時被覆蓋。

rule-providers 與 rules:先準備規則集,再決定出口

rule-providers 用來定義規則集合,本身不會指定流量出口。範例中的 office-domains 使用 behavior: domain,以 +.example.org 涵蓋根網域及其子網域。真正將策略套用至流量的是 RULE-SET,office-domains,辦公出口;若只定義規則集而未加入這項引用,請求就不會依此規則集比對。

behavior項目範例用途
domain+.example.org比對指定網域及其子網域。
ipcidr192.0.2.0/24比對目標 IP 網段;此處使用文件中的示範網段。
classicalDOMAIN-SUFFIX,example.org保留規則類型,項目後方不加上策略群組名稱。

將規則集拆分為本機檔案時,可將 type 改為 file,設定 format: yaml 與 path: ./rules/office.yaml,並將原本的 payload 整段移入該 YAML 檔案。相對路徑以核心的工作目錄為準,請勿假設它與用戶端介面顯示的訂閱檔案位於同一個資料夾。若要遠端更新,則使用 type: http,設定 url 與以秒為單位的 interval,並確認內容格式符合 behavior。

規則優先順序由清單排列決定

在規則模式下,核心會由上而下檢查 rules,並採用第一條符合的策略。若要讓 status.example.org 一律直連,可將 DOMAIN,status.example.org,DIRECT 放在對應的 RULE-SET 前面。若放在後面,較寬泛的規則集已先符合,這條例外就不會執行。MATCH 是無條件的兜底規則,必須放在最後;將它的策略改成某個群組,會影響所有未符合前面規則的請求。

設定檔驗證:依序確認載入、入口與規則符合情形

  1. 確認設定檔能否載入。請使用空格縮排,並讓同一層級的鍵對齊;修改 dns 等既有區段時,請在原區段中合併,不要在頂層重複宣告同名鍵。若已安裝獨立的 mihomo 命令列工具,可在範例所在目錄執行 mihomo -t -f ./config.yaml。驗證通過只代表設定檔可讀取且格式有效,不代表上游已連線。
  2. 確認請求進入正確的核心。載入設定檔並確認模式為規則模式,再將「辦公出口」選為 DIRECT。執行下方命令並明確使用 7890,避免將系統代理開關或瀏覽器擴充功能影響測試結果。若連線本機連接埠時立即遭拒,先檢查監聽狀態,不要急著修改 DNS。
  3. 比對兩個目標的規則命中記錄。查看用戶端的連線記錄,必要時從記錄中搜尋網域。example.org 應符合 office-domains,並透過「辦公出口」選擇直連;example.com 則應直接符合第一條網域後綴規則。兩個網站都能開啟,不代表規則設定正確,因為末尾的 MATCH,DIRECT 也會讓請求直連。
curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 10 -I https://example.org/
curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 10 -I https://example.com/

以上命令適用於常見的 Unix Shell;在 Windows PowerShell 中,請呼叫 curl.exe,並確認空字串參數能正確傳給程式。這裡的 --noproxy "" 會清除環境變數中可能存在的略過代理清單;--max-time 10 則將單次請求的總時限設為 10 秒。

如果策略群組符合正確,但切換至「本機 SOCKS5」後才失敗,請確認 1080 是否有服務監聽,並檢查上游通訊協定與驗證參數。若請求仍由兜底規則處理,請確認目前生效的設定、目標是否以網域形式進入核心,以及是否被更前面的規則攔截。每次只修改一個環節,再用同一個網域重新測試,才能確認修改是否生效。

下載最新版 Clash