官方手冊 · 術語參考

Shadowrocket 名詞解釋

先區分介面選項、匹配條件與執行策略,再查閱個別參數。本頁保留英文原文,依使用情境說明常見術語;每個詞條都可透過錨點直接定位。

Shadowrocket 是 Apple 平台的付費用戶端,唯一取得管道為 App Store。用戶端一次買斷 ≠ 連線服務方案;以下連線說明皆以使用者已有自己的訂閱或伺服器資訊為前提。

01 / INTERFACE

介面與開關

這些名稱描述操作入口或整體運作方式,不是可直接貼入設定檔的語法。

介面與開關

Global Routing

決定整體流量處理方式的介面入口,常見的三種選項是設定檔、代理、直連,介面原文分別為 Config、Proxy、Direct。這與單條規則中的策略屬於不同層級;切換後可能影響目前設定檔中的規則是否參與處理。流量分流不如預期時,先確認此處選項,再檢查規則內容。

介面與開關

Config

在 Global Routing 中,表示依目前啟用的設定檔處理流量;在其他位置也可能指設定檔相關入口。選擇 Config 不代表所有連線都會經過代理,實際結果取決於匹配的規則及其策略。確認時應一併檢查目前設定檔、規則順序與末尾的 FINAL。

介面與開關

Proxy

Global Routing 中整體採用代理路徑的選項,具體適用範圍仍須配合 App 設定確認。此選項可用來比較同一連線在不同處理方式下的表現,但無法修正伺服器參數錯誤。請勿將此選項與規則中的大寫 PROXY 混為一談。

介面與開關

Direct

Global Routing 中整體採用直接連線路徑的選項。這與只套用於匹配連線的 DIRECT 規則策略不同,也不等於關閉所有網路相關設定。比較連線結果時,應維持目標位址與本地網路不變,避免同時更動多項條件。

介面與開關

On Demand

依設定的網路或連線條件觸發連線行為,減少反覆手動切換。Wi-Fi、Cellular 等是需要確認的介面條件名稱,不是獨立的設定檔語法。設定後應分別切換至相應網路測試,並確認是否與預期的手動操作衝突。

介面與開關

Add Server

用來輸入使用者已有伺服器資訊的入口,通常需選擇類型並填寫位址、連接埠與驗證參數。選擇協定後顯示的欄位可能不同,請逐項對照自己的伺服器資料,不要只填位址。儲存項目僅代表完成輸入,仍須選取該項目並測試連線。

介面與開關

Connectivity Test

用來檢查指定測試條件下的連線狀況,結果會受到測試目標、目前網路與伺服器狀態影響。單次測試成功不代表所有 App 都能正常連線;測試耗時也不等於持續下載速度。排查時應一併比對測試結果、實際連線、匹配規則與連線記錄。

02 / PROTOCOLS

代理協定

協定決定兩端如何通訊;選擇時應依據現有伺服器的實際設定,而非只看協定名稱。

代理協定

Shadowsocks

一種代理協定,常見連線參數包括伺服器位址、連接埠、密碼與加密方法。加密方法必須與伺服器端一致,不能任意更改用戶端設定後仍期待正常連線。若現有資料還包含其他參數,請依原始說明逐項確認,避免複製時遺漏。

代理協定

VMess

一種使用使用者識別碼等參數進行驗證的代理協定,連線也可能涉及傳輸方式與 TLS 設定。識別碼相同不代表傳輸參數可以通用;路徑、伺服器名稱等欄位也可能影響交握。匯入後應對照原始資訊逐項檢查,不要只確認協定類型。

代理協定

VLESS

一種使用使用者識別碼驗證的代理協定,不能只憑名稱推斷其傳輸層保護方式。實際連線須一併確認傳輸設定、TLS 與伺服器端要求,相關欄位應依使用者現有的設定資訊填寫。請勿直接套用其他協定的參數至 VLESS 項目。

代理協定

Trojan

一種通常搭配 TLS 使用的代理協定,密碼只是連線參數之一。連接埠、伺服器名稱與憑證驗證設定也可能影響連線建立。遇到憑證錯誤時,應先確認網域、憑證與裝置時間,不應預設略過驗證。

