官方手冊 · 名詞解釋

Shadowrocket
介面、協定與規則術語

依術語所在位置查閱:介面用語說明入口與操作,協定名稱說明連線方式,規則關鍵字則說明比對條件。同一個詞出現在不同位置時,含義可能不同;例如 Config 既是設定相關頁面的名稱,也是 Global Routing 的一種模式。

本表以使用者已有自己的訂閱或伺服器資訊為前提。先了解術語,再依實際參數操作;協定名稱、欄位名稱與規則關鍵字保留英文原文,方便逐項對照 Shadowrocket 內的顯示內容。

介面與開關

入口、模式與連線檢查

先確認目前查看的是哪個頁面,再判斷某項設定改變的是連線對象、路由方式,還是用戶端行為。

Home
查看現有伺服器項目、選擇連線對象及操作連線開關的主要頁面。新增項目後,應先確認選取的對象,再嘗試連線;項目存在只表示資訊已儲存,不代表伺服器目前可用。首次建立連線時若出現系統 VPN 設定授權提示,也應配合目前操作確認。
Global Routing
決定由 Shadowrocket 處理的流量採用哪種整體路由方式,常見選項為 Config、Proxy 與 Direct。這與選擇伺服器是不同層次:選取伺服器,不會自動決定所有請求的處理方式。調整模式後,應以相同目標重新驗證,避免同時修改多個變數。
Config / Proxy / Direct
Config(設定)依目前設定中的規則處理;Proxy(代理)讓由用戶端處理的流量採用代理策略;Direct(直連)則使用直接連線。若要保留分流規則,請使用 Config,並確認目前設定已生效。Proxy 與 Direct 可用於對照排查,但單次測試成功不代表在所有網路條件下都會得到相同結果。
On Demand
依已設定的條件觸發連線,適合需要依網路條件調整連線行為的情況。這不是伺服器自動修復功能,也不能取代有效設定和系統授權。啟用前先確認手動連線正常,再逐一檢查觸發條件;排查反覆連線問題時,也應將這項設定納入確認範圍。
Add Server
使用現有伺服器資訊新增項目的入口,通常需選擇協定並填寫位址、連接埠及驗證參數。不同協定顯示的欄位不同,不能將一組欄位直接套用到另一種協定。儲存後重新開啟項目確認,尤其留意傳輸方式、TLS 和伺服器名稱等容易遺漏的部分。
Connectivity Test
用於輔助檢查連線可達性與回應狀況,實際測試選項以目前 App 內顯示為準。測試結果會受目標、測試方式和當下網路影響,不能直接換算為下載速度。若測試可達但實際請求失敗,應繼續確認 DNS、Global Routing 和比對到的規則,而不是只重複測試。
Settings
查看及調整用戶端相關設定的頁面,實際選項以目前 App 內顯示為準。修改前先記下原值,遇到問題時一次只改一項,並以相同請求驗證差異。設定項名稱相似不代表作用相同,連線觸發、解析和資料管理等選項應分別理解。
Data
用於查看用戶端的上傳、下載及相關流量統計,讀數應搭配頁面顯示的統計範圍和累計時間解讀。累計流量不是目前速度,也不等同於伺服器端記錄的用量。清除前先記下需要保留的讀數;實際統計視角與分組方式請參閱Data 功能說明。
查看 Global Routing 操作步驟 →
協定

協定名稱與參數範圍

協定決定用戶端與伺服器如何通訊。新增時依現有資訊填寫,不要只憑名稱推測速度,也不要依連接埠猜測協定。

