設定欄位 / 概念界線 / 疑難排解線索

Clash 術語指南

從介面設定到核心欄位,依六類查詢 24 個常見術語。先辨別流量如何進入用戶端,再確認規則如何選擇出站,最後檢查 DNS 與訂閱設定。

執行核心與操作介面

核心與用戶端

用戶端負責管理入口,核心負責處理連線。排查問題時,應記下兩者的名稱,而不只看視窗標題。

Clash 用戶端#
GUI / client用戶端提供匯入訂閱、選擇策略群組、查看記錄與切換代理等介面,實際連線通常由核心處理。同一個核心可以搭配不同用戶端,介面選項名稱與設定合併方式也可能不同。若某個欄位未生效,應同時確認核心是否支援,以及用戶端是否將該欄位寫入最終執行設定。
mihomo 核心#
mihomo / Clash Metamihomo 是從 Clash Meta 發展而來的代理核心,負責協定連線、規則比對、DNS 處理與 TUN 等功能。用戶端介面出現 Clash 字樣,不代表實際執行的就是同一種核心。設定中的協定類型、規則語法與實驗性選項,應以目前執行的核心文件及啟動記錄為準。
節點#
proxies / outbound節點通常指一個可選的遠端代理出站,包含協定類型、伺服器位址、連接埠與驗證參數。安裝用戶端只會取得連線工具,節點則須由可用設定或訂閱提供。節點名稱只是顯示標籤,無法證明線路所在地、頻寬或可用性;排查連線問題時,應檢查實際參數與錯誤記錄。
延遲測試#
url-test / timeout延遲是依指定測試目標與方法測得的回應時間,不等於下載速度,也不一定只是網路往返時間。不同用戶端可能採用不同測試網址,結果不宜直接比較。發生逾時時,可能是測試目標無法連線、節點連線失敗或解析異常,應搭配實際瀏覽網站的情況與記錄繼續排查。

本機入口與遠端傳輸

代理協定

本機應用程式連線的代理入口,與用戶端連接遠端伺服器所用的協定,屬於不同層次。

HTTP 代理#
HTTP / CONNECTHTTP 代理讓應用程式向代理入口傳送請求,HTTPS 連線通常透過 CONNECT 方法建立通道。應用程式填入本機 HTTP 代理位址,不代表遠端節點也使用 HTTP 協定。HTTP 代理本身不會自動加密所有傳輸;目標網站的 HTTPS、本機入口傳輸與遠端節點加密應分別理解。
SOCKS5#
SOCKS / UDP ASSOCIATESOCKS5 用於向代理入口提交目標位址與連線請求,常見於瀏覽器、開發工具及命令列程式的代理設定。此協定可承載 TCP,也定義了 UDP 轉送方式,但 UDP 是否可用仍取決於應用程式、用戶端與遠端鏈路。網域名稱是在本機還是代理端解析,也應依個別應用程式的選項確認。
Shadowsocks#
type: ssShadowsocks 是一種遠端代理協定,設定中的加密方式與驗證參數必須和伺服器相符。只有伺服器位址與連接埠,通常不足以建立有效連線;外掛等額外要求也應與伺服器端一致。匯入後無法連線時,請先確認核心支援相應方式,再檢查參數,不要直接歸因於規則模式。
TLS#
TLS / SNI / servernameTLS 用於保護傳輸連線並驗證伺服器身分,常見於多種代理協定的外層傳輸。SNI 是交握時傳送的伺服器名稱資訊,憑證驗證還會檢查名稱是否相符及憑證是否可信。交握失敗時,應檢查系統時間、伺服器名稱與憑證鏈,不宜將略過憑證驗證當成一般修復方式。

連線進入核心之後

規則與分流

規則決定「交給哪個出站」,策略群組則決定「目前選了哪個節點」。兩者都應一併檢查。

規則分流#
mode: rule / rules規則模式會由上而下檢查 rules,通常由第一條符合的規則決定出站。例如 DOMAIN-SUFFIX,example.com,PROXY 會將該網域及其子網域交給 PROXY;最後的 MATCH,PROXY 則接收前面未符合規則的連線。範圍較廣的規則若放得太前面,後續更精確的規則可能無法生效。
策略群組#
proxy-groups / select / url-test策略群組會將多個出站整理成可供規則引用的名稱,設定欄位為 proxy-groups。select 群組供手動選擇,url-test 群組則依指定網址的測試結果自動選擇;自動測試不代表對所有網站都會選到最快的線路。規則指向某個群組時,還應查看群組目前選取的項目,不能只看規則名稱。
GeoIP#
GEOIP,CN,DIRECTGeoIP 依 IP 地理位置分類資料庫比對目標位址,常用於將特定地區的位址交給指定出站。它不同於依網域分類的 GeoSite,也無法單憑此判斷網站的營運者或服務內容。網域連線命中 IP 規則時,可能需要先進行解析,因此資料庫狀態、解析結果與規則順序都會影響最終比對結果。
規則集#
rule-providers / RULE-SET規則集會獨立管理一批網域、IP 網段或完整比對條件,透過 rule-providers 載入,再由 RULE-SET 規則引用。宣告的行為類型與檔案格式必須符合實際內容;檔案下載成功不代表主設定已使用這些規則。排查時應依序檢查載入記錄、引用名稱、出站名稱與規則排列順序。

接管方式與出站模式

網路模式

