官方手冊 · 術語參考

Shadowrocket
術語表

依用途查找術語,保留英文原文。

先分辨介面選項、通訊協定參數與規則策略,再對照目前頁面操作。每個術語都有專屬錨點,可直接儲存或分享特定項目。

INTERFACE

介面與開關

先確認目前所在頁面。頁面名稱、整體路由方式與連線開關各有不同用途,不能只根據其中一項狀態推斷所有連線結果。

介面與開關

Home

用來查看現有伺服器項目、選擇連線對象及操作連線開關的主要頁面。選取項目只代表指定連線對象,不等於已建立連線;還須查看開關狀態與實際連線結果。若清單為空,請先使用自己的訂閱或伺服器資訊新增項目。

介面與開關

Global Routing

決定整體請求處理方式的選項:設定、代理、直連分別對應 Config、Proxy、Direct。若要依規則區分請求,請選擇 Config 並確認目前啟用的設定。切換此選項不會替你修改伺服器位址、驗證資訊或設定檔內容。

介面與開關

Config

在設定檔管理位置,Config 指的是檢視、選擇與管理設定檔;在 Global Routing 中,則表示依目前設定處理請求。同一個詞須依所在頁面判斷,不能把「開啟 Config 頁面」當成「已啟用規則分流」。修改後須確認已選用正確檔案,再測試目標請求。

介面與開關

Proxy / Direct

這是 Global Routing 中的兩種整體選擇,分別代表代理與直連。Proxy 透過所選代理處理請求,Direct 則直接連線;兩者都不是針對單一網域編寫的規則。若預期依網域分別處理,卻一直使用其中一種整體模式,應先檢查 Global Routing,而非立刻重寫規則。

介面與開關

On Demand

依已設定的條件觸發系統 VPN 連線,實際行為取決於應用程式中的相關設定與系統狀態。此功能不會修正伺服器參數,也不等同於定時更新訂閱。若要排查連線為何再次啟動,應一併檢查 On Demand 與系統 VPN 狀態,而非只確認剛才是否手動關閉開關。

介面與開關

Data

用來查看應用程式記錄的流量等統計資訊,可協助了解一段使用期間的資料變化。應用程式統計、電信業者帳單與服務供應商計量可能採用不同範圍與週期,數字不必完全一致。比較前先確認統計起點與對象,不能只憑單一累計值判斷是哪條規則生效。

介面與開關

Settings

應用程式設定入口,可用來檢查連線行為與其他選項,實際項目以應用程式目前顯示為準。排查問題時,先記下相關選項的原始值,再一次只修改一個變數。應用程式內的 Settings 與系統「設定」是不同入口;教學提及系統授權或電池記錄時,須切換至相應位置。

介面與開關

Connectivity Test

用來檢查伺服器在目前網路下是否可連線,結果可作為排查線索。測試成功不代表實際請求一定正常,測試耗時也不等於可用頻寬或所有網站的回應速度。若測試失敗,先確認本機網路,再核對伺服器參數;完整排查順序請參閱連線失敗排查說明。

PROTOCOLS

通訊協定與連線參數

通訊協定決定用戶端與遠端如何通訊,不代表速度等級。Type 應與使用者現有伺服器的實際通訊協定一致,不能靠逐一切換通訊協定名稱來修復連線。

通訊協定

Shadowsocks

一種代理通訊協定,通常須核對伺服器位址、連接埠、密碼與加密方式。加密方式是連線參數之一,不能只因名稱相近就任意替換。匯入現有項目後若無法連線,請逐項比對原始資訊,尤其留意複製密碼時是否多帶空格或漏字。

通訊協定

VMess

一種使用識別資訊等參數的代理通訊協定,位址與連接埠只是設定的一部分。傳輸方式及相關 TLS、路徑與主機名稱設定也須與伺服器一致。某些欄位只有在指定傳輸方式下才有作用,排查時應依原始設定核對,不要直接照抄其他項目的附加參數。

