Clash / CONFIGURATION REFERENCE

Clash 術語手冊

從設定欄位查概念,從連線狀況追查路徑。依五種情境整理訂閱、規則分流與 mihomo 核心術語,每個項目都能透過錨點直接分享。

CONFIGURATION

核心概念

先分清設定來源、連線參數和測試結果。成功匯入只是設定流程的一步,還須啟用設定並確認出口。

訂閱Subscription

訂閱是透過連結取得並更新代理設定的方式,回傳內容可能是完整的 Clash YAML,也可能只是需要轉換的節點清單。匯入前請確認服務端提供的格式與用戶端相容;更新後再確認目前啟用的設定是否仍是該項目。

訂閱連結通常含有帳戶識別資訊,應視同憑證妥善保管,避免放入公開截圖或討論紀錄;匯入步驟請參閱訂閱匯入指南。

節點Proxy

節點是一組連線至代理伺服器的參數,通常包含伺服器位址、連接埠、協定和驗證資訊,在設定中通常列於 proxies 之下。策略組選定節點後,只有被規則送往該策略組的連線才會使用此節點。

節點名稱只是設定中的標籤,無法證明實際出口位置、頻寬或可用性;這些資訊須搭配實際連線結果和連線記錄判斷。

延遲測試Latency test

用戶端通常會透過指定代理向測試網址發出請求,再顯示這次請求所花的時間,實際計時方式則視實作而定。結果會受測試 URL、連線握手、伺服器回應和網路狀況影響,不能直接視為下載速度。

測試逾時可能只代表無法連線至測試網址;測試成功也不保證所有網站都能使用。選好節點後,仍應實際連線至目標網站,並在連線清單確認實際出口。

YAML 設定YAML

YAML 是 Clash 常用的結構化設定格式,以縮排表示層級,以連字號表示清單項目。編輯時請使用空格並維持同一層級的縮排一致;含有特殊字元的值須依 YAML 語法加上引號。

語法可解析不代表設定一定能執行;還須確認目前核心是否支援相關欄位、引用的策略組是否存在,以及用戶端是否在啟動時覆寫了相關設定。

PROTOCOLS

代理協定

本機入口協定和遠端節點協定是不同層面。應用程式連線至本機 HTTP 或 SOCKS 連接埠,不代表遠端節點也使用相同協定。

SOCKS5SOCKS version 5

SOCKS5 是應用程式與代理入口之間使用的協定,可處理 TCP 連線;UDP 轉送則須由應用程式和代理實作共同支援。應用程式使用本機 SOCKS 入口時,位址通常填寫回環位址,連接埠則以用戶端實際監聽設定為準。

是否將網域交由代理解析,取決於應用程式的連線方式;只選用 SOCKS5 但未啟用遠端解析,仍可能先在本機發出 DNS 查詢。

HTTP 代理HTTP proxy

HTTP 代理會接收應用程式送出的代理請求,連線至 HTTPS 目標時通常透過 CONNECT 方法建立通道。瀏覽器、命令列工具和開發環境經常支援這類入口,但不一定會自動讀取系統代理設定。

介面中的 HTTPS 代理欄位有時是指用來瀏覽 HTTPS 網站的代理,不一定代表連線至代理入口時使用 TLS;請依應用程式說明填寫協定和連接埠。

Shadowsocksss

Shadowsocks 使用約定的加密方式和金鑰傳送代理流量,Clash 設定中通常以 type: ss 標示。伺服器位址、連接埠、加密方式和密碼須與伺服器端設定相符,不能只憑協定名稱推定參數。

不同核心支援的加密方式可能不同;若設定遭拒絕載入,請先確認支援範圍。協定類型本身也無法說明節點速度或目前網路環境下的可用性。

TrojanTLS-based proxy protocol

Trojan 通常透過 TLS 連線完成驗證並傳送代理請求。設定時除了位址、連接埠和密碼,還可能需要指定伺服器名稱和傳輸設定。伺服器名稱會參與 TLS 連線流程,須符合伺服器憑證及部署需求。

連線失敗時,請確認系統時間、憑證、伺服器名稱和連接埠是否正確;直接關閉憑證驗證會略過伺服器身分檢查,不應作為一般修復方式。

ROUTING

規則與分流

規則負責比對,策略組負責提供出口。排查網站為何直連或經由代理時,應同時檢查命中的規則和策略組目前的選擇。

規則分流Rule-based routing

規則分流會依網域、目標位址等條件,將連線交由直連、拒絕或指定策略組處理。Rule 模式通常由上而下比對規則,由最先符合的規則決定出口,因此具體條件應放在 MATCH 這類兜底規則之前。

例如 DOMAIN-SUFFIX,github.com,PROXY 會將符合條件的網域交由名為 PROXY 的出口處理;設定中必須存在這個名稱,詳細操作請參閱規則分流指南。

策略組proxy-groups

策略組提供規則可選用的出口集合,成員可以是節點、其他策略組,或設定允許的內建出口。常見類型包括手動選擇的 select、依測試結果選擇的 url-test,以及依序尋找可用出口的 fallback。

修改某個策略組不代表所有連線都會切換;應先確認目標連線命中了哪條規則、進入哪個策略組,再查看該組最後指向的節點。

