· 核心進階 · 約需閱讀 8 分鐘

mihomo 核心與原版 Clash 差異:新增協定、規則集與設定欄位變更

比較原版 Clash 與 mihomo(Clash Meta),整理協定支援、rule-providers、DNS、TUN 欄位及舊設定檔的遷移重點。

核心版本與設定檔相容性

Clash Meta 是 mihomo 的舊稱。比較原版 Clash 時,須區分原版開源核心與另外發行的 Clash Premium。規則集和 TUN 並非 mihomo 才有的功能:Premium 已支援相關能力,但其設定不能視為原版開源核心的通用設定,也不能假設所有欄位在 mihomo 中的運作方式都相同。

遷移前先確認用戶端實際啟動的核心。用戶端版本號與核心版本號是兩回事。若能存取目前使用的 mihomo 執行檔,可用 mihomo -v 查看版本;即使另外下載的二進位檔名稱相同,也不代表圖形用戶端正在使用它。

設定項目遷移至 mihomo 時的處理方式
mixed-port、mode先保留原值。若用戶端覆寫監聽連接埠或執行模式,請以實際啟動時的值為準。
proxies、proxy-groups、rules常見結構通常可以保留。請逐一確認節點類型、群組成員名稱與規則目標。
rule-providers、RULE-SET若舊設定來自 Premium,請檢查載入方式、規則行為與實際比對順序。
dns、tun分別遷移並驗證。請勿同時更換 DNS 上游、增強模式與系統路由。

新增協定:先確認節點類型,再檢查傳輸欄位

mihomo 擴充了原版 Clash 支援的出站協定。例如,VLESS 節點寫作 type: vless,Hysteria 2 寫作 type: hysteria2,TUIC 寫作 type: tuic。只將舊設定中的 type: vmess 改成 type: vless,並不會轉換協定;出站類型、驗證資料與傳輸參數都必須符合伺服器設定。

  • VLESS 與 REALITY:VLESS 是節點協定,REALITY 並非獨立的 type。若使用 REALITY 的 VLESS 節點,請確認 servername、reality-opts 中的 public-key 與 short-id。只有伺服器要求使用 Vision 時,才設定相應的 flow。
  • Hysteria 2 與 TUIC:兩者皆以 QUIC 為基礎。能解析伺服器網域、開啟網頁,或連上伺服器的 TCP 連接埠,都不能證明相同連接埠的 UDP 流量可正常通過。疑難排解時,請分別確認協定欄位、驗證資訊,以及目前網路是否支援 UDP。
  • 匯入訂閱:先分清楚完整的 YAML 設定檔,以及僅供節點提供者讀取的節點清單。訂閱更新成功只表示用戶端已取得內容;如果代理群組沒有引用新節點,一般連線仍可能使用原本的出站節點。

規則集:檔案格式、運作方式與比對順序

rule-providers 用來註冊規則集;是否使用規則集,以及命中後採用哪個出站節點,則由 rules 中的 RULE-SET 決定。以下使用本機檔案示範遷移,避免將遠端規則集下載失敗與設定錯誤混為一談。

主設定檔中的規則集引用

mode: rule
rule-providers:
  local-domains:
    type: file
    behavior: classical
    format: yaml
    path: ./rules/local-domains.yaml
rules:
  - RULE-SET,local-domains,DIRECT
  - MATCH,DIRECT

規則集檔案 rules/local-domains.yaml

payload:
  - DOMAIN-SUFFIX,example.org

這兩條規則都指向 DIRECT,可用來確認規則是否命中,而不會改變預設出站。核心在規則模式下會依序比對,通常以第一條符合的規則為準。查看連線記錄驗證時,請確認 example.org 命中的是 RULE-SET,而不是最後的 MATCH;只看出站名稱無法分辨兩者。實際設定中的兜底規則應放在最後,也要留意上方較寬泛的網域或 IP 規則是否先行命中。