代理協定

Hysteria2

一種以 QUIC 為基礎的代理協定,連線仰賴相應的 UDP 通訊條件。排查時除了位址與驗證資訊,也應檢查 TLS 及本地網路的 UDP 可達性。同一項目在 Wi-Fi 與行動網路下表現不同,可能與網路路徑有關,不能只憑協定名稱判斷原因。

代理協定

WireGuard

一種以金鑰配對進行驗證的通道協定,設定包含本端金鑰、對端公開金鑰、Endpoint 與位址等資訊。公開金鑰與私鑰用途不同,不可互換填寫;私鑰應視為敏感憑證妥善保管。連線建立後仍須確認路由與 DNS;交握成功不代表所有目標都可連線。

代理協定

HTTP / SOCKS5

兩種常見代理協定,雖然都可能使用位址、連接埠與帳號密碼,但通訊方式不同。不能只因伺服器位址相同就互換類型;UDP 支援與驗證方式也須依個別設定確認。協定名稱本身不保證傳輸已加密,請確認連線是否另有相應的保護機制。

03 / MATCH & POLICY

規則關鍵字與策略

規則前半段描述匹配條件,後半段指定執行策略;通常由上而下處理,先匹配的項目生效。

查看完整設定參考
規則關鍵字與策略

DOMAIN

依完整網域名稱匹配,例如 DOMAIN,example.com,PROXY。這條規則不會自動涵蓋所有子網域,www.example.com 需另行處理。只想處理明確的主機名稱時,可優先使用這種範圍較小的條件。

規則關鍵字與策略

DOMAIN-SUFFIX

依網域後綴匹配,例如 DOMAIN-SUFFIX,example.com,PROXY,通常涵蓋該網域及其子網域。這裡指的是網域層級的後綴匹配,不是任意文字包含。若要個別處理某個子網域,請將更具體的規則排在此規則之前。

規則關鍵字與策略

DOMAIN-KEYWORD

依網域中包含的關鍵字匹配,例如 DOMAIN-KEYWORD,example,PROXY。涵蓋範圍可能比預期更廣,只要網域包含相應文字就可能匹配。使用前應列出要處理的目標,並確認是否能改用更明確的 DOMAIN 或 DOMAIN-SUFFIX。

規則關鍵字與策略

GEOIP

依目標 IP 在地理資料庫中的歸屬匹配,例如 GEOIP,CN,DIRECT。判斷依據不是頁面顯示的語種、帳號地區或使用者所在地,結果也可能受解析出的位址與資料庫內容影響。若要精確處理特定網域,不宜只依賴地理歸屬規則。

規則關鍵字與策略

IP-CIDR / IP-CIDR6

分別用來匹配 IPv4 與 IPv6 位址範圍,斜線後的前綴長度決定位址範圍大小。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示一段 IPv4 私有位址範圍。新增規則前應確認目標位址類型;IPv4 規則不能取代相應的 IPv6 判斷。

規則關鍵字與策略

USER-AGENT

依連線中可辨識的 User-Agent 資訊進行匹配,而不是讀取裝置上所有 App 的身分。此功能受流量類型、連線資訊可見度及實際處理方式限制,不能視為通用的 App 識別功能。使用前請確認目前連線確實提供可供匹配的資訊。

規則關鍵字與策略

FINAL

前面的規則都未匹配時使用的備援規則,通常放在規則清單末尾。例如 FINAL,PROXY 表示將其餘連線交由 PROXY 處理,不會強制覆蓋前面已匹配的項目。連線去向不如預期時,應先檢查前面的規則,再修改 FINAL。

規則關鍵字與策略

PROXY

規則中表示採用代理路徑的策略關鍵字,實際連線仍取決於目前選用的伺服器或相關策略設定。規則匹配 PROXY 只代表處理方向,無法證明伺服器驗證、傳輸及目標連線都已成功。請依所在位置區分此關鍵字與 Global Routing 中的 Proxy 選項。

規則關鍵字與策略

DIRECT

