設定概念 · 欄位對照

Clash 術語指南

依概念找出設定問題:先釐清用戶端與核心,再檢查代理協定、規則、DNS 與更新欄位。

本頁收錄 25 個常用術語,涵蓋 Clash 生態系及 mihomo 常見設定。實際支援情況仍應以目前執行的核心及用戶端說明為準。每張卡片都有專屬錨點,可直接分享個別條目。

核心與用戶端

介面負責提供操作入口,核心負責網路處理,訂閱則負責分發設定。排查相容性問題時,必須分別確認這三個層次。

用戶端Client / GUI
提供匯入設定、代理開關、檢視記錄與更新入口的應用程式,實際網路處理通常交由核心負責。同一個用戶端可能支援切換核心,因此介面名稱相同,不代表協定能力完全一致。回報問題時,應同時記錄用戶端名稱、核心名稱及各自版本,而不只是提供應用程式截圖。
核心Core
負責讀取設定、處理代理協定、比對規則並轉送連線的程式。欄位能否生效,取決於核心及其版本,不只看設定頁是否有相應開關。用戶端升級、核心升級與更新訂閱是不同操作;僅重新整理訂閱,無法讓核心支援新協定。
mihomoClash Meta 的後續專案名稱
由 Clash Meta 專案演進而來的代理核心,支援規則分流、資源提供器、TUN 與 DNS 等功能,並非特定桌面介面的專屬名稱。它可以由圖形介面用戶端管理,也能獨立執行。複製設定前,請確認目前版本是否支援所需功能;版本演進關係請參閱核心差異說明。
Clash Meta歷史名稱與生態系標示
Clash 生態系中的核心分支名稱,後續以 mihomo 名稱維護。舊教學、設定註解及部分用戶端名稱仍可能保留 Meta 字樣,不宜只憑名稱判斷設定新舊。若遇到欄位解析錯誤,請先確認實際執行的核心版本與錯誤位置,再決定要更新核心或調整設定。
訂閱Subscription
透過遠端 URL 取得並更新設定或代理資源的分發方式。連結可能回傳完整 YAML 設定,也可能只回傳代理清單,兩者不能視為相同格式。更新完整設定可能會取代規則與策略群組;若要保留修改,宜使用用戶端支援的覆寫機制。訂閱連結可能含有存取憑證,請勿放入公開截圖、記錄或線上轉換服務。

代理協定

協定規範用戶端與伺服器的通訊方式;伺服器位址、驗證資訊、傳輸方式與 TLS 設定則共同構成可用的連線設定。

節點Proxy entry
代理連線設定的常用稱呼,通常包含伺服器位址、連接埠、協定類型、驗證與傳輸參數。節點名稱只是顯示標籤,不保證地理位置、頻寬或可用性。匯入後無法連線時,應檢查設定是否完整、核心是否支援該協定,以及本機能否連上伺服器,而不只是確認清單中是否顯示名稱。
Shadowsockstype: ss
常見代理協定,設定中通常使用 ss 類型,需提供伺服器位址、連接埠、加密方法與密碼等參數。用戶端與伺服器必須支援並使用相同的加密方法;部分設定也需要外掛程式或額外選項。協定名稱相同不代表所有實作都支援相同擴充功能,移轉設定時應逐項核對。
VMesstype: vmess
使用使用者識別碼等參數進行驗證的代理協定,可搭配不同傳輸方式與 TLS 設定。成功匯入只代表設定可供讀取,不代表識別碼、路徑或伺服器名稱一定正確。若驗證或交握失敗,請一併檢查伺服器參數與系統時間;單獨更換 DNS 通常無法解決驗證參數不符的問題。
VLESStype: vless
著重輕量驗證的代理協定,本身不提供傳輸加密,常搭配 TLS 或 REALITY 等機制使用。能否連線還取決於傳輸方式、伺服器名稱及相關交握參數,並非填入使用者識別碼就能完成設定。不同核心版本支援的組合可能不同,不要未經確認就將其他用戶端的欄位直接貼入 YAML。
Trojantype: trojan
通常透過 TLS 建立連線的代理協定,常見設定包括伺服器、連接埠、密碼與伺服器名稱。憑證驗證錯誤可能源自名稱不符、憑證鏈異常或本機時間錯誤,應先找出原因。略過憑證驗證會改變連線的安全條件,不宜將其作為所有交握錯誤的預設處理方式。

規則與分流

規則決定連線去向,策略群組則決定具體出口。查看命中記錄,通常比反覆更換設定更容易找出分流問題。