Shadowsocks
一種代理協定,常見設定項目包括伺服器位址、連接埠、加密方式和密碼。加密方式必須與伺服器端一致,密碼也要保留原有大小寫和字元。匯入後若無法建立連線,先確認這些基本欄位,再檢查是否還需要其他傳輸參數。
VMess
使用 UUID 等資訊進行身分驗證的代理協定,傳輸層設定也是設定的一部分。位址、連接埠和 UUID 正確,不代表連線一定成功,仍需確認傳輸方式、路徑及 TLS 等適用欄位。UUID 是驗證資訊,應保留原值;公開排查紀錄時不要展示真實值。
VLESS
使用 UUID 等資訊識別使用者的代理協定,不能將名稱差異簡單解讀為速度快慢。連線安全性需依實際傳輸層和驗證設定判斷,不能只看協定名稱。匯入現有項目後,還應檢查傳輸方式和相關安全參數,不要直接套用 VMess 的欄位組合。
Trojan
通常搭配 TLS 使用的代理協定,設定時需確認伺服器位址、連接埠、密碼與伺服器名稱。連線位址和用於 TLS 驗證的名稱可能不同,應以現有設定說明為準。憑證驗證失敗時,優先檢查名稱、憑證及裝置時間,不要將略過驗證當成一般解決方式。
Hysteria2
以 QUIC 為基礎的代理協定,仰賴相應的 UDP 通訊條件。在高延遲或封包遺失的環境中,實際表現還取決於頻寬、壅塞狀況和伺服器設定,不能只憑協定名稱保證。新增時依現有資訊確認驗證、TLS 及適用的頻寬參數;若 UDP 無法連通,應先找出網路條件問題。
WireGuard
使用公私鑰建立加密通道的協定,設定通常包含金鑰、端點、介面位址與路由範圍。私鑰屬於敏感資訊,不可放入公開截圖或分享的排查紀錄。只有端點位址正確仍不足以建立完整通訊,還需一併確認對端公鑰和允許的位址範圍。
HTTP / SOCKS5
兩種不同的代理協定名稱,握手與驗證方式各不相同。填寫時依使用者現有伺服器資訊指定的類型選擇,不能因連接埠相同就互換。是否使用加密傳輸、是否支援特定請求,也需依伺服器能力和用戶端相應設定確認。
規則關鍵字

比對條件與處理策略

規則通常由比對類型、比對內容和處理策略組成。閱讀時先看比對對象,再看比對成功後如何處理。

Rules
設定中用來判斷連線處理方式的規則集合,通常依序比對並採用第一條符合條件的規則。具體規則放前面,範圍較廣的條件放後面,有助於減少意外覆蓋。只有在對應的設定處理路徑中,規則才會參與判斷,因此排查時要一併檢查 Global Routing 與目前設定。
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 比對完整網域,DOMAIN-SUFFIX 比對網域後綴及其子網域,DOMAIN-KEYWORD 則依網域中的關鍵字比對。後兩者的涵蓋範圍可能較廣,不能只憑單一測試請求判斷影響範圍。網域規則填寫網域本身,不要將 URL 中的路徑、查詢參數或協定前綴混入比對值。
GEOIP
依據 IP 地理資料庫判斷位址所屬地區,再執行對應策略。它判斷的是位址資料,不是網站使用的語言、網域後綴或訪客所在位置。資料庫內容及網域解析結果都可能影響比對;排查時需確認實際連線位址,避免從頁面語言推斷規則結果。
IP-CIDR / IP-CIDR6
分別用於比對 IPv4 與 IPv6 位址範圍,斜線後的前綴長度代表位址範圍。相較於單一位址,範圍較大的網段可能影響更多目標,填寫前應確認預期範圍。同一網域可能解析出多個位址,若只有部分位址符合規則,請求結果也可能不同。
FINAL
前面的規則都未比對成功時採用的最終規則,通常位於規則清單末尾。它決定剩餘流量的去向,並不是覆蓋所有已比對規則的總開關。檢查設定時應確認 FINAL 的策略存在且符合預期,因為未符合其他條件的請求會套用這項規則。
PROXY / DIRECT / REJECT
規則中的處理策略:PROXY 指向代理策略,DIRECT 表示直接連線,REJECT 表示拒絕處理。範例中的 PROXY 必須對應目前設定中可用的策略或策略群組,不應假設任何設定都能直接使用。這些策略與 Global Routing 中的 Proxy、Direct 屬於不同層級。
USER-AGENT
依據可見 HTTP 請求中的 User-Agent 資訊比對,不是透過裝置上的 App 名稱識別所有流量。加密請求中的相關資訊並非必然可見,因此適用範圍取決於實際請求與設定條件。判斷是否符合規則時,應查看可用的請求記錄,不要將它當成通用的依 App 分流規則。
查看 Rules 功能說明 →
訂閱與設定

