MIHOMO / GLOSSARY

Mihomo 術語表
設定、協定與網路堆疊

對照用戶端設定與 YAML 欄位查找術語。先分清核心、節點與策略群組,再了解請求如何經過規則、DNS 與路由。

26 個常見術語 5 大技術分類 依章節學習設定 →

核心與設定檔

這組術語說明設定由誰執行、如何組織,以及遠端內容如何載入用戶端。

mihomo / Clash Meta

Mihomo

Mihomo 是曾使用 Clash Meta 名稱的代理核心,負責協定連線、規則比對、DNS 處理與流量轉送。圖形化用戶端則是在核心之外提供設定管理與操作介面的應用程式,兩者屬於不同層級。排查相容性時,應同時確認用戶端版本與實際執行的核心版本,而非只看應用程式名稱。

閱讀核心與用戶端說明 →
YAML / key: value

YAML

YAML 是 Mihomo 使用的設定格式,以縮排表示層級,並透過鍵值對與清單組織欄位。縮排應使用空格,布林值、數字與字串也須符合對應欄位的要求。編輯後若出現解析錯誤,請先檢查錯誤行附近的縮排、冒號與引號;語法能成功解析,不代表欄位組合一定有效。

查看設定檔管理方式 →
profile URL

訂閱連結

訂閱連結是用戶端取得節點清單或完整設定的網址,回傳內容格式會決定匯入方式。有些連結只提供節點,有些則包含策略群組、規則與 DNS 設定,不能只憑網址外觀判斷。更新訂閱只是重新取得遠端內容,並非修復節點的通用方法;連結也可能含有存取憑證,請避免出現在公開截圖或紀錄中。

查看訂閱匯入與更新方式 →
proxy-providers / use

代理集合

代理集合透過 proxy-providers 定義,可從本機檔案或遠端網址載入一組節點。策略群組透過 use 引用集合,讓節點來源與分流架構能分開管理。集合更新成功後,仍須確認策略群組確實有引用;單獨定義集合不會自動改變既有規則的出口。

查看節點來源管理方式 →

代理協定與節點參數

協定決定用戶端如何連線至伺服器。協定名稱本身無法證明線路品質,也不能取代完整的驗證與傳輸參數。

proxies

節點

節點是一組描述代理連線目標的參數,通常包含協定類型、伺服器位址、連接埠與驗證資訊;部分協定還需要傳輸與 TLS 設定。節點名稱只是供介面與設定引用的識別名稱,無法證明實際出口地區。節點連線失敗時,應查看紀錄,檢查驗證、網域解析與伺服器是否可連線,而不只是修改顯示名稱。

type: ss

Shadowsocks

Shadowsocks 使用指定的加密方式與密碼建立代理連線,在 Mihomo 中對應 type: ss。用戶端與伺服器須使用相容的加密方式,部分方案還會用到外掛程式參數。Shadowsocks 可承載 UDP,但是否能實際使用,取決於兩端支援情況、節點設定與中間網路,不能只憑協定名稱判斷。

type: vless

VLESS

VLESS 使用 UUID 驗證,協定本身不提供內容加密,常搭配 TLS 或 REALITY 等機制使用。實際連線也可能涉及傳輸方式、伺服器名稱與流控設定,這些參數都須與伺服器端相符。只有伺服器位址和 UUID 通常不足以完整還原節點;匯入時應保留提供者給出的其他欄位。

type: trojan

Trojan

Trojan 通常透過 TLS 連線傳送代理流量,並以密碼完成驗證。密碼正確不代表一定能連線,憑證有效性、伺服器名稱與傳輸方式也會影響交握。遇到憑證錯誤時,請先確認系統時間與節點參數;關閉憑證驗證會降低身分驗證強度,不應作為長期解決方式。

type: hysteria2 / QUIC

Hysteria2