系統代理與 TUN 是流量入口方式,規則與全域則是出站選擇方式。啟用其中一項不會自動取代另一項。

系統代理#
system proxy / loopback系統代理會在作業系統中登記本機代理位址,讓採用此設定的應用程式將請求傳送至用戶端的監聽連接埠。部分遊戲、命令列程式或自帶網路設定的應用程式可能不會使用系統代理,因此即使開關已開啟,也不代表所有連線都已被接管。關閉用戶端後若網頁無法存取,應檢查系統是否仍保留指向已關閉連接埠的代理設定。
TUN 模式#
tun / auto-route / dns-hijackTUN 透過虛擬網路介面與路由規則接收流量,可涵蓋部分不採用系統代理的程式。通常需要相應權限或服務元件,實際接管範圍還受路由排除項目、網路環境與用戶端實作影響。啟用後若與其他 VPN 衝突,應先檢查預設路由與 DNS,不要同時反覆切換多種流量接管工具。
全域模式#
mode: global / GLOBAL全域模式會將進入核心的連線交由 GLOBAL 目前選取的出站處理,不再依一般 rules 分流。它改變的是出站選擇邏輯,不會自動讓原本繞過用戶端的程式進入代理。暫時比對規則問題時可以使用全域模式,但仍須確認 GLOBAL 選取的項目;切回規則模式後,再檢查原有的比對結果。
混合連接埠#
mixed-port: 7890混合連接埠會在同一個監聽連接埠接收 HTTP 與 SOCKS 代理請求,欄位名稱為 mixed-port。7890 是常見範例值,並非所有用戶端都固定使用此連接埠;手動設定應以目前生效的值為準。區域網路中的其他裝置能否連線,還取決於監聽位址、allow-lan 與防火牆,不能只修改連接埠號碼。

網域、位址與解析路徑

DNS 與解析

DNS 負責取得位址,分流規則則負責選擇連線的出站。能開啟網站,不足以證明解析路徑符合預期。

DNS 解析#
dns / nameserverDNS 會將網域名稱轉換為 IP 位址等紀錄,應用程式通常會在連線至目標前先查詢。作業系統、瀏覽器與核心可能各自維護快取或選用不同解析器,因此更換一處 DNS 不一定會影響所有應用程式。排查解析問題時,應分辨目標網域解析、代理伺服器網域解析,以及解析器本身建立連線時所需的位址查詢。
Fake-IP#
enhanced-mode: fake-ipFake-IP 會為網域名稱配置映射位址;應用程式連線至該位址時,核心可還原網域資訊並據此處理分流。記錄中看到的映射位址不是網站伺服器的實際位址,也不應用來判斷節點所在地。某些依賴實際解析結果的應用程式可能需要例外處理,請針對特定網域設定篩選,避免直接排除所有網域。
DNS 洩漏#
resolver path / DNS interceptionDNS 洩漏是指查詢偏離預期路徑,例如原本預期由核心處理的查詢,仍送往其他解析器。檢測頁面顯示的解析器可能使用轉送或任播,不能只憑名稱或所在地直接下結論。應一併檢查系統 DNS、瀏覽器加密 DNS、TUN 劫持設定與實際記錄;只啟用 Fake-IP 不足以證明所有 DNS 查詢都已受控。
nameserver-policy#
dns.nameserver-policynameserver-policy 會依網域比對條件指定 DNS 上游,讓不同網域使用不同解析器。它決定要向哪個解析器查詢,不會直接取代 rules 決定連線要透過哪個節點送出。修改後還應檢查比對語法、解析器的連線路徑與舊快取,避免將快取中的舊答案誤認為新設定未載入。

設定來源與最終生效內容

訂閱與設定

訂閱更新、本機編輯與用戶端覆寫可能同時存在。排查設定問題時,應以最終送入核心的設定為準。

訂閱#
subscription / profile訂閱透過連結分發節點清單或完整設定,內容範圍取決於提供者與用戶端的匯入方式。更新成功通常只代表已取得內容,還須確認目前設定已啟用、策略群組存在,且已選取可用的出站。訂閱連結往往包含存取憑證,分享記錄或截圖時應隱藏連結與驗證資訊,避免將其當作一般公開網址傳播。
YAML#
config.yaml / indentationYAML 是 Clash 常用的結構化文字設定格式,透過縮排表示映射與清單的層級。編輯時應統一使用空格縮排,不要用定位字元代替層級空格;含有特殊符號的字串也要留意引號。語法檢查通過只代表檔案結構可解析,不代表欄位名稱、節點引用或目前核心的支援範圍都正確。
覆寫#
override / merge / patch覆寫會將本機 DNS、規則或其他偏好保存在訂閱原始內容之外,再由用戶端合併產生執行設定。這適合保留不希望在訂閱更新後遺失的設定,但不同用戶端的合併順序與陣列處理方式並不相同。若發現規則重複、欄位消失或順序改變,應檢查最終設定,不要只比對訂閱檔案與覆寫檔案各自的內容。
proxy-providers#
proxy-providers / useproxy-providers 會依來源載入一組節點,策略群組可透過 use 引用,方便將節點更新與主設定管理分開。它載入的是代理出站,與載入比對條件的 rule-providers 不同。來源檔案格式、引用名稱與更新狀態都應核對;只宣告提供者而未在可用策略群組中引用,不一定會顯示在預期的選擇位置。