mihomo 核心
Proxy engine / mihomomihomo 是 Clash 生態系中的代理核心,負責解析設定、比對規則、處理 DNS 與轉送連線。核心不是圖形介面;要確認設定是否可用,需檢查實際使用的核心及其支援的欄位。即使不同用戶端名稱相同,也不能據此推斷不同安裝環境中的核心功能完全一致。
mode: rule
CLASH / CONFIGURATION GLOSSARY
核心、規則、DNS 與連接埠。依設定所在環節查找術語,再對照實際生效值。
本頁收錄 24 個常用術語,每個項目都有獨立錨點,可複製網址連結至說明位置。初次設定請先看入門指南;已有錯誤訊息,請前往疑難排解手冊,依症狀逐步檢查。
先分清楚負責執行連線的核心、操作介面與連線參數。
mihomo 是 Clash 生態系中的代理核心,負責解析設定、比對規則、處理 DNS 與轉送連線。核心不是圖形介面;要確認設定是否可用,需檢查實際使用的核心及其支援的欄位。即使不同用戶端名稱相同,也不能據此推斷不同安裝環境中的核心功能完全一致。
mode: rule
圖形化用戶端提供訂閱管理、策略選擇、日誌檢視及系統代理切換。介面設定可能會產生或覆寫核心設定;排查時應查看實際生效的設定,而不只看匯入的原始檔案。選擇用戶端時,先確認平台與架構,再確認所需功能的操作位置,詳見用戶端比較。
代理節點是一組用來建立遠端連線的參數,通常包含伺服器位址、連接埠、協定及驗證資訊。節點出現在清單中,只代表設定已成功識別;能否連線仍取決於參數、網路與伺服器狀態。節點名稱只是便於辨識的標籤,無法證明實際出口地區或協定類型。
proxies:
用戶端通常會透過節點連線至指定測試位址,以測量回應時間,這不等同於 ICMP ping。測試結果會受目標位址、交握過程與網路路徑影響,不能直接代表下載速度或所有網站都能正常連線。出現 timeout 時,先確認測試位址是否可連線,再參照疑難排解手冊檢查本機網路與節點連線。
type: url-test
協定名稱決定參數結構,傳輸層與驗證欄位也必須相互配合。
Shadowsocks 是一種加密代理協定,設定時需與伺服器位址、連接埠、加密方式及密碼相符。訂閱匯入成功後若仍無法連線,請先確認加密方式及額外外掛需求,不可用其他協定的欄位替代。是否能轉送 UDP,還取決於節點設定與伺服器支援,不能單憑名稱中的 SS 判斷。
type: ss
VMess 是一種需要用戶端與伺服器配套設定的代理協定,常見的識別欄位為 UUID。使用 WebSocket 或 TLS 時,也要確認傳輸路徑、主機名稱及憑證設定;只有 UUID 正確,仍不足以確保連線成功。若日誌出現驗證或交握錯誤,也應先確認系統時間正確,再繼續檢查傳輸參數。
type: vmess
VLESS 是一種輕量代理協定,本身不提供等同 TLS 的傳輸加密。是否使用 TLS 或 REALITY、是否設定 flow,都應以伺服器設定為準,不能只修改協定名稱來轉換節點。匯入前也應確認目前使用的核心支援所需組合,避免將欄位不相容誤判為伺服器故障。
type: vless
Trojan 通常透過 TLS 傳輸代理連線,並使用密碼驗證。排查時除了位址與密碼,也要確認伺服器名稱及憑證驗證結果;不應預設以略過憑證驗證作為修復方式。若伺服器另有 WebSocket 等傳輸方式,用戶端也必須提供相應參數,不能只填入伺服器連接埠。
type: trojan
規則決定由誰處理連線,策略群組則決定使用哪條連線路徑。
規則模式會依 rules 清單由上而下比對連線,符合後交由指定策略處理。調整規則時,應將具體條件放在較寬泛的條件之前,並查看連線記錄中的命中規則,確認變更確實生效。通常會在末尾使用 MATCH 處理先前未符合規則的連線;使用全域模式時,不能依照規則模式的預期判斷流量出口。
DOMAIN-SUFFIX,example.com,DIRECT
策略群組會將多個節點或其他策略整理成一個可供規則引用的名稱。select 用於手動選擇,url-test 則依測試結果選擇;群組內的選擇不會改變規則順序,也不代表所有應用程式都會使用該群組。若遇到「更換節點但出口沒有改變」,先檢查連線命中了哪個群組,再確認變更的是該群組目前使用的選項。
proxy-groups:
DIRECT 表示連線不經代理節點,直接連至目標;REJECT 則表示拒絕符合條件的連線。兩者都是內建策略,PROXY 則常用作自訂策略群組名稱;使用前應確認設定中確實存在該名稱。直連不代表略過本機所有路由設定;判斷拒絕規則是否誤攔,也需參照命中記錄。
DOMAIN-SUFFIX,example.com,REJECT
GeoIP 依 IP 資料庫中的地理位置比對目標位址,比對結果不代表內容所屬地區或營運主體所在地。CDN 與位址變更可能影響比對結果;規則中的 no-resolve 可避免為該規則主動觸發網域解析。若要穩定比對明確的網域集合,應優先考慮網域規則,而非只依賴位址所屬地區。
GEOIP,CN,DIRECT,no-resolve
先確認網域如何解析,再檢查流量如何進入核心。
DNS 解析會將網域名稱轉換為連線所需的位址;解析路徑與最後的連線路徑是不同環節。啟用核心 DNS 後,仍需確認應用程式的請求確實交由該解析器處理;瀏覽器的安全 DNS 或系統設定可能採用其他路徑。若網域無法開啟但 IP 位址可以連線,請檢查解析回應、快取及實際使用的解析服務。
dns:
Fake-IP 會在 DNS 查詢時回傳合成位址,並由核心保留網域對應關係,方便後續依網域處理連線。若特定應用程式出現相容性問題,可檢查 fake-ip-filter;切換模式後也應清除舊的 DNS 快取並重新建立連線。解析結果出現合成位址不代表一定有錯,關鍵在於後續流量能否進入保有對應資訊的核心。
enhanced-mode: fake-ip
TUN 透過虛擬網路介面接收 IP 層流量,可涵蓋部分不讀取系統代理設定的應用程式。它需要權限、路由與 DNS 相互配合,並不代表啟用後就一定會接管所有流量;排查時應先確認虛擬介面與路由是否已建立。同時執行其他 VPN 可能造成路由衝突,測試時可逐一停用以縮小問題範圍。
auto-route: true
DNS 洩漏是指網域查詢偏離預期的解析路徑,並暴露給不希望使用的解析服務。檢查時應核對系統、瀏覽器與用戶端設定,並區分本機查詢的出口與遞迴解析器的出口,不能只憑地區標籤下結論。使用加密 DNS 只能表示相關查詢路徑已加密,不能單獨證明查詢經過預期的代理。
分清楚設定來源、檔案結構與可獨立更新的資源。
訂閱連結是取得節點清單或完整設定的遠端網址,並不等同於用戶端軟體本身。更新失敗時,先檢查回應內容與格式是否相容;連結可能含有存取憑證,提交日誌或截圖前請遮蔽完整網址。若回傳的是網頁、登入提示或錯誤訊息,不能只改副檔名就將它轉成可用的 YAML 設定。
查看訂閱匯入步驟YAML 以縮排表示資料層級,Clash 設定通常儲存為 config.yaml 檔案。編輯時請使用空格而非 Tab,並保持同層縮排一致;語法解析通過只代表結構合法,欄位是否受支援仍須由核心判斷。發生錯誤時,也應檢查出錯行附近上一層的縮排,避免只修改錯誤行卻留下結構問題。
config.yaml
Proxy Provider 可將一組節點作為獨立載入與更新的資源,再由策略群組引用。資源載入成功後,還需透過 use 等設定將其加入策略群組;只定義 provider 而未加以引用,不會自動形成完整的分流方案。若節點清單為空,應分別檢查資源取得、內容解析與策略群組引用,避免將不同問題混為一談。
proxy-providers:
Rule Provider 用於獨立管理一組規則比對條件,再透過 RULE-SET 指定處理策略。資源格式需與 behavior 和 format 設定相符;規則集被引用的位置仍會參與由上而下的比對順序。更新規則資源不會自動調整策略群組,命中後使用的出口仍由引用該規則集的規則指定。
rule-providers:
分別檢查本機監聽、應用程式設定與區域網路存取。
系統代理會將代理位址寫入作業系統的相關設定,供遵循該設定的應用程式使用。這不等於接管所有流量;若瀏覽器可用但其他應用程式無法使用,請先確認應用程式是否讀取系統代理,而不是立刻更換節點。關閉用戶端後若仍無法連線,也應檢查系統是否留有指向已停止監聽連接埠的代理設定。
mixed-port 讓同一個本機連接埠同時接受 HTTP 代理與 SOCKS 代理請求。應用程式填入的位址與連接埠必須符合實際監聽值;連接埠被占用會導致監聽失敗,設定中的範例數字不代表用戶端目前必定使用該連接埠。以下 7890 僅為欄位範例,實際值請以用戶端設定與啟動日誌為準。
mixed-port: 7890
127.0.0.1 與 IPv6 的 ::1 都指向本機,常用於應用程式連線至本機代理。部分 Windows UWP 應用程式會受到沙箱回送限制,需逐一檢查應用程式的回送豁免設定;啟用區域網路存取無法取代這項權限設定。其他裝置填入 127.0.0.1 時,連線目標是該裝置本身,而不是執行 Clash 的電腦。
127.0.0.1 / ::1
allow-lan 控制是否允許其他裝置存取核心的代理監聽服務,也需配合監聽位址與防火牆設定。僅在可信任的網路環境中按需啟用,並設定存取限制;代理連接埠與控制介面的用途不同,不應一併公開至網際網路。其他裝置連線時,需填入執行用戶端裝置的區域網路位址,並確認裝置之間可以互相連線。
allow-lan: true