GeoIPIP geolocation database

GeoIP 使用位址資料庫判斷目標 IP 所屬地區,常見用法為 GEOIP,CN,DIRECT。它比對的是位址資訊,不是網頁內容或網域註冊地;CDN 調度和資料庫更新延遲都可能影響結果。

更新 GeoIP 不等於更新訂閱,也不等於更新網域規則集;若比對結果異常,請先確認實際目標位址,再參閱GeoIP 更新設定。

規則提供者rule-providers

規則提供者會將規則集合存放在獨立資源中,主設定透過 RULE-SET 引用,適合分別管理廣告網域、應用程式網域或 IP 位址範圍。設定時請確認資源格式、behavior 和更新週期,避免將網域清單當成其他類型讀取。

規則資源本身通常不會決定出口,出口由引用該資源的規則指定;下載成功後仍須確認引用順序,否則前面的寬泛規則可能已先行比對。

DNS & NETWORK

DNS 與網路

請區分網域解析和流量接管。開啟設定後,還須確認應用程式的查詢與連線是否實際經過預期路徑。

DNSDomain Name System

DNS 會將網域解析為位址等記錄,系統、瀏覽器、應用程式和代理核心都可能參與這個流程。設定核心的 dns 區段,只會規定核心收到查詢後的處理方式,不代表裝置上的所有查詢都會自動交由核心處理。

排查解析異常時,請檢查系統解析器、應用程式內建的加密 DNS、TUN 的 DNS 接管和快取;並區分網域無法解析與已解析但連線失敗。

Fake-IPSynthetic address mapping

Fake-IP 會為查詢的網域指派內部對應位址;應用程式連線至該位址時,核心會還原網域並選擇出口。這個位址並非目標伺服器的真實位址,因此不能只憑解析結果判斷目標位置,也不適合交由未經核心的裝置直接連線。

區域網路服務或依賴真實位址的應用程式若出現相容性問題,可針對性檢查 fake-ip-filter,調整後再清除舊的 DNS 快取。

DNS 洩漏DNS leak

DNS 洩漏是指查詢偏離預期解析路徑,讓其他解析服務看見目標網域;關鍵在於解析路徑是否符合預期,而不只是解析器位於哪個地區。規則也可能刻意讓部分網域使用本機解析,須與意外繞過代理分開判斷。

檢查時請搭配測試結果、核心記錄和應用程式的 DNS 設定;加密 DNS 只會改變查詢的傳輸方式,無法單獨證明查詢經過預期代理。

TUN 模式Virtual network interface

TUN 模式透過虛擬網路介面接收流量,可涵蓋部分不遵循系統代理設定的應用程式;實際範圍取決於路由、權限和排除設定。桌面用戶端可能需要服務或系統管理員權限,行動平台通常透過系統 VPN 介面接管流量。

啟用後仍須檢查 DNS 路徑,以及是否與其他 VPN、虛擬網卡或區域網路路由衝突;TUN 成功接管流量,不代表所有連線都會依規則使用代理出口。

CLIENT & CORE

用戶端與核心

介面設定、執行中的設定和系統入口屬於不同層面。逐層定位問題,比反覆重新安裝用戶端更容易找出原因。

mihomo 核心mihomo

mihomo 是由 Clash Meta 演進而來的代理核心,負責協定連線、規則比對、DNS 和流量轉送。圖形化用戶端可以整合核心並提供管理介面,也可以透過用戶端支援的方式調整核心設定。

圖形介面應用程式更新與核心更新不一定同步;使用特定設定前,應確認實際執行的核心及其支援範圍,而不只是查看用戶端名稱或設定檔副檔名。

圖形化用戶端GUI client

圖形化用戶端提供訂閱管理、策略選擇、記錄檢視和系統整合介面,例如不同平台上的 Clash Plus、Clash Verge Rev 與 FlClash。用戶端可能在啟動時合併訂閱、覆寫設定和本機設定,因此執行中的設定不一定等同原始訂閱檔案。

若要長期保留修改,請先確認用戶端的覆寫或合併機制,避免訂閱更新後覆蓋手動編輯的內容;可前往下載頁依平台選擇用戶端。

系統代理System proxy

系統代理會為遵循系統代理設定的應用程式提供本機代理入口,常見設定方式是填入回環位址和用戶端監聽的連接埠。這不會統一接管所有網路流量;部分遊戲、終端工具或使用自訂網路設定的應用程式可能忽略此入口。

若用戶端結束後瀏覽器也無法連線,請檢查系統是否仍保留失效的代理位址;清除代理入口可恢復直接連線,但無法修復節點或訂閱本身的問題。

混合連接埠與控制連接埠mixed-port / external-controller

mixed-port 為 HTTP 與 SOCKS 請求提供共用入口,external-controller 則提供管理 API,用於控制和查詢核心。常見連接埠分別是 7890 和 9090,但用戶端可能會變更設定,使用前請查看實際設定。

應用程式的代理位址不可填入控制連接埠;在本機使用時,建議優先綁定回環位址。若要開放給其他裝置,請一併檢查驗證和防火牆設定,操作方式請參閱連接埠設定說明。