官方手冊 Defined Terms

Shadowrocket 術語速查

依介面名稱查詢用途,依規則關鍵字了解比對範圍。以下術語保留英文原文,中文說明用來區分「選擇處理方式」、「填寫連線參數」和「制定比對規則」這三個層次。

閱讀前提為使用者已有自己的訂閱或伺服器資訊。參數請向你的服務商取得;本站不提供、不販售、不推薦節點或訂閱。

先區分用戶端與線路服務

iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。一次買斷用戶端 ≠ 線路方案;購買用戶端不會產生訂閱或伺服器憑證。

各平台的取得方式請參閱全平台下載;iPhone / iPad 的系統需求以 App Store 頁面標示為準。桌面版與 Android 安裝檔請從本站 /dl/ 取得;首次開啟時的系統允許步驟請參閱安裝說明。

介面與開關

Global Routing

整體流量處理方式

Global Routing 是選擇整體處理方式的入口,包含設定、代理、直連三種模式,對應介面上的 Config、Proxy、Direct。它會先決定是否依設定檔分流,不能與個別規則末尾的 PROXY、DIRECT 策略混為一談。排查問題時,先記錄目前模式,再檢查規則,避免在 Proxy 模式下反覆修改原本不會依預期參與分流的規則。

Config

設定模式

在 Global Routing 中選擇 Config,表示依據目前設定檔中的規則處理請求。規則通常由上而下比對,最先符合的項目會決定相應策略,因此較具體的比對條件應排在較寬泛的條件之前。選擇 Config 不代表所有請求都會經過代理;實際路徑取決於規則內容與目前啟用的設定檔。

Proxy

代理模式

在 Global Routing 中選擇 Proxy,讓由用戶端處理的流量採用代理路徑,可用來與 Config 模式比較。如果 Proxy 可用,但在 Config 下某項請求失敗,應優先檢查該請求符合的規則與策略。這個模式無法補上錯誤的密碼、連接埠或 TLS 參數,也不保證每個 App 的所有通訊都會由用戶端接管。

Direct

直連模式

在 Global Routing 中選擇 Direct,讓由用戶端處理的流量透過本地網路直接連線,而不交由已選取的代理伺服器。可用來確認本地網路本身是否能連上測試目標。Direct 是模式選擇,不代表關閉連線開關,也不代表刪除既有訂閱或設定檔。

On Demand

依條件要求連線

On Demand 會依據設定的網路等觸發條件要求建立連線,實際條件以目前介面提供的設定為準。它與手動連線開關相關,但不會檢查訂閱是否有效,也不會修復伺服器驗證失敗。排查非預期的自動連線時,應一併確認 On Demand 條件與系統中的 VPN 設定。

Add Server

手動新增伺服器

Add Server 是逐項填寫伺服器資訊的入口,首先要選對協定類型,再輸入位址、連接埠與驗證欄位。不同協定所需欄位各異,密碼、UUID、金鑰不能互相替代。儲存前請依服務商提供的資訊逐項確認,完整操作請參閱Add Server 手動填寫說明。

Connectivity Test

連線可用性測試

Connectivity Test 用來檢查指定測試條件下的連線狀況;判讀結果前,請先確認測試目標與方式。測試有回應不代表所有網站都能存取,測試失敗也不一定表示伺服器完全無法使用。應搭配實際請求、目前的 Global Routing 與記錄一起分析,不要只看單次測試結果。

協定

協定決定雙方如何建立連線、驗證與傳輸。名稱相同只是基本條件,傳輸方式、安全參數與驗證資訊仍須與伺服器端一致。

Shadowsocks

密碼與加密方式

Shadowsocks 連線通常需要伺服器位址、連接埠、密碼與加密方式,而且加密方式必須與伺服器端一致。只有密碼不足以建立連線,也不能靠更換加密方式修復未知設定。如果服務商另有提供傳輸參數,請依原始資料填寫,不要自行加入未要求的選項。

VMess

