mihomo
mihomo 是負責解析設定、比對規則及建立對外連線的代理核心。客戶端介面負責匯入檔案和切換設定,實際執行這些設定的是核心。遇到不支援的欄位時,應先確認實際執行的核心版本,而非只看應用程式版本。
Clash / mihomo · 術語索引
可依客戶端介面或 YAML 欄位查找術語。分流結果不如預期時,先確認流量是否已被接管、符合哪條規則,以及規則指定的策略組最後選用了哪個出口。
mihomomihomo 是負責解析設定、比對規則及建立對外連線的代理核心。客戶端介面負責匯入檔案和切換設定,實際執行這些設定的是核心。遇到不支援的欄位時,應先確認實際執行的核心版本,而非只看應用程式版本。
節點是設定中定義的一個代理出口,通常包含協定、伺服器位址、連接埠及該協定所需的參數。proxies 可直接列出節點,策略組則負責從候選出口中選擇。顯示名稱可供引用,但無法據此判斷節點是否連得上,或使用哪種協定。
代理協定規範客戶端與伺服器如何交換資料。節點中的 type 會決定其他欄位的解讀方式,因此更換協定不能只改名稱,還必須使用伺服器支援的一整組參數。本機應用程式連接代理時使用的協定,也不一定和核心連接遠端節點時使用的協定相同。
面板上的毫秒數通常是向指定 URL 探測一次所得的結果,並非連往所有目的地的往返時間。測試網址、逾時設定或連線重用方式不同,都可能讓數值無法直接比較。下載速度和連線穩定度應另外測試;單次探測逾時,也不代表所有連線都失敗。
訂閱是客戶端定期取得設定內容的來源,通常透過連結匯入。伺服器回應可能是完整設定檔,也可能只有節點清單;能否直接啟用,取決於回應格式和客戶端支援。訂閱連結可能包含存取憑證,排查匯入問題時請勿公開完整連結。
YAMLYAML 以縮排表示階層,並使用鍵值對與序列組織資料。例如,dns: 下方縮排的 enable: 屬於 DNS 設定,不是頂層開關。縮排請使用空格;通過語法檢查後,還要確認欄位名稱、階層和值的型別符合核心要求。
proxy-providersproxy-providers 依提供者整理節點,來源可以是遠端網址或本機檔案。策略組透過 use 引用提供者,因此節點清單更新時,通常不必逐一重寫組內的候選項目。如果提供者更新成功但群組內沒有節點,請檢查引用名稱和篩選條件。
覆寫會將本機修改與訂閱原始內容分開儲存,例如調整 DNS 欄位,或在訂閱規則前插入例外規則。取代同名欄位、附加清單和將項目插入清單前端是不同操作,實際行為由客戶端決定。更新訂閱後應檢查合併結果,確認修改仍位於所需的階層與順序。
proxy-groups策略組會將候選節點、內建出口或其他群組集中在同一名稱下,供規則引用。select 由使用者手動選擇;fallback 則依候選順序優先使用可連線的項目。規則符合群組名稱後,還要查看該群組目前選用的出口,才能判斷連線實際會走哪裡。
url-testurl-test 會使用指定 URL 探測候選出口,並依延遲結果選擇路徑。interval 控制探測間隔,tolerance 用來避免因延遲差距很小而頻繁切換。這項測試衡量的是對測試目標的回應速度,無法保證選中的出口連其他網站也更快。
在 mode: rule 模式下,核心會依照 rules 的順序檢查連線,通常由第一條符合的規則決定後續策略。DOMAIN-SUFFIX 可比對指定網域及其子網域。若要對某個子網域採取不同處理,應將較明確的規則放在涵蓋範圍較廣的規則之前。
GeoIPGEOIP 依據 IP 資料集比對目的位址的類別,例如國家或地區代碼。這不是網域後綴比對,查詢結果也無法證明服務的實際所在地。連線目標為網域時,規則可能需要先解析位址;no-resolve 可避免僅為這條規則觸發解析。
MATCHMATCH 會比對前面的規則尚未處理的連線,常見寫法包括 MATCH,DIRECT。它通常位於規則清單末尾;若放在前面,後續規則便無法處理已被它比對到的連線。存取意外落入預設規則時,請先檢查前面的規則,以及記錄中的目標網域或 IP。
Fake-IPdns.enhanced-mode: fake-ip 會讓核心對符合條件的 DNS 請求回傳合成位址,並儲存網域與位址的對應關係。接管後續連線時,核心可據此還原網域,以便比對規則。需要真實位址的區域網路服務或應用程式,可視情況透過 fake-ip-filter 排除。
DNS 洩漏是指 DNS 查詢經由非預期的解析路徑傳送,例如網頁連線走代理,但查詢仍由本機網路的解析器處理。是否構成洩漏,取決於事先指定的解析路徑,而非檢測頁面顯示的國家或地區。排查時,請分別確認瀏覽器的安全 DNS、系統解析器,以及核心使用的上游 DNS。
tun.enable: true 是啟用 TUN 的設定方式,透過虛擬網路介面和路由接管流量。它可以涵蓋部分不遵循系統代理設定的應用程式,但接管範圍仍受系統權限、路由規則和排除項目限制。啟用後,仍須分別確認目標流量和 DNS 查詢是否依預期處理。
mixed-portmixed-port 可在同一個監聽連接埠接受 HTTP 和 SOCKS 代理請求。7890 是常見範例,不是所有客戶端的預設值;應用程式應填入目前實際監聽的連接埠。若要從其他裝置連線,還需確認 allow-lan、監聽位址和防火牆設定。
GUI圖形化客戶端提供匯入設定、選擇策略及檢視記錄等介面,可能內建核心,也可能管理獨立執行的核心程序。不同客戶端即使使用同類核心,覆寫語法、選單位置和系統整合能力也可能不同。選擇客戶端時,應先確認支援的平台,再比較實際需要的功能。
系統代理設定會向遵循該設定的應用程式提供代理位址和連接埠,本身不會安裝用來接管流量的路由。不讀取系統代理設定的應用程式可能直接連線,或使用應用程式內另行指定的代理。關閉客戶端後,若系統仍指向本機連接埠,而該連接埠已停止監聽,遵循設定的應用程式就可能無法連上網路。
x64、amd64 和 x86_64 通常代表同一種 64 位元 x86 架構;arm64 和 aarch64 通常代表 64 位元 ARM。下載前請一併確認作業系統、架構和安裝套件格式。如果同一客戶端提供多種版本,建議選擇與系統相符的原生版本。