官方手冊 / 術語索引

Shadowrocket 術語表

依介面原文與設定關鍵字查找。先分清三件事:連線是否已建立、要求符合哪條規則,以及命中後採用什麼策略。

01 / Interface

介面與開關

開關控制連線,Global Routing 決定如何處理要求。兩者應分開確認。

Home
查看連線開關、伺服器列表與 Global Routing 目前選項的介面。選取伺服器不代表連線已開啟;開啟連線也不代表每個要求都會經過代理。
Global Routing
提供設定、代理和直連三種模式,介面依序顯示為 Config、Proxy 和 Direct。Config 依目前設定判定策略,Proxy 使用代理路徑,Direct 使用直連路徑。檢查規則命中情形時,請先確認選取的是 Config。
On Demand
依設定條件觸發連線的功能,例如根據使用中的網路決定是否建立連線。此功能管理連線的觸發時機;連線建立後如何處理要求,仍由 Global Routing 和目前設定決定。
Add Server
用來輸入自己已有的伺服器資料。先選擇與資料相符的通訊協定,再填寫位址、連接埠及該協定要求的欄位;儲存成功僅表示資料已新增。
Connectivity Test
用來檢查伺服器在目前網路與測試條件下能否收到回應。測試成功不代表目標 App 也能正常使用;若測試失敗,請先確認測試對象、伺服器參數及目前網路。
延遲
從發出測試到收到回應所需的時間,通常以毫秒顯示。延遲不等於傳輸速率;比較結果時,盡量使用相同網路、相同測試目標與相同測量方式。

02 / Protocols

通訊協定

通訊協定決定客戶端如何與既有伺服器互動。位址或連接埠相同,不代表通訊協定與參數可以互換。

Shadowsocks
採用加密傳輸的代理通訊協定,伺服器資料通常包含位址、連接埠、密碼與加密方式。兩端的加密方式或密碼不一致時,即使位址可連通,也無法正常交換資料。
VMess
使用使用者識別等參數建立代理連線的通訊協定。輸入既有資料時,也要確認傳輸方式與適用的安全設定,不能只憑位址和連接埠判斷資料是否完整。
VLESS
使用使用者識別的代理通訊協定。協定名稱本身不代表傳輸是否加密;TLS 等安全設定應以對應的伺服器資料為準,不要直接沿用 VMess 項目的欄位。
Trojan
通常在 TLS 連線上使用密碼驗證身分的代理通訊協定。伺服器位址與用於憑證驗證的名稱可能不同,輸入時應分別依既有資料確認,不要根據其中一個欄位猜測另一個。
Hysteria2
以 QUIC 為基礎的代理通訊協定,其傳輸仰賴 UDP。確認伺服器資料無誤後,若在特定網路上無法連線,可檢查該網路是否允許相關 UDP 流量。
WireGuard
以金鑰識別對端的通道通訊協定。設定中的對端位址與允許的位址範圍用途不同:前者指定連線目標,後者會影響哪些目標位址使用通道。請勿在公開筆記或問題截圖中顯示私鑰。

03 / Matching

規則關鍵字與策略

關鍵字決定使用哪種條件比對,策略則決定符合後如何處理。需要查看完整語法時,請參閱設定欄位。

規則
在 [Rule] 中描述比對條件與處理策略的項目。規則通常由上而下檢查,符合後即採用對應策略;若兩條規則都符合,不要假設較具體的規則會自動優先。
DOMAIN
比對完整主機名稱。例如 DOMAIN,example.com,DIRECT 可比對 example.com,但不會因此比對 www.example.com。比對目標不包含 URL 的路徑或查詢參數。
DOMAIN-SUFFIX
依網域後綴比對,涵蓋該網域及其子網域。例如條件 example.com 同時涵蓋 example.com 和 www.example.com,但不涵蓋 notexample.com。
GEOIP
依要求相關 IP 位址在地理資料庫中的歸屬進行比對。這不是裝置定位;同一網域可能解析到不同位址,查詢結果變動時,符合的規則也可能跟著改變。
IP-CIDR / IP-CIDR6
分別依 IPv4 或 IPv6 的網路前綴比對,例如 192.0.2.0/24 和 2001:db8::/32。斜線後的數字代表前綴位元數,不是連接埠;兩種位址家族都需要分別檢查。
FINAL
為未符合前面所有項目的要求指定預設策略,通常放在規則列表末尾。例如 FINAL,DIRECT 表示未命中時直連,不會改寫前面已命中的策略。
PROXY / DIRECT / REJECT
規則中的三種策略:PROXY 透過代理轉送,DIRECT 直接連線,REJECT 拒絕要求。這些大寫關鍵字只描述命中該規則後的動作,不代表變更 Global Routing 中的 Proxy 或 Direct 選項。

04 / Configuration

訂閱與設定檔

伺服器資料回答「連線到哪裡」,設定檔回答「如何處理要求」。本站僅說明如何使用既有資料,不提供、銷售或推薦節點與訂閱。

伺服器
客戶端連線的遠端服務。伺服器項目會儲存通訊協定、位址、連接埠等連線參數;列表中的顯示名稱僅供辨識,不能取代實際位址,也不代表項目已可使用。
訂閱
透過既有訂閱網址取得或更新伺服器項目的方式。網址由你的服務商提供,可能包含存取憑證,不宜公開貼上。更新後若原先使用的項目已移除,請重新從目前列表中選取。
Config
作為分頁時用來管理設定檔;作為 Global Routing 選項時,表示依目前設定處理要求。編輯前先確認目前啟用的檔案,避免將修改寫入未啟用的副本。
DNS
將網域名稱查詢為位址等記錄的機制。網域解析失敗、解析後符合不同的 IP 規則,以及目標位址連線失敗,是三個不同的排查階段。DNS 欄位可先參閱General 設定說明。
URL Rewrite
設定檔中依 URL 條件處理符合要求的區段,常見用途是重新導向。這與 [Rule] 的路徑選擇不同:應分別確認要求目標是否變更,以及要求是否改走代理。
iCloud 同步
符合帳號、系統設定及 App 支援條件時,可在裝置間同步受支援的 App 資料。更換裝置前,請確認要保留的項目是否已同步;此功能與 App Store 的已購記錄是兩回事。

若要將既有資料輸入客戶端,可參閱快速入門的步驟;資料已輸入但無法連線時,可查看無法連線的排查方式。

05 / Store & Account

商店與帳號

App Store 購買記錄、裝置上的 App 資料與伺服器服務,是三件不同的事。

App Store 店面
帳號所屬的商店地區,會影響可查看的 App、標價貨幣與購買條件。網頁開啟的是美國店面產品頁,不代表目前裝置登入的購買帳號也屬於該店面。
App ID
用來區分 App Store 產品項目的識別碼。確認 Shadowrocket 產品頁時,請檢查 App ID 932747118、開發者 Shadow Launch Technology Limited 與官方圖示,不要只看名稱。
已購項目
查找 App Store 購買記錄的入口。更換裝置或重新安裝時,先確認使用原購買帳號,再依已購項目還原說明找回 App。重新下載 App 不會同時還原伺服器項目或設定檔。