Hysteria2 是以 QUIC 為基礎的代理協定,底層連線依賴 UDP 通道。設定中的頻寬參數用於壅塞控制相關設定,不代表線路保證能達到相同速度。若目前網路限制 UDP,即使網頁流量使用 TCP,也可能因底層代理連線無法建立而失敗;此時應檢查網路限制與伺服器狀態。

type: tuic / QUIC

TUIC

TUIC 是以 QUIC 為基礎的代理協定,可承載 TCP 與 UDP 流量。驗證資訊、協定版本與壅塞控制等設定須與伺服器端相容,不能直接套用其他 QUIC 協定的設定。測試時應分辨底層交握失敗與特定服務轉送失敗:前者優先檢查 UDP 是否可連線,後者還須檢查規則與轉送設定。

type: wireguard

WireGuard

WireGuard 是透過 UDP 傳輸、以公私鑰識別對端的隧道協定,Mihomo 可將其設定為出站。位址、公鑰、端點與 MTU 等參數會影響連線和資料傳輸,私鑰則屬於敏感設定。將 WireGuard 設為一個出站,不代表系統所有連線都會進入該隧道;實際流向仍由流量接管與分流規則決定。

規則與分流

先確認請求符合哪一條規則,再看規則指向哪個策略群組,最後確認群組中實際選用的節點。

mode: rule / rules

規則分流

規則分流是在規則模式下,依照設定順序為請求選擇處理目標的機制。目標可以是策略群組、特定代理,或 DIRECT 等內建處理方式;通常由最先符合的規則決定流向。排查網站出口錯誤時,應查看實際命中紀錄,再調整規則順序,而不是只在節點清單中反覆切換。

查看規則比對順序 →
proxy-groups

策略群組

策略群組透過 proxy-groups 定義,可將多個節點或其他策略群組組成一個可引用的目標。常見類型包括手動選擇、自動測試與故障轉移,不同類型會決定出口的選擇方式。規則命中策略群組後,最終使用的節點仍取決於群組狀態,因此規則名稱與目前節點名稱不一定相同。

查看策略群組設定 →
GEOIP

IP 地理規則

GEOIP 依據目標 IP 在地理資料庫中的歸屬進行比對,不會根據網頁語言或網站公司的註冊地判斷。資料庫可能有更新延遲,CDN 與共用基礎設施也可能讓直覺判斷與比對結果不同。網域請求進入這類規則時也可能涉及解析;使用 no-resolve 會影響是否為了比對而觸發解析。

查看 IP 規則與解析的關係 →
DOMAIN-SUFFIX

網域後綴規則

DOMAIN-SUFFIX 用於比對指定網域及其子網域,例如針對 example.com 的規則也會涵蓋其子網域。它不是比對任意字串是否包含在內,與 DOMAIN-KEYWORD 的用途不同。規則要生效,核心還須取得相應的網域資訊;若直接連線至 IP 或缺少網域關聯,就不能假設規則一定會命中。

查看網域規則寫法 →
MATCH

最終規則

MATCH 用於處理前面都未符合的請求,通常放在規則清單末尾。它指向哪個策略群組或處理方式,就會決定其餘連線的去向,並非必然代表全部代理。若放得太前面,後續規則可能沒有比對機會,因此新增規則時須確認插入位置。

查看最終規則設定 →

DNS與網路堆疊

解析、流量接管與出口選擇是不同環節。修改其中一個欄位,不會自動取代其他環節的設定。

tun.enable

TUN 模式

TUN 模式透過虛擬網路介面接收 IP 封包,再由核心處理連線,可涵蓋部分不遵循系統代理設定的應用程式。實際接管範圍仍受系統路由、程序排除項目、權限與用戶端實作影響。啟用後若無法上網,請檢查路由與 DNS 是否形成迴圈,不要把 TUN 當成單純擴大代理範圍的開關。

查看 TUN 與路由設定 →
enhanced-mode: fake-ip

Fake-IP

Fake-IP 是透過映射位址連結網域與連線請求的 DNS 運作模式,應用程式收到的位址不一定是網站的實際伺服器位址。核心利用映射保留網域資訊,再依規則建立後續連線。某些依賴真實位址的應用程式可能需要加入過濾設定;看到映射位址不代表解析失敗,應搭配實際連線結果判斷。