項目、解析與設定資料

伺服器項目提供連線參數,設定檔則規定處理方式。匯入成功後,仍需分別確認連線對象與設定檔選擇。

Subscribe
使用使用者現有的訂閱 URL 匯入及更新伺服器項目,更新結果取決於該網址傳回的內容。訂閱通常包含存取憑證,分享截圖或記錄時應遮住完整 URL。項目更新不代表整份規則設定也同步更新,匯入後需分別檢查伺服器清單與設定檔選擇。
SERVER
伺服器相關欄位或區域的介面標示,填寫時使用使用者現有的位址資訊。伺服器項目也可能包含連接埠、協定、驗證與傳輸參數,通常只有位址不足以建立連線。項目顯示名稱可方便辨識,但變更名稱不會改變實際連線目標或驗證資訊。
Config
在頁面名稱中指設定檔相關的管理入口;在 Global Routing 中則指依目前設定檔規則處理的模式。設定檔可包含規則、策略及其他適用設定,伺服器訂閱不會自動等同於設定檔。匯入後應確認實際選用的檔案,避免將「已儲存」誤認為「已生效」。
DNS
將網域名稱解析為 IP 位址的機制,是網域請求建立連線前的重要環節。解析失敗可能導致網站無法開啟,即使伺服器本身連線正常也會發生。修改 DNS 設定時,需同時考量解析請求的處理路徑和規則條件,並在相同網路下重新驗證目標網域。
URL Rewrite
依據條件改寫可處理的請求 URL,常見情況是變更請求目標或請求中的部分內容。這與 Rules 不同:規則主要決定流量交由哪個策略處理,改寫則會影響請求本身。只有符合相應處理條件的請求才會受到影響,應先確認比對範圍,再使用現有設定。
延遲
在測試條件下的回應時間,可能包含建立連線或指定目標回應所需的時間,實際含義取決於測試方式。延遲低不代表持續傳輸速度快,也不表示所有目標都可連線。比較時應保持測試方式、目標和網路一致,多次觀察比單次讀數更具參考價值。
iCloud 同步
指透過 App 提供的 iCloud 相關功能同步其支援的資料,實際範圍以目前 App 設定為準。這與 App Store 購買記錄是兩套機制,復原 App 不代表設定會自動出現。換裝置前應確認同步開關、帳號與實際同步結果,並妥善保管含有驗證資訊的資料。
App Store 與帳號

正版確認、店面與購買記錄

Shadowrocket 是 Apple 平台上的閉源商業 App,唯一取得管道為 App Store。主要使用裝置為 iPhone 與 iPad;系統需求及購買適用性以 App Store 頁面標示為準。

App Store 正版確認
在產品頁確認開發者為 Shadow Launch Technology Limited、使用官方圖示,且 App ID 為 932747118。官方圖示為白底、藍紫描邊的火箭,App ID 可從產品頁 URL 辨認。不要只憑搜尋名稱判斷,三項資訊都應與官方產品相符,再確認價格與相容性。
商店地區
指購買帳號所對應的 App Store 店面,可能影響 App 是否顯示、顯示貨幣與付款條件。裝置語言或目前所在地都無法單獨證明目前使用的店面,請查看帳號的國家或地區設定。準備變更地區前,先了解帳號餘額、現有訂閱及付款方式等條件,詳見商店地區指南。
已購項目
用於在 App Store 查找原購買記錄,並在符合條件的裝置上重新取得 App。更換裝置或重新安裝時,先確認使用的是原購買帳號,再查找 Shadowrocket。復原已購記錄可重新取得 App 使用資格,但不會自動復原伺服器資訊、訂閱 URL 或設定檔。
一次買斷
指購買用戶端使用資格的付費方式,美國商店價格約為 2.99 美元,實際金額以商店頁面為準。用戶端一次買斷 ≠ 線路方案;購買後仍需匯入使用者現有的訂閱或伺服器資訊。後續 App 更新透過 App Store 取得,購買適用裝置與家人共享條件以產品頁標示為準。
查看 App Store 正版確認與購買說明 →