官方手冊 · 術語速查

Shadowrocket
介面、協定與規則術語

先辨認介面用語所在的位置,再判斷它控制的是連線模式、比對條件,還是伺服器參數。同一個詞出現在不同位置,意思可能不同;例如 Config 頁面與 Global Routing 中的 Config 選項。

適用裝置:iPhone / iPad / Mac / Windows / Android / Linux。各平台介面配置可能不同,實際入口請以目前 App 為準;本頁說明通用概念,不取代逐步操作指引。

依設定位置與用途查找

英文名稱維持原樣。分別說明全大寫的規則關鍵字與首字母大寫的介面選項,避免混淆路由模式與規則策略。

介面與選項

連線前先確認模式與對象

頁面入口決定操作位置;連線模式決定流量如何處理;測試工具只提供特定時間點的檢查結果。

Home
Home 是查看伺服器項目、訂閱群組與選擇連線對象的主要頁面。清單中出現伺服器,只代表資訊已匯入,不表示已建立連線。開始連線前,還須確認所選對象與 Global Routing 模式符合預期。
Global Routing
Global Routing 決定用戶端以何種模式處理流量,常見選項為設定 Config、代理 Proxy、直連 Direct。若要依規則分流,應選擇 Config 並確認目前使用的設定。排查規則未生效時,先檢查此處,避免在其他模式下反覆修改規則。
Config
Config 出現在 Global Routing 中時,表示依目前設定中的規則決定連線方式;作為頁面名稱時,則用於管理設定檔。兩者相關,但不是同一個操作入口。只下載設定檔並不足夠,還須確認已選用該檔案,並檢查末尾規則及策略參照。
Proxy / Direct
Proxy 是 Global Routing 中的代理模式,Direct 則是直連模式,可用來對照檢查連線路徑。這裡的介面用語不要與規則中的大寫 PROXY、DIRECT 混淆。暫時排查完畢後,若原本需要依規則分流,應切回 Config,再確認目標請求。
On Demand
On Demand 是按需連線設定,會依系統支援的網路條件觸發連線。它不負責更新訂閱,也無法修正錯誤的伺服器參數。手動關閉後仍再次連線時,可檢查此項與系統 VPN 設定;實際條件和入口依目前平台介面為準。
Add Server
Add Server 用於手動填入使用者已有的伺服器資訊。協定類型、伺服器位址、連接埠、驗證及傳輸參數必須彼此吻合,不能只填入位址就認定設定完成。修改前應保留原始參數,尤其要區分伺服器位址與 TLS 中的伺服器名稱。
Connectivity Test
Connectivity Test 用於檢查項目的連線狀況,結果會受測試方式、目標與目前網路狀態影響。測試成功不代表所有網站或 App 都能存取,也無法證明每條規則都已符合。應再透過實際請求與診斷紀錄,確認目標連線的處理方式。
延遲
延遲是一次測試請求取得回應所需的時間,通常以毫秒表示。數值較低不代表檔案下載速度較快,因為傳輸量還受頻寬、壅塞與遠端負載影響。比較結果時,應盡量使用相同網路、相同測試方式並選擇相近時間;若逾時,則須進一步判斷原因。
代理協定

分別核對協定、傳輸方式與安全層

協定名稱不等於完整的連線參數。以下僅說明技術用途;實際填寫時應以使用者既有伺服器的設定為準。