規則中表示直接連線至目標位址的策略關鍵字,例如 DOMAIN-SUFFIX,apple.com,DIRECT。直連仍仰賴本地網路、DNS 與目標服務正常運作,並不保證連線一定成功。它只描述匹配連線的處理方式,不代表整體 Global Routing 已切換至 Direct。

規則關鍵字與策略

REJECT

規則中表示拒絕匹配連線的策略關鍵字。條件過於廣泛時,網頁所需的圖片、登入介面或其他資源也可能遭到拒絕,造成部分內容無法顯示。新增規則時應從明確的網域條件開始;發生異常後,優先檢查匹配記錄與規則順序。

04 / CONFIGURATION

設定檔區段

區段名稱界定參數用途;相同網域出現在不同區段時,影響的環節可能完全不同。

設定檔區段

[General]

在設定檔中集中放置通用參數的區段,例如 dns-server = system。通用參數可能影響多種連線,不能當成只針對單一網域的規則。修改前請先備份目前的設定檔,並逐項測試,避免一次更動多個參數而難以還原。

設定檔區段

DNS

將網域名稱解析為 IP 位址的機制,與後續建立實際連線是不同環節。解析出位址不代表該位址可達;代理連線成功也不代表 DNS 設定必然正確。排查時應分別確認解析結果、DNS 查詢路徑與最終連線路徑。

設定檔區段

[Rule]

放置匹配規則與執行策略的區段,常見寫法為 DOMAIN-SUFFIX,example.com,PROXY。規則通常由上而下處理,因此較具體的例外規則應排在較廣泛的條件之前。修改後除了檢查語法,也要確認目前啟用的是包含這些規則的設定檔。

設定檔區段

[Host]

指定網域與位址對應關係的區段,例如 localhost = 127.0.0.1。這類對應作用於位址解析,不等於為該網域選擇 PROXY 或 DIRECT。目標服務位址可能變更,因此固定對應應有明確用途,並在不再需要時重新確認。

設定檔區段

[URL Rewrite]

依匹配運算式處理連線 URL 的區段,匹配模式與替換目標須一併確認。這與 [Rule] 中選擇連線策略的網域規則不同,也不能只因存在此區段就認為任何加密連線都能改寫。編寫時應檢查跳脫字元、匹配範圍與適用連線,避免造成重複重新導向。

05 / SUBSCRIPTION & ACCOUNT

訂閱與帳號

App 購買紀錄、伺服器連線憑證與訂閱集合是不同項目,回復與更新也應分別處理。

訂閱與帳號

Subscribe

用來匯入或更新使用者已有伺服器清單的訂閱類型或入口,連結應向自己的服務供應商取得。更新訂閱會重新取得清單內容,可能變更項目的位址、名稱或數量,並不等於更新 Shadowrocket App。訂閱連結可能包含驗證資訊,不應公開或任意轉傳。

訂閱與帳號

伺服器資訊

建立連線所需的位址、連接埠、協定與驗證參數等資訊,單一項目也常稱為節點。這與包含多個項目的訂閱集合不同;單筆資料輸入成功,不代表已建立訂閱更新關係。分享排查資訊時,請隱藏密碼、私鑰與其他驗證資料,只保留必要的錯誤說明。

訂閱與帳號

延遲

在特定測試條件下等待回應所需的時間,實際意義取決於測試方式與目標。延遲不等於頻寬;數值較低也不能單獨證明持續傳輸更快或更穩定。比較多個項目時,應盡量使用相同網路與測試方式,並參考實際使用結果判斷。

訂閱與帳號

Apple ID

用來核對 App Store 購買紀錄及重新取得 App 的帳號身分;購買時請確認目前登入的商店帳號。此帳號與使用者現有連線服務的帳號分屬不同系統,成功購買 App 不會自動填入伺服器資訊。系統需求、相容範圍及通用購買適用情形,均以 App Store 頁面標示為準。

訂閱與帳號

已購項目

在 App Store 查找原帳號購買紀錄及重新取得 App 的入口,實際入口名稱以目前系統顯示為準。更換裝置或重新安裝時,請先確認原購買帳號與商店狀態,不要直接重複購買。回復 App 與回復訂閱、伺服器項目及 Config 是不同操作;後者還須從自己的備份或原始資訊還原。