通訊協定

VLESS

一種代理通訊協定,識別資訊、傳輸方式與安全相關參數必須互相吻合。它與 VMess 是不同的 Type,不能因使用相似的位址或識別資訊就互換。匯入後仍須確認附加參數完整,尤其不能只填入位址和連接埠,就認為設定已齊全。

通訊協定

Trojan

一種通常搭配 TLS 使用的代理通訊協定,驗證密碼與 TLS 相關資訊各有不同用途。連線位址可連通,不代表伺服器名稱與憑證驗證一定正確。若出現憑證相關錯誤,應核對伺服器名稱、憑證與裝置時間,不宜把關閉驗證當作通用處理方式。

通訊協定

Hysteria2

一種以 QUIC 為基礎的代理通訊協定,通訊仰賴目前網路的 UDP 條件。除了位址與連接埠,也須核對驗證及 TLS 相關參數,不能因其他通訊協定測試成功,就直接認定此協定也能使用。切換網路後結果不同,應分別驗證網路條件與設定參數,而非只憑通訊協定名稱判斷原因。

通訊協定

WireGuard

一種以金鑰為基礎的通道通訊協定,設定中的金鑰、位址與對端資訊各有不同用途。私密金鑰屬於敏感憑證,不應透過截圖、記錄檔或求助訊息公開。核對連線時,須確保本機與對端參數互相對應;只匯入一段公開金鑰並不足以構成完整且可連線的設定。

RULE KEYWORDS

規則關鍵字

規則回答兩個問題:比對什麼,以及如何處理。閱讀時應分開看比對關鍵字與處理策略,並一併檢查規則順序和目前的 Global Routing。

規則關鍵字

DOMAIN

依完整網域名稱比對,用來精確指定單一網域。針對 example.com 的 DOMAIN 規則,不會自動涵蓋 api.example.com 等子網域。若要涵蓋整個網域及其下層名稱,應先判斷 DOMAIN-SUFFIX 是否更符合需求。

規則關鍵字

DOMAIN-SUFFIX

依網域後綴比對,可涵蓋指定網域及其子網域,例如 example.com 與 www.example.com。它不是在完整 URL 中任意搜尋字串,路徑也不是此規則的比對對象。修改後應檢查實際命中情況,並確認前面的規則沒有先處理請求。

規則關鍵字

DOMAIN-KEYWORD

依網域中包含的關鍵字比對,範圍通常比完整網域或網域後綴比對更廣。關鍵字太短時,可能涵蓋原本不打算處理的其他網域。只有確實需要較廣泛的比對時才使用,並應配合實際請求檢查結果,不能將其視為 DOMAIN-SUFFIX 的同義寫法。

規則關鍵字

GEOIP

依目標 IP 在地理位置資料庫中的結果比對,例如 GEOIP,CN,DIRECT。此規則不會依品牌所在地或網域後綴判斷,結果也可能受 IP 位址變動與資料庫內容影響。網域規則與 GEOIP 同時存在時,還須配合解析結果及規則順序理解最終處理方式。

規則關鍵字

IP-CIDR / IP-CIDR6

分別用來比對 IPv4 與 IPv6 位址網段,範圍由網路位址與前綴長度共同決定。相同位址搭配不同前綴長度,可能涵蓋數量截然不同的目標。編寫前應確認目標位址類型與預期範圍;只新增 IPv4 規則,不代表相應的 IPv6 請求也會被同一規則涵蓋。

規則關鍵字

FINAL

用來處理前面的規則都未比對到的請求,通常放在規則末尾作為後備規則。FINAL,DIRECT 與 FINAL,PROXY 的處理方向不同,應依自己的設定目標選擇。修改 FINAL 不會改變已被前序規則比對到的請求,因此排查時不能只看最後一行。

規則關鍵字

PROXY / DIRECT / REJECT

