官方手冊 / 術語索引
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 不會同時還原伺服器項目或設定檔。