Shadowsocks
Shadowsocks 是一種代理協定,連線通常需要伺服器位址、連接埠、密碼與加密方法。加密方法必須與雙方設定一致,不應任意改成看似較新的選項。匯入後若無法連線,應先核對這些基本欄位,再檢查網路是否能連到遠端連接埠。
VMess
VMess 使用 UUID 等參數識別使用者,並須符合伺服器端設定。協定之外也可能涉及傳輸方式、路徑、Host 與 TLS,具體項目取決於原始連線資訊。即使 UUID 正確,傳輸設定不一致仍可能無法連線;應逐項比對,而非只檢查驗證欄位。
VLESS
VLESS 使用 UUID 等資訊進行驗證;協定本身不提供負載加密,須依實際部署了解安全層與傳輸方式。它不是只要把 VMess 項目的類型更改,就一定能使用的替代選項。新增時應完整核對伺服器提供的參數,不要只憑名稱猜測 TLS 或其他欄位。
Trojan
Trojan 通常搭配 TLS 與密碼驗證建立代理連線。伺服器位址、連接埠、密碼與伺服器名稱等設定都須符合遠端設定;憑證驗證失敗也可能中斷連線。排查時應先檢查參數與裝置時間,不應預設關閉憑證驗證。
Hysteria2
Hysteria2 是以 QUIC 為基礎的代理協定,對所在網路的 UDP 連線能力有所要求。驗證、TLS 與其他連線參數應依伺服器設定填寫,不能只憑協定名稱推斷。若同一項目換用不同網路後結果有異,應將 UDP 是否可連通及網路限制納入排查,而非反覆更換密碼。
WireGuard
WireGuard 使用金鑰組與通道參數建立連線,常見資訊包含對端位址、公鑰與通道位址。金鑰不是一般密碼,公鑰與私鑰的用途也不同。匯入與備份時應妥善保護私鑰,並檢查位址範圍及相關路由設定,避免只核對對端位址。
HTTP / SOCKS5
HTTP 與 SOCKS5 是兩種代理協定,連線交涉與驗證方式各有不同。協定名稱本身不代表用戶端與代理伺服器之間的連線已加密,應另外確認實際使用的安全設定。目標網站使用 HTTPS,與代理連線是否加密,是兩件需要分開理解的事。
TLS
TLS 是用於連線加密與身分驗證的安全層,不是 Global Routing 模式。連線位址、伺服器名稱與憑證上的身分資訊可能分別填寫,但都必須符合伺服器端設定。遇到交握錯誤時,應檢查裝置時間、名稱與憑證相關參數,再判斷是否為網路連線問題。
規則關鍵字

先比對條件,再套用策略

規則通常由上而下檢查。範圍較廣的規則若放得太前面,後續更具體的規則便可能無法生效。

規則
一條規則通常包含比對類型、比對值與處理策略,用來判斷請求應如何連線。規則一般依序檢查,由第一個符合的項目決定處理結果。排查時應一併查看規則內容、排列位置與目前路由模式,而非只搜尋檔案中是否出現目標網域。
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 用於網域完全比對,DOMAIN-SUFFIX 用於網域後綴比對,DOMAIN-KEYWORD 用於網域關鍵字比對。後綴規則可涵蓋對應網域及其子網域;關鍵字比對範圍則可能更廣。填入比對值時,只需輸入所需網域或關鍵字,不要把完整網頁路徑當成網域。
GEOIP
GEOIP 依目標 IP 在地理位置資料庫中的歸屬進行比對,不是判斷網頁語言或使用者目前所在地。資料庫與目標位址的變動都可能影響結果;透過網域存取時,也須考慮解析後取得的位址。若某個網域必須固定處理,可評估是否需要將精確網域規則放在更前面。
IP-CIDR / IP-CIDR6
IP-CIDR 比對 IPv4 位址範圍,IP-CIDR6 比對 IPv6 位址範圍;斜線後的前綴長度會決定位址範圍。前綴長度填錯可能使範圍過大或過小,不能當成一般連接埠號碼理解。排查雙堆疊連線時,須分別檢查 IPv4 與 IPv6 規則的涵蓋情況。
FINAL
FINAL 是前面的規則都未符合時採用的最終規則,通常放在規則清單末尾。它仍須指定處理策略,例如交由 PROXY 處理。設定是否能如預期處理未符合的流量,須一併檢查前面的規則;若太早放置 FINAL,便會影響後續比對。
PROXY / DIRECT / REJECT
這些全大寫關鍵字代表規則符合後的處理策略:PROXY 交由代理處理,DIRECT 直接連線,REJECT 拒絕連線。它們不代表比對條件,也不是協定名稱。若設定使用自訂策略群組,還須檢查群組中實際選取的對象,不能只憑規則末尾的名稱判斷最終連線路徑。
DNS
DNS 負責將網域名稱解析為 IP 位址,是建立許多連線前的步驟。解析失敗與代理交握失敗發生在不同階段;解析所經過的路徑,也不應直接視為後續應用程式連線的路徑。遇到部分網域異常時,應逐項檢查解析結果、快取與規則紀錄。
URL Rewrite
URL Rewrite 依比對條件改寫請求 URL,例如將符合條件的網址重新導向至另一個網址。它與選擇代理或直連的路由規則作用不同,也不代表可以任意修改加密請求內容。只需要依規則分流時,不必額外加入來源不明的改寫設定。
訂閱與設定