查看 Fake-IP 與過濾設定 →
enhanced-mode: redir-host

redir-host

redir-host 回傳實際解析出的 IP 位址給應用程式,而非 Fake-IP 的映射位址,適用於需要真實位址語意的情境。此模式仍須正確設定上游 DNS,並仰賴核心將連線與網域建立關聯。切換模式可能改變快取與應用程式行為;比較效果時應維持其他條件一致,並清除舊連線與 DNS 快取。

查看 DNS 模式選擇方式 →
dns.nameserver

上游 DNS

nameserver 用來指定 Mihomo 一般網域查詢所使用的上游解析器清單,可依支援格式填入一般 DNS 或加密 DNS 位址。它不是設定中所有查詢的唯一來源;策略解析、引導解析與代理伺服器網域解析也可能使用其他欄位。新增更多解析器不一定會更快,應先確認每個位址都可連線,且查詢路徑符合預期。

查看解析器的分工 →
tun.dns-hijack

DNS 劫持

在 TUN 設定情境中,DNS 劫持是將符合條件的 DNS 請求重新導向至核心解析器,以統一處理解析。這描述的是接管請求的行為,並非更換上游解析器的同義詞。一般 DNS 連接埠比對無法直接接管所有應用程式內的加密 DNS,仍須搭配應用程式設定、路由與實際請求形式判斷涵蓋範圍。

查看 DNS 請求接管方式 →
DNS leak

DNS 洩漏

DNS 洩漏通常是指網域查詢透過非預期的解析器或網路路徑送出,可能暴露瀏覽意圖。瀏覽器的安全 DNS、系統解析器與其他網路服務都可能參與查詢,僅查看網站出口 IP 無法完整判斷。測試前應先確認預期的解析路徑,再搭配查詢紀錄與出口檢查;解析器位於某個地區,不足以單獨證明發生洩漏。

查看 DNS 疑難排解方法 →

用戶端與平台

介面上的連線狀態、系統代理狀態與測試結果各有不同意義,須分別驗證。

GUI / core

圖形化用戶端

圖形化用戶端提供匯入設定、切換模式、選擇節點與檢視紀錄等介面,並負責啟動或管理核心。不同用戶端可能採用不同的設定合併方式,同名按鈕也未必會產生完全相同的欄位。參閱教學時,應先確認適用的應用程式與平台;判斷設定的最終效果,則須查看交由核心執行的實際設定。

依平台查看用戶端 →
HTTP / SOCKS / mixed-port

系統代理

系統代理是向作業系統登錄代理位址與連接埠的設定,通常由遵循此設定的應用程式使用。部分命令列程式、遊戲或採用自有網路堆疊的應用程式不會自動使用系統代理,因此開啟設定不代表所有流量都已接管。若瀏覽器能連線、某個應用程式卻無法使用,請檢查應用程式代理設定、環境變數或 TUN,而不是直接更換訂閱。

查看連線與驗證步驟 →
URL test / latency

延遲測試

用戶端的延遲測試通常會透過節點連線至指定網址,並測量所花時間,不一定等同於 ICMP Ping。結果會受測試目標、連線重用、DNS 與目前網路狀況影響,因此不同用戶端的數值不一定能直接比較。延遲低不代表下載頻寬高;測試逾時時,也應查看紀錄,確認是目標無法連線,還是代理連線失敗。

查看速度測試與連線問題 →
Android / VpnService

VpnService

VpnService 是 Android 提供給應用程式的 VPN 服務介面,用戶端可藉此建立虛擬網路介面並接收流量。系統授權代表應用程式獲准建立連線,不代表已取得遠端代理節點,或節點已可使用。分應用程式設定、其他 VPN 應用程式與系統省電策略都可能影響實際使用;若背景執行時斷線,須分別檢查。

查看行動裝置入門步驟 →