behavior: classical 可使用範例中的 DOMAIN-SUFFIX,example.org;behavior: domain 讀取網域比對項目,不適用這類帶有規則類型前綴的寫法;behavior: ipcidr 則讀取 IP 網段。format 描述的是檔案格式,不是比對方式。將副檔名改成 .mrs 不會把 YAML 轉換成 MRS;若要改用 MRS,請使用實際產生的檔案,且規則行為應設為 domain 或 ipcidr。

DNS 遷移:釐清目標網域與節點網域

目標網域是應用程式要連線的網址;節點網域則是代理伺服器本身的網址。用戶端能解析前者,不代表核心也能解析後者。若節點設定中的 server 使用網域名稱,mihomo 可透過 proxy-server-nameserver 指定解析節點網域的上游 DNS。排查時請確認,即使節點尚未連線,仍能連到該上游,避免陷入「必須先連上節點,才能解析節點」的依賴。

  • nameserver 是一般查詢可使用的上游設定之一;nameserver-policy 可為符合條件的網域指定不同上游。企業內網網域應使用能解析該內部網域的 DNS,而非只多加一個公共 DNS 上游。
  • enhanced-mode: fake-ip 會對符合條件的查詢回傳映射位址。若執行中的設定使用 198.18.0.1/16,看到這個範圍內的回應通常是預期結果,並非目標伺服器的公網 IP 位址。
  • 若內網網域需要回傳真實 IP,可檢查 fake-ip-filter 與 fake-ip-filter-mode。在黑名單模式下,符合篩選條件的網域不會回傳 Fake IP;篩選只會改變回應方式,不會自動為內網網域選擇能解析它的上游 DNS。

一般查詢成功但服務仍無法使用時,先用同一個網域比對應用程式實際使用的解析路徑與核心連線記錄。瀏覽器自帶的加密 DNS 可能採用不同路徑。此外,依賴 IP 的規則可能觸發網域解析;在適用的規則中加入 no-resolve,可避免該規則主動為網域查詢 IP,但不代表全域停用 DNS。

TUN 遷移:先驗證代理連接埠,再接管系統路由

系統代理仰賴應用程式遵循代理設定;TUN 則透過虛擬網卡與路由接收流量。瀏覽器透過系統代理正常運作,不代表 TUN 已接管終端機、遊戲或其他不讀取系統代理設定的應用程式。遷移時先關閉 TUN,確認代理監聽與節點運作正常,再單獨啟用 TUN 比較差異。

  1. 若執行中的設定使用 mixed-port: 7890,可執行 curl -I --proxy http://127.0.0.1:7890 https://example.org/。在將 curl 設為別名的 Windows PowerShell 環境中,請改用 curl.exe。收到回應後,還要查看連線記錄,確認請求是否採用預期的策略;收到回應不代表已選用代理節點。
  2. 啟用 tun.enable 後,請確認核心具有建立虛擬網卡與修改路由的權限。auto-route 用來控制是否自動新增路由;有線、無線網路與其他 VPN 同時使用時,請確認自動偵測的出口是否正確,避免把預設出口誤判為節點故障。
  3. 啟用 TUN 後若只有 DNS 異常,請檢查 dns-hijack 的比對範圍。any:53 用來比對 UDP 53,tcp://any:53 用來比對 TCP 53;這些規則不會將 HTTPS 上的加密 DNS 查詢視為一般 53 連接埠查詢並攔截。

舊設定檔的遷移驗證順序

保留可正常使用的舊設定檔,並在獨立工作目錄中測試新設定。以下命令需在包含該設定檔的工作目錄中執行;若使用圖形用戶端,最後也要確認訂閱合併與覆寫後交給核心的設定內容。

mihomo -v
mihomo -t -d . -f config.yaml

-t 用來測試設定,不能取代執行時驗證。先用已知可用的節點確認代理入口,再檢查一筆應直連的請求與一筆應進入代理群組的請求,最後分別驗證 DNS 和 TUN。若更新訂閱後問題再次出現,請比對更新前後實際的規則順序與群組成員,並確認覆寫是否仍然生效。

切換後若連內網也無法連線,請優先停用 TUN,並還原先前的系統代理與設定,再逐項重新測試。欄位說明可參閱設定參考;應用程式代理、策略群組與核心之間的關係,請參閱名詞解釋。

下載Clash