驗證與傳輸參數

VMess 使用 UUID 等資訊進行驗證,連線也可能涉及傳輸類型、路徑、Host 與 TLS 設定。UUID 正確不代表其他欄位可以留白,尤其要區分伺服器位址與傳輸層使用的主機名稱。裝置時間不準也可能影響驗證;排查時應確認系統時間正確。

VLESS

使用者識別與安全設定

VLESS 是一種使用 UUID 識別使用者的代理協定,實際連線所需的安全與傳輸參數取決於伺服器端設定。不能直接將 VMess 的整組設定視為通用的 VLESS 填寫方式。匯入後仍應確認協定類型、位址、連接埠與其他欄位;不清楚的欄位應向服務商提供的原始資訊確認。

Trojan

密碼驗證與 TLS

Trojan 通常搭配 TLS 使用,並以密碼進行驗證;常見確認項目包括伺服器位址、連接埠、密碼與 SNI。位址能解析不代表 TLS 交握一定成功,憑證上的名稱也必須相符。遇到憑證錯誤時,應先確認名稱、系統時間與伺服器端憑證,而不是將略過憑證驗證當作一般設定。

Hysteria2

以 QUIC 為基礎的傳輸

Hysteria2 以 QUIC 為基礎,連線需要本地網路與伺服器端允許相應的 UDP 通訊。除了位址、連接埠與驗證資訊,部分設定也會提供 TLS 或混淆等參數,請依伺服器端要求填寫。協定名稱不代表固定速度,實際表現也會受到網路封包遺失、頻寬與伺服器負載影響。

WireGuard

金鑰配對與通道位址

WireGuard 使用金鑰配對建立通道,PrivateKey、PublicKey、Endpoint 與位址設定各有不同用途。PrivateKey 是本機的私密驗證資料,不應填入伺服器公鑰欄位或公開顯示。Endpoint 表示對端的連線位址與連接埠;DNS、路由範圍與 MTU 則會影響通道建立後的實際通訊。

HTTP / SOCKS5

代理協定類型

HTTP 與 SOCKS5 是兩種不同的代理協定,應依伺服器實際提供的類型選擇,不能因位址和連接埠相同就互換。是否需要使用者名稱與密碼也由伺服器端決定。協定名稱本身不代表用戶端與代理伺服器之間已加密;網站的 HTTPS 與代理連線的安全層也應分開理解。

規則關鍵字

一條規則通常包含比對類型、比對內容與處理策略。以下範例僅用於說明語法;範例網域 example.com 並非可用伺服器。

DOMAIN

完整網域比對

DOMAIN 會比對完整網域,例如 DOMAIN,example.com,DIRECT 只適用於該網域本身,不會自動涵蓋 www.example.com 等子網域。若要涵蓋子網域,應考慮使用 DOMAIN-SUFFIX。此處填寫的是網域,不要加上 URL 路徑或查詢參數。

DOMAIN-SUFFIX

網域及子網域比對

DOMAIN-SUFFIX 會比對指定網域及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 與 www.example.com。它依網域層級比對,不是搜尋任意字串。若某個子網域需要採用不同處理方式,應將更具體的規則排在前面。

DOMAIN-KEYWORD

網域關鍵字比對

DOMAIN-KEYWORD 會檢查網域是否包含指定字串,比對範圍通常比完整網域與網域後綴規則更廣。字串太短容易涵蓋不相關的網域,不宜只憑網站簡稱隨意填寫。發生非預期分流時,應檢查範圍較廣的關鍵字規則是否排在精確規則之前。

GEOIP

目標 IP 的地理標記

GEOIP 會依 IP 地理資料庫中的標記進行比對,例如 GEOIP,CN,DIRECT 會將符合的位址交由 DIRECT 處理。它判斷的是目標 IP 在資料庫中的分類,不是網頁語言、公司註冊地或內容歸屬。資料庫更新與網站使用的內容傳遞網路都可能改變比對結果;必要時可用精確網域規則補充。