規則分流rules / DOMAIN-SUFFIX / MATCH
依網域名稱、目標 IP 等條件,選擇直連、代理或拒絕等處理方式的機制。規則通常由上往下比對,符合後便執行相應策略,因此過於寬泛的規則若放得太前面,可能會攔截後續更精確的規則。排查時先確認目前使用規則模式,再查看連線命中了哪條規則;兜底用的 MATCH 通常放在清單末尾。
策略群組proxy-groups
將多個代理或其他策略整合為單一出口,讓規則可以引用固定的群組名稱。select 通常供使用者手動選擇,url-test 依測試結果選擇出口,fallback 則著重依序選用可用出口。自動選擇會受測試目標與檢測週期影響,不代表一定能找出實際下載速度最快的線路。
規則集rule-providers / RULE-SET
將多項比對條件存放在獨立檔案中,方便更新與重複使用;通常先在 rule-providers 中宣告,再以 RULE-SET 引用。規則集的 behavior 與 format 必須符合檔案內容。成功下載資源不代表它已用於分流,還要確認引用名稱、規則順序與目標策略都正確。
GeoIPGEOIP
依據 IP 地理位置資料庫分類比對目標位址,適合補足網域規則未涵蓋的連線。資料庫標示不代表伺服器的精確實際位置;CDN、位址分配變動與資料庫更新時間都可能影響比對結果。網域連線套用這類規則時可能觸發解析;no-resolve 可限制為不因規則比對而觸發解析,使用前請先了解其取捨。
延遲Latency / URL test
用戶端探測指定測試目標所需時間的指標,實際意義會隨測試 URL、協定、連線重用與網路環境而異。測試值較低不代表下載速度一定較快,也不能保證特定網站可連線。比較時應維持測試條件一致,再以實際應用驗證;結果異常時,可依延遲問題排查說明逐項檢查。

DNS 與網路堆疊

流量是否進入核心、網域由誰解析,以及解析結果如何用於規則判斷,是三個不同問題。開啟一個開關,無法取代對整條連線路徑的檢查。

TUN 模式tun
透過虛擬網路介面與路由設定接管流量,可涵蓋部分不遵循系統代理設定的應用程式。通常需要額外權限,實際涵蓋範圍還取決於自動路由、排除路由及系統網路環境。啟用 TUN 不代表已接管所有 DNS 或所有應用程式;若與其他 VPN 同時使用,請特別檢查路由衝突與介面衝突。
DNSDomain Name System
將網域名稱轉換為 IP 位址等紀錄的系統,解析結果也可能用於後續規則判斷。作業系統解析、用戶端內建解析與瀏覽器加密 DNS 可能採用不同路徑,修改其中一項未必會影響其他路徑。檢查設定時,請區分解析器位址、DNS 查詢的出站方式與快取;詳細設定順序請參閱完整指南的 DNS 章節。
Fake-IPenhanced-mode: fake-ip
DNS 以虛擬位址回應應用程式,並由核心維護虛擬位址與網域對應關係的運作模式,方便後續依網域分流。應用程式取得的虛擬位址並非目標伺服器的真實位址,因此不能據此判斷伺服器位置。依賴真實解析結果的特殊應用程式可能需要加入 fake-ip-filter;調整後還應清除舊快取並重新建立連線。
DNS 洩漏DNS leak
DNS 查詢偏離預期路徑並送達非預期解析器的情況;是否屬於異常,應先釐清預期哪些查詢要走哪條路徑。啟用 TUN、Fake-IP 或加密 DNS,都無法單獨證明解析方式符合預期。請綜合作業系統設定、瀏覽器獨立 DNS、用戶端記錄與測試結果判斷;測試頁顯示的解析器地區也不能直接證明有 DNS 洩漏。
Redir-Hostenhanced-mode: redir-host
通常會向應用程式回傳實際解析位址的 DNS 增強模式,與 Fake-IP 回傳虛擬位址的方式不同。它可能較適合依賴真實位址的特定應用程式,但網域與連線之間的關聯條件也會不同。切換模式後,作業系統與應用程式可能仍保留舊 DNS 快取;建議清除快取或重新啟動相關應用程式後,再比較效果。

設定檔欄位

查看欄位時,名稱、所在層級與單位都要一併確認。看似相同的「更新間隔」,可能分別控制完整設定、代理資源或健康檢查。

YAMLconfig.yaml
Clash 常用的設定資料序列化格式,透過縮排表示層級,並以鍵值與清單組織欄位。縮排請使用空格,不要使用定位字元;含特殊字元的字串可依語法需求加上引號。YAML 語法正確不代表核心支援所有欄位,修改後應先檢查設定結果,再載入使用,並保留可還原的原始設定。
moderule / global / direct
指定核心運作模式的頂層欄位,常見值為 rule、global 與 direct,分別代表規則、全域與直連模式。它決定進入核心的連線如何選擇路由,不負責讓應用程式流量自動進入核心。全域模式不代表系統中的所有應用程式都會使用代理,還需確認系統代理或 TUN 是否涵蓋目標應用程式。
proxy-providers代理資源提供器
用來宣告代理資源來源,可從遠端位址或本機檔案讀取代理清單,並依設定更新。它與完整設定訂閱不同:資源清單通常不負責定義整套規則與 DNS 設定,載入後還需由策略群組引用。排查資源更新失敗時,應分別檢查位址是否可連線、回傳格式、本機快取路徑與引用關係。
interval欄位層級與時間單位
表示時間間隔,但實際意義取決於所在層級:提供器的 interval 通常控制資源更新,health-check.interval 則控制可用性檢測,常見單位皆為秒。用戶端的完整設定更新介面可能以分鐘為單位,兩者的數值不能直接照搬。縮短間隔無法修復格式或驗證錯誤;更新失敗時,可先參閱訂閱更新問題排查。
mixed-portHTTP / SOCKS 共用監聽連接埠
在同一個連接埠提供 HTTP 與 SOCKS 代理入口,讓應用程式使用統一本機監聽連接埠。若連接埠已被其他程式占用,核心可能無法建立監聽;請查看記錄確認原因,不要只修改系統代理位址。允許區域網路連線還涉及監聽位址、防火牆與存取控制,不能只在另一台裝置填入連接埠號碼就視為設定完成。