這些是規則中的處理策略關鍵字,分別表示透過代理處理、直接連線與拒絕請求,並非通訊協定名稱。PROXY 不會自動補齊伺服器參數,DIRECT 也不代表不受任何系統網路條件影響。對照介面中的 Proxy、Direct 時,應一併留意大小寫與出現位置,避免混淆整體模式與單條規則。

SUBSCRIPTION & CONFIGURATION

訂閱與設定

訂閱決定項目來源,設定則決定如何處理請求。先確認要匯入的內容,再選擇相應入口操作,避免將訂閱網址填入不相關的欄位。

訂閱與設定

Subscribe

在 Add Server 中用來匯入現有訂閱連結的 Type;連結應使用你向自己的服務供應商取得的完整內容。訂閱可用來取得及更新伺服器項目,但不等同完整的分流設定。連結可能包含存取憑證,求助時應遮蔽敏感資訊,切勿公開貼上完整網址。

訂閱與設定

Add Server

新增伺服器或訂閱項目的入口,Type 會決定接下來需要填寫哪些欄位。若已有訂閱連結,請選擇 Subscribe;若要手動填寫單一伺服器,應選擇其實際通訊協定並逐項核對參數。儲存只表示項目已寫入,還須選取項目、建立連線並驗證請求結果。

訂閱與設定

伺服器

指用戶端連線的遠端服務,也常指應用程式中儲存的一筆連線設定。可用項目須具備互相對應的位址、連接埠、通訊協定及相關驗證資訊,顯示名稱本身不參與驗證。使用者可自行修改備註以利辨識,但這不代表遠端服務或連線能力有所改變。

訂閱與設定

[Rule]

設定檔中用來組織分流規則的區段標記,後續規則會依序參與比對。範圍較廣的規則若排在前面,可能讓後續的精確規則無法生效。修改前先保留原始設定;修改後確認已啟用此檔案,並在 Config 路由模式下檢查結果。

訂閱與設定

DNS

用來將網域名稱解析為 IP 位址,是連線過程中的一個環節。網域解析成功,不代表後續連線、TLS 驗證與規則處理一定成功;反之,連線失敗也不一定是 DNS 問題。排查時應先區分解析錯誤與連線錯誤,再檢查設定中的相關選項。

STORE & PURCHASE

商店與購買

Shadowrocket 是 Apple 平台上的付費閉源商業應用程式,唯一取得管道為 App Store。應用程式購買記錄、裝置上的設定與遠端服務權益須分別確認。

商店與購買

App Store

Shadowrocket 唯一的購買與安裝管道;確認正版時,請核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。主要供 iPhone、iPad 使用;Mac、Apple TV、Apple Vision 的相容性與系統需求,請以 App Store 頁面標示為準。購買前可先參閱正版核對說明。

商店與購買

一次買斷

指支付一次費用購買用戶端應用程式,美國商店價格約為 2.99 美元,實際金額以 App Store 頁面為準,各地商店會以當地貨幣顯示。用戶端一次買斷 ≠ 連線方案,購買應用程式不會自動建立伺服器資訊。後續匯入仍須以使用者已有自己的訂閱或伺服器資訊為前提。

商店與購買

已購項目

在 App Store 查看帳號購買記錄並重新下載應用程式的入口,實際入口名稱可能隨系統介面調整。更換裝置或重新安裝時,應先確認用於商店購買的帳號,再搜尋 Shadowrocket。還原應用程式購買項目與還原伺服器項目是兩回事;現有訂閱與設定也須分別檢查,詳情請參閱還原說明。

商店與購買

商店地區

指 Apple 帳號用於商店交易的國家或地區設定,會影響應用程式的顯示狀態、顯示貨幣與可用付款方式。此設定與裝置語言不同,也不能只依目前所在地判斷。若搜尋不到應用程式,請先確認帳號的商店地區與產品頁面的顯示狀態;變更前請閱讀取得與購買中的相關注意事項。

從術語轉向實際操作

依序完成匯入、連線與驗證;遇到異常時,先找出問題所在層級,再調整對應設定。