IP-CIDR / IP-CIDR6

IPv4 與 IPv6 位址範圍

IP-CIDR 用於 IPv4 位址範圍,IP-CIDR6 用於 IPv6 位址範圍;位址後的前綴長度決定涵蓋範圍。例如 IP-CIDR,192.0.2.0/24,DIRECT 是文件中的示範網段規則,不是單一伺服器位址。填寫前應確認目標使用的位址家族,避免只處理 IPv4 而漏掉 IPv6。

FINAL

未符合規則時的預設策略

FINAL 會處理前面規則都未符合的請求,例如 FINAL,PROXY 會將其餘請求交由代理處理。它通常放在規則清單末尾;若放得太前面,後續規則就沒有比對機會。預設策略要選 PROXY 或 DIRECT,取決於設定目的,沒有適用於所有網路的固定答案。

PROXY / DIRECT / REJECT

規則符合後的處理策略

PROXY 表示交由代理處理,DIRECT 表示直接連線,REJECT 表示拒絕請求;這些字詞位於規則的處理策略欄位。這些全大寫策略與 Global Routing 中的 Proxy、Direct 模式屬於不同層級。REJECT 只能依規則可識別的條件阻擋請求,無法只憑同一個網域區分其中每一段頁面內容。

將關鍵字放入完整規則中

在 Config 模式下,先檢查精確比對規則,再檢查地區規則,最後檢查 FINAL。以下片段用來示範閱讀順序,不應直接取代現有設定。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

訂閱與設定

Subscribe

匯入及更新伺服器清單

Subscribe 用來透過訂閱連結匯入及更新一組伺服器資料;連結請向你的服務商取得。訂閱 URL 可能包含可識別帳號的憑證,不應張貼在公開頁面或未遮蔽的截圖中。更新訂閱可能新增、刪除或更改資料名稱;更新成功只代表已取得內容,不代表其中每筆資料都能連線。

SERVER

單筆伺服器資料

SERVER 對應一筆伺服器資訊,通常包含位址、連接埠、協定與驗證參數,中文說明中也常稱為節點。顯示名稱只是方便辨識的標籤;名稱相同不代表參數相同,名稱不同也不一定表示位址不同。整理資料時應區分訂閱產生的項目與手動新增的項目,避免更新後誤以為手動修改會永久保留。

Config / [Rule]

設定檔與規則區段

設定檔可包含規則、DNS 等設定,[Rule] 是規則區段標記;它與只提供伺服器清單的訂閱並非同一概念。擁有伺服器資料不代表已具備符合目前需求的分流規則;匯入設定檔也不一定會附帶伺服器憑證。切換設定檔前,先保留目前可用的副本,並確認 Global Routing 已設為需要的模式。

DNS

網域解析

DNS 會將網域名稱解析為 IP 位址,是連線流程中的一環,不是代理驗證本身。網域解析成功但仍無法開啟時,還需檢查路由、TLS、連接埠與伺服器狀態。調整 DNS 前應記錄目前設定,並區分「伺服器位址解析失敗」與「目標網站解析失敗」;兩者發生在不同階段。

Latency

測試回應時間

延遲是在特定測試方式下等待回應所需的時間,數值會受測試目標、網路狀況與協定交握影響。延遲較低不一定代表下載速度較快,逾時也可能是測試目標無法連線所致。比較測試時應使用相同方式、相同目標及相近的網路條件,再搭配實際連線狀況判斷。

App Store · 已購項目

重新下載已購買的 App

已購項目可在 App Store 查找同一 Apple ID 已購買的 App;iPhone 與 iPad 使用同一個購買帳號即可重新下載。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac、Windows、Android、Linux 版免費,後者不透過已購項目取得。找不到購買紀錄時,請先確認購買帳號與商店地區,操作方式請參閱已購項目還原說明。

若要將這些概念整理成操作步驟,請接著閱讀使用說明;訂閱更新、資料整理與備份請參閱節點管理手冊。