分清伺服器清單與本機設定

訂閱用於更新資訊,設定則決定流量如何處理。同步、還原購買項目與更新訂閱,處理的是不同資料。

訂閱 / Subscribe
訂閱是取得並更新一組伺服器資訊的入口,網址應由使用者自己的服務供應商提供。訂閱常含有用於識別帳號的敏感參數,不應公開截圖或貼到討論區。新增成功後,應確認清單不是空的,並核對項目是否符合預期;訂閱本身不等於完整的規則設定。
伺服器 / SERVER
伺服器項目是一組連線參數,通常包含位址、連接埠、協定、驗證及可選的傳輸設定。清單中顯示的名稱只是方便辨識的標籤,修改名稱不會改變遠端位址或連線能力。手動新增或透過訂閱匯入都能建立項目,但後續維護與更新方式可能不同。
設定檔
設定檔可儲存規則、DNS、策略及其他相關設定,與主要用來提供伺服器清單的訂閱用途不同。匯入檔案後,應確認是否已選用,以及其中的策略名稱是否對應實際對象。替換設定前,建議保留目前可用的副本,以便發生異常時還原原有設定。
更新訂閱
更新訂閱會重新讀取同一個網址,將服務供應商提供的最新資訊同步至本機。手動修改訂閱項目可能在下次更新時被覆蓋,因此修改前應確認自己維護的是獨立項目還是訂閱內容。更新失敗時,先檢查網路、網址是否完整及伺服器端狀態,不要連續重複匯入,造成多個群組。
Scan QR Code
Scan QR Code 用於讀取 QR Code 中的連線資訊;內容可能代表單一伺服器,也可能是其他支援的資料。成功辨識只代表讀取到內容,不等於參數正確或伺服器可用。匯入前後都應核對類型與欄位,並將含有驗證資訊的 QR Code 視為敏感資料。
iCloud 同步
iCloud 同步可在 Apple 裝置間同步支援的資料,通常須使用相同 Apple 帳號並開啟相關權限。它不等於更新訂閱,也不能取代 App Store 的已購項目紀錄。更換裝置前,應分別確認購買帳號、可同步內容與本機備份,不要假設所有連線狀態都會自動還原。
商店與帳號

分開理解 App 取得方式與連線服務

本組商店術語主要適用於 iPhone / iPad。其他平台的 Shadowrocket 取得方式統一列於本站下載頁。

App Store 商店與帳號地區
App Store 商店頁面會受購買所用 Apple 帳號的地區影響,並決定 App 是否顯示、顯示貨幣與可用的購買方式。這與裝置語言、目前所在地或代理出口不同;切換網路也不等於更改商店地區。系統需求請以 App Store 頁面標示為準;搜尋不到 App 時,應先核對商店地區與產品資訊。
正版確認
iPhone / iPad 使用者可在 App Store 核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。名稱相近不代表是同一項產品,應一併核對這三項資訊。Mac、Windows、Android 與 Linux 版則從本站下載頁取得 /dl/shadowrocket/ 中的安裝檔,並依該頁說明允許系統執行。
一次性買斷
iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費;各商店實際金額以商店頁面為準。用戶端一次性買斷 ≠ 連線服務方案,購買 App 不會自動取得可用伺服器或訂閱。iPhone 與 iPad 還原購買項目須使用原購買帳號,連線資訊則須另外匯入或還原。
已購項目
已購項目是 App Store 中與購買帳號關聯的 App 紀錄,可用於更換裝置或重新下載時尋找已購的 Shadowrocket。此紀錄只保存取得 App 的資訊,不包含伺服器清單、訂閱網址或規則設定。若找不到紀錄,應先確認是否使用原購買帳號,再依商店介面檢查購買紀錄與相關顯示設定。

需要確認商店地區、購買紀錄或換機還原步驟,可繼續查閱 App Store 指南。既有項目無法連線時,先依 常見問題區分匯入、解析、交握與規則比對階段。

返回分類目錄 ↑