proxies
節點
節點是一組用來建立代理連線的伺服器參數,通常包含位址、連接埠、協定與驗證資訊,不只是單一 IP 位址。設定中的 proxies 可用來定義節點,再由策略組引用節點名稱。匯入後若無法連線,應分別檢查位址解析、連接埠是否可連、驗證參數及核心是否支援該協定;不能只因清單中出現名稱就認定節點可用。
CONFIGURATION · TERM INDEX
先從設定鍵名找到對應概念,再確認平台與適用條件。以下整理六大類、24 個常用術語;卡片標題可直接連結,方便對照記錄檔、訂閱內容與用戶端設定。
首次設定建議先閱讀入門教學;安裝方式、權限與各平台差異請參閱全平台指南。本頁欄位說明以支援相關功能的 Clash 生態系核心為前提,不代表所有用戶端都提供相同選項。
PROTOCOLS
先區分遠端連線參數與本機代理入口,再檢查驗證資訊及傳輸條件。
proxies
節點是一組用來建立代理連線的伺服器參數,通常包含位址、連接埠、協定與驗證資訊,不只是單一 IP 位址。設定中的 proxies 可用來定義節點,再由策略組引用節點名稱。匯入後若無法連線,應分別檢查位址解析、連接埠是否可連、驗證參數及核心是否支援該協定;不能只因清單中出現名稱就認定節點可用。
type: ss
Shadowsocks 是一種加密代理協定,常見設定欄位包括 server、port、cipher 和 password。用戶端與伺服器必須使用相容的加密方式及相同的驗證參數。不同核心支援的加密方式與擴充功能可能有所差異;移轉設定時應參照實際使用的核心文件,而非只複製伺服器位址。
type: trojan
Trojan 以 TLS 傳輸代理通訊,連線時通常需要伺服器、連接埠、密碼,以及用於 TLS 驗證的伺服器名稱。伺服器位址可能與憑證網域名稱不同,不要隨意將相關名稱欄位改成 IP。若出現憑證錯誤,請先確認系統時間、網域名稱與憑證鏈;停用憑證驗證會改變安全性,不應當作一般修復方式。
mixed-port
這兩種協定常用於應用程式連線至本機代理入口,與遠端節點使用的協定並非同一層級。mixed-port 可在同一個連接埠提供 HTTP 與 SOCKS 代理入口,但應用程式仍須遵循系統設定,或自行填入代理參數。若連接埠衝突,應先檢查本機的監聽程式;變更連接埠後,也要同步更新使用該入口的應用程式設定。
RULES & ROUTING
規則決定流量的去向,訂閱則提供設定內容,兩者應分開檢查。
rules
規則分流會依網域、目標 IP 或其他連線屬性選擇出口。rules 通常由上而下比對,採用第一條符合的規則。DOMAIN-SUFFIX 用於比對網域後綴,比對結果也取決於核心能否取得連線對應的網域名稱。自訂規則應放在可能涵蓋該規則的寬鬆規則之前;儲存後重新載入,再從連線詳細資訊確認實際命中的規則。
direct / reject / match
DIRECT 與 REJECT 是內建策略,分別用於直接連線與拒絕連線;MATCH 則是用來比對其餘流量的規則類型,三者不能視為同一類欄位。寫成 MATCH,DIRECT 表示其餘流量直接連線;寫成 MATCH,PROXY 則要求設定中確實存在名為 PROXY 的策略組或出口。兜底規則通常放在清單最後。
geoip
GeoIP 會將 IP 位址對應至地區資訊,常見寫法 GEOIP,CN,DIRECT 表示將資料庫判定為中國地區的目標 IP 設為直接連線。地區分類可能受資料庫更新、位址重新分配及 CDN 調度影響,不能據此推測節點延遲或服務商身分。更新時也應確認用戶端使用的資料庫格式與來源,避免檔案已替換,執行中的核心卻仍讀取舊資料。
subscription / proxy-providers
訂閱連結用於取得可更新的節點或完整設定;proxy-providers 則是在設定中載入節點集合的一種機制。用戶端更新訂閱時可能會覆蓋整份設定,而提供者更新通常只會變更其節點集合,因此本機規則應放在用戶端支援的覆寫或合併位置。訂閱網址可能包含存取憑證,排查問題時請隱藏完整網址,不要將它貼到公開記錄檔或截圖中。
PROXY GROUPS
規則引用策略組,策略組再選擇節點;組別類型決定採用手動、測試或依序選路。
type: select
select 讓使用者從候選節點或子策略組中手動選擇出口,適合需要固定線路的應用程式。規則引用的是策略組名稱,而非介面上目前顯示的節點名稱,因此切換候選節點通常不必修改規則。是否記住上次選擇,取決於用戶端及設定;若重新啟動後選擇改變,應先檢查選擇是否有保存,以及訂閱更新的行為。
type: url-test
url-test 會連線至指定的測試網址,依結果自動選擇候選出口;interval 用來設定測試間隔,tolerance 則可減少因延遲些微差異而切換的情況。測試數值反映當下至該目標的路徑狀況,不等於下載頻寬,也不代表所有網站都能開啟。比較結果時應使用相同的測試網址與網路環境,並區分測試逾時和應用程式無法連線。
type: fallback
fallback 依候選清單順序選擇可用出口,適合先使用固定線路、失效後再切換至備用線路的情境。其核心是優先順序,而非持續從所有候選項目中挑選延遲最低的節點。使用前應將主要線路排在前面,並確認測試目標確實能反映需要使用的服務;切換出口也不保證原有連線能繼續使用。
type: load-balance
load-balance 依所選的分配策略,將不同連線交由多個候選出口處理;實際演算法請確認目前使用的核心是否支援。它不會把多個節點合併成一條高速線路,單一連線通常仍由一個出口承載。對來源 IP 敏感的登入、付款或工作階段服務,建議使用固定選擇的策略組,避免不同請求因出口變動而觸發額外驗證。
DNS & NETWORK STACK
分別確認流量如何進入核心、網域名稱如何解析;不要把代理出口測試當成完整的網路檢查。
tun
TUN 透過虛擬網路介面與路由接管流量,可涵蓋部分未讀取系統代理設定的應用程式,但不保證接管所有連線。桌面用戶端可能需要服務元件或管理員權限;Apple 行動裝置通常則透過系統提供的通道功能實作。啟用後若出現異常,請分別檢查路由、DNS 及與其他 VPN 的衝突;若系統代理問題尚未釐清,不宜反覆疊加不同的流量接管方式。
enhanced-mode: fake-ip
Fake-IP 會為網域名稱回傳合成位址並保留對應關係,讓後續連線進入核心時仍能關聯原始網域名稱,協助完成分流。合成位址不代表網站實際部署於該位址,不能將它當作真實伺服器 IP 來查詢歸屬。區域網路服務或依賴真實解析結果的應用程式可能需要設定例外;調整後也應檢查系統與應用程式快取,避免繼續使用舊的對應資料。
dns routing
當網域查詢繞過預期路徑、由其他解析器接收時,通常稱為 DNS 洩漏;是否構成問題,應依預先設定的解析策略判斷。瀏覽器安全 DNS、系統解析、應用程式內建解析與核心 DNS 可能同時存在;網站的出口 IP 無法單獨證明查詢路徑正確。排查時應搭配解析器測試與連線記錄,確認查詢實際送往何處,再調整流量接管範圍。
system proxy
系統代理會將代理位址與連接埠登錄至作業系統,供遵循此設定的應用程式讀取;它並非強制轉送所有流量。瀏覽器、命令列工具及使用自有網路堆疊的應用程式可能採用不同設定,因此瀏覽器可用不代表所有軟體都已接入代理。退出用戶端後若網路異常,應檢查系統代理是否仍指向已停止監聽的本機連接埠,再決定要還原設定或重新啟動服務。
APPLE PLATFORM
安裝檔架構、網路權限與憑證存取應分別處理;完成授權不代表節點已連線。
network extension
Network Extension 是 Apple 提供的網路功能擴充架構,應用程式可利用相關功能實作通道與流量處理。不同用戶端可能採用不同實作,並非每個 macOS 用戶端都需要相同的擴充功能核准步驟。系統要求授權時,請先確認應用程式與開發者資訊,再依目前系統版本前往相應設定頁面操作;若用戶端使用其他輔助服務,則以實際顯示的權限需求為準。
vpn configuration
iOS 用戶端首次建立通道時,通常會要求允許新增 VPN 設定;核准後才能建立系統連線入口。這項授權不代表遠端節點有效,也不表示所有流量都會使用代理出口,實際去向仍由路由與規則決定。若無法建立連線,請先檢查系統 VPN 狀態及是否與其他通道衝突,再確認用戶端記錄檔與目前使用的設定。
keychain
鑰匙圈是 Apple 系統用來儲存密碼、憑證等敏感資料的機制,用戶端可能利用它儲存或讀取連線所需資訊。出現存取提示時,請確認要求存取的應用程式及具體項目,再選擇適當的授權範圍。鑰匙圈存取、核准網路擴充功能與管理員權限彼此獨立;反覆出現提示也可能與應用程式身分或已儲存項目有關,不建議直接刪除整個鑰匙圈。
arm64 / x86_64
macOS 安裝檔通常分為 Apple Silicon 的 arm64 與 Intel 的 x86_64 架構。選擇前可從 Apple 選單的「關於這台 Mac」查看晶片或處理器。Apple Silicon 可透過 Rosetta 執行部分 Intel 應用程式,但不代表其輔助元件與網路功能也同樣相容。建議優先選擇符合架構的原生安裝檔,並一併確認最低系統需求。
CORE & CLIENT
先確認實際執行的核心,再判斷欄位是否可解析,以及介面是否會覆寫設定。
mihomo
mihomo 延續 Clash Meta 分支的發展,負責協定連線、規則比對、DNS 與網路處理等底層功能。圖形化用戶端可以整合 mihomo,但應用程式名稱無法直接證明核心版本;設定相容性應查看用戶端提供的核心資訊。若遇到欄位無法辨識,請先確認執行版本與文件適用範圍,再確認用戶端是否篩除、改寫或重新產生設定。
graphical client
圖形化用戶端提供訂閱管理、出口選擇、記錄檔與系統整合介面;實際處理連線的是核心,兩者並非同一個元件。即使採用相同核心,不同平台的權限、背景執行方式與可用設定也可能不同。比較用戶端時,應分別確認作業系統支援、核心功能及設定管理方式;選擇建議請參閱橫向評測。
config.yaml
YAML 以縮排表示映射與清單關係,是 Clash 生態系常用的設定格式;同一層級的欄位應保持一致縮排,並使用空格而非定位字元。語法解析成功只代表結構可讀取,不代表目前核心支援相關欄位,也不代表節點與策略引用有效。編輯前請保留可還原的副本;修改後先查看解析錯誤,再確認實際生效的設定,避免本機變更被訂閱更新覆蓋。
external-controller
external-controller 供用戶端或管理面板讀取狀態、切換策略及管理連線;它的監聽連接埠不是 HTTP 或 SOCKS 代理入口。通常應限制為本機存取並設定驗證保護;只有在清楚了解存取控制方式時,才考慮開放給其他裝置。若面板無法連線,請先檢查監聽位址、驗證設定與核心狀態,不要將代理連接埠填入控制介面設定。