mihomo 設定與疑難排解術語

Clash 術語手冊

從 config.yaml 的欄位名稱,查到日誌中的出口結果。

遇到不熟悉的選項,先查清楚定義;遇到連線異常,依序檢查流量接管、DNS 解析、規則比對和出口。卡片標題可直接連結至個別術語。

核心與通訊協定

先釐清介面、核心和遠端伺服器的區別,遇到錯誤才知道該從哪一層排查。

mihomo
mihomo 是 Clash 生態系中的代理核心,負責讀取設定、接收連線、比對規則並選擇出口。圖形化用戶端負責匯入設定和切換功能,真正處理連線的是核心。遇到「不支援此欄位」的錯誤時,先確認用戶端實際載入的核心版本,而不只是介面版本。
代理通訊協定
代理通訊協定規範用戶端如何與遠端伺服器建立連線、驗證身分及傳輸資料。在節點設定中,通常先看 type,再確認該協定需要哪些欄位。本機應用程式透過 HTTP 代理連線,不代表核心也使用 HTTP 代理協定連接遠端伺服器。
混合連接埠(mixed-port)
混合連接埠讓核心在同一個本機連接埠接收 HTTP 和 SOCKS 代理連線。例如設為 7890 後,本機應用程式可連到 127.0.0.1:7890,並選擇支援的代理類型。這是應用程式連入的連接埠,不是訂閱網址,也不是遠端伺服器的連接埠。
UDP 轉發
UDP 轉發是透過代理連線轉送 UDP 資料包的能力,語音通話和部分遊戲會用到。入口必須能接收 UDP,選用的出口和遠端伺服器也必須支援。網頁能開啟,只代表該連線正常;排查通話問題時,還要另外確認應用程式的 UDP 流量經過哪條路徑。

設定檔結構

區分原始檔案與生效設定;完整結構請參閱設定欄位。

YAML
YAML 是 mihomo 使用的設定資料格式,以縮排區分層級,並用連字號表示清單項目。請使用空格縮排,不要使用定位字元,並讓同一層級的項目對齊。如果解析錯誤指向某一行,也要檢查上一行的冒號和縮排:核心可能直到下一行才發現結構不符。
主要設定檔(config.yaml)
主要設定檔是核心啟動或重新載入時讀取的設定,常見檔名為 config.yaml。內容可包含基本設定、代理定義、策略群組和規則,也能引用外部資源。圖形化用戶端匯入後可能會另存一份執行用設定;編輯手邊同名的檔案,不一定會影響核心實際讀取的那一份。
代理定義(proxies)
proxies 是在主要設定檔中逐項定義代理節點的清單。每個項目以 name 命名,並依協定填寫伺服器、連接埠等參數;策略群組可透過名稱引用節點。若節點改名後群組找不到它,請先確認引用處是否也已更新,再排查網路問題。
覆寫與合併
覆寫與合併會以原始設定為基礎,產生另一份實際生效的設定。修改單一純量欄位,和新增清單項目並不相同:用戶端可能會取代整份清單,也可能支援插入開頭或附加至末尾。新增規則後,請檢查生效中的清單,確認原有規則仍在,而且新規則沒有排在預設規則之後。

策略群組與規則

規則決定交由哪個群組處理,策略群組則決定實際使用哪個出口。

規則分流
規則分流是在規則模式下,依條件為連線選擇出口。一般規則會由上往下比對,符合後便不再繼續;特定網域規則應排在可能涵蓋它的廣泛規則之前。排查自訂規則時,先確認 mode: rule,再查看連線詳細資料實際符合哪條規則。
策略群組(proxy-groups)
策略群組將多個出口選項歸在同一個名稱下,供規則引用。群組內可列出節點、其他策略群組或內建出口,選擇方式則視群組類型而定。規則符合某個群組只是第一步;要確認連線實際去向,還要查看群組目前選用的成員。
網域後綴規則(DOMAIN-SUFFIX)
網域後綴規則可同時比對指定網域及其子網域。例如 DOMAIN-SUFFIX,example.com,DIRECT 會比對 example.com 和 api.example.com,但不會比對 notexample.com。若只要比對單一完整網域,請使用 DOMAIN。
GeoIP
GeoIP 是依據 IP 位址區段資料進行地區分類的規則類型。GEOIP,CN,DIRECT 檢查的是目標 IP 是否被資料庫歸類為 CN,不會檢查網域是否以 .cn 結尾。同一個網域可能解析到不同位址,因此比對結果也可能隨之改變。
預設規則(MATCH)
MATCH 不含比對條件,用來處理一路比對到規則清單末尾的連線。MATCH,DIRECT 表示前面的規則都不符合時,直接連線;也可以將最後一條規則指向策略群組。若把一般規則加在 MATCH 後面,就無法處理已被預設規則接住的連線。
自動測速群組(url-test)
url-test 策略群組會探測指定 URL,並依探測結果選擇出口。常用欄位包括 url、interval 和 tolerance;容差可減少延遲小幅波動造成的切換。測試網址回應快,不代表連線至實際服務也快,更不代表下載頻寬較大。

