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