網路接管方式

分開檢查封包是否進入核心,以及網域交由哪個解析器處理。

系統代理
系統代理是作業系統提供給應用程式讀取的代理設定,不代表整個系統的流量都已接管。會讀取這項設定的應用程式會連至本機代理連接埠;使用獨立設定的應用程式則可能略過系統代理。瀏覽器能用、終端機卻無法連線時,請先確認命令列工具讀取的是哪一套代理設定。
TUN 模式
TUN 模式透過虛擬網卡接收路由導入的 IP 封包,再交由核心處理。應用程式不必先支援 HTTP 或 SOCKS 代理,但實際接管範圍仍取決於路由、權限和排除項目。開啟功能後若連線清單沒有相關記錄,請先確認虛擬網卡和路由是否已實際生效。
Fake-IP
Fake-IP 是一種 DNS 處理模式,核心會回傳臨時位址給應用程式,並記錄位址與網域的對應關係。後續連線至該位址時,核心可依照映射取回網域以進行比對。對於依賴真實解析結果的服務,可先確認是否需要將相關網域加入 fake-ip-filter。
DNS 劫持(dns-hijack)
在 mihomo 的 TUN 設定中,dns-hijack 是將符合條件的 DNS 查詢交由核心的 DNS 模組處理。它不是上游解析器位址,也不會自動接管應用程式透過 HTTPS 傳送的 DNS 查詢。修改設定後,請分別確認查詢是否有被接收,以及接收後交由哪個上游解析器處理。
DNS 洩漏
DNS 洩漏是指原本應走指定解析路徑的查詢,卻從預期之外的出口送出。網頁流量使用代理,不代表先前的網域解析也走了相同路徑。排查時請分別檢查作業系統和應用程式內的解析設定,並比對核心日誌,確認查詢是否經過預期的解析器。
DNS 分流(nameserver-policy)
DNS 分流會依查詢的網域選擇上游解析器。例如,將內部網域交給能解析該網域的組織內部解析器,其餘網域則沿用一般上游解析器。這項設定決定由誰回覆查詢,不會決定連線至該位址時採用直連或代理;後者仍由連線規則決定。

訂閱與節點

成功取得、成功解析和成功連線,是三種不同的檢查結果。

訂閱
訂閱是用戶端定期取得設定或節點清單的方式,通常是一個連結。完整設定可能包含規則和策略群組;節點清單則可能需要搭配現有設定使用。匯入前請先確認用戶端支援哪種格式;分享排障截圖時,請勿一併貼出訂閱連結。
節點
節點是核心可選用來轉發連線的遠端代理項目。名稱主要供介面顯示及設定引用;建立連線時則會用到伺服器位址、連接埠和協定參數。清單中看得到名稱,只代表項目已載入;是否能使用,還得確認遠端連線和驗證結果。
節點延遲
用戶端顯示的節點延遲,通常是透過該節點連線至測試網址時測得的回應時間。這不只是測試節點位址是否連通,也不能直接換算成下載速度。比較時請使用相同的測試網址和網路;單次逾時只代表當次探測未能在時限內完成。
更新訂閱
更新訂閱是重新取得遠端內容,並由用戶端解析後取代或更新訂閱資料的過程。請求逾時時,先檢查連往訂閱網址的網路;若回傳內容無法匯入,則先檢查回應格式。更新成功後,若策略群組仍顯示舊項目,請再確認目前啟用的設定是否引用了這份訂閱。