官方手冊 · 術語索引

Shadowrocket 術語解說

依分類查閱介面用語、協定與規則關鍵字。先確認名詞所屬的設定層級,再核對參數;保留英文原文與大小寫,方便對照 App 介面。

介面與開關

先了解設定控制的項目,再確認目前狀態代表什麼。開關已啟用、設定已儲存與目標可存取,是三項不同的確認結果。

Home
查看伺服器列表、目前選取項目和連線開關的主要介面。列表中的記錄可能是手動新增,也可能來自自己已有的訂閱。出現記錄只代表項目已儲存;連線前還要確認選取的伺服器,連線後再驗證實際存取結果。
Global Routing
決定連線採用的整體路由方式,分為設定(Config)、代理(Proxy)、直連(Direct)三種模式。Config 依目前設定中的規則分流,Proxy 透過代理處理流量,Direct 則以直連方式處理流量。排查時先記下目前模式,避免將整體模式變更誤認為單一規則生效。
On Demand
依預設網路條件觸發 VPN 連線行為的功能,實際條件以目前 App 設定為準。這項功能控制何時嘗試連線,不代表決定各項請求採用哪條規則。手動中斷後若又自動連線,應先檢查 On Demand 條件,而非反覆刪除伺服器。
Add Server
手動輸入既有伺服器資訊的入口。先選擇協定類型,再依服務提供者提供的資訊確認位址、連接埠、驗證及傳輸參數。不同協定的欄位不能通用,不能只替換伺服器位址,就沿用另一種協定的全部設定。
Connectivity Test
用於檢查伺服器連線狀況,結果通常以耗時或失敗狀態呈現。測試方式、目標和目前網路都會影響結果,因此延遲不是伺服器的固定屬性。延遲較低不代表下載速度較快;若發生逾時,應搭配實際連線狀況與記錄進一步判斷。
DNS
將網域名稱解析為 IP 位址的機制,是存取網域時的重要環節。解析失敗、結果不適當或 DNS 請求路徑異常,都可能導致網頁無法開啟。確認時應同時查看解析設定與規則命中情況,不要只憑連線開關判斷 DNS 是否正常。
VPN 設定
Apple 系統用來管理相關網路連線的設定。首次建立連線時,系統可能會要求確認新增設定。系統允許新增設定,只表示 App 已取得相應連線權限,不代表遠端伺服器驗證成功。請先閱讀提示再操作;若設定衝突,先檢查系統中既有的 VPN 設定。

協定

協定決定用戶端與伺服器的通訊方式,不代表特定伺服器一定可用。輸入既有資訊時,應一併核對驗證、傳輸與加密設定。

Shadowsocks
一種代理協定,常見的必填資訊包括伺服器位址、連接埠、加密方式與密碼。加密方式須與伺服器端一致,不能因名稱相近就任意替換。若既有設定還包含其他相關參數,也應依原始說明保留,避免匯入後只確認密碼。
VMess
使用 UUID 等參數驗證的代理協定,並可搭配不同傳輸方式。UUID 正確只是檢查項目之一,傳輸路徑、Host 與 TLS 等設定也可能影響連線。排查時逐項比對既有伺服器資訊,不要將傳輸方式誤當成協定名稱。
VLESS
使用 UUID 驗證的輕量代理協定,協定本身不提供資料加密。實際連線的安全性與可用性取決於搭配的傳輸、加密及伺服器端設定。它與 VMess 的欄位意義及組合方式不同,不能只修改類型就認為已完成轉換。
Trojan
通常搭配 TLS 使用的代理協定,驗證資訊一般包含密碼。除了位址與連接埠,也須確認伺服器名稱及憑證驗證相關設定。若出現憑證錯誤,應先檢查名稱、裝置時間與伺服器憑證,不應將關閉驗證當成一般處理方式。
Hysteria2
以 QUIC 為基礎的代理協定,通常依賴 UDP 通訊。網路對 UDP 的限制,以及驗證參數、TLS 或混淆設定不一致,都可能影響連線。伺服器位址可以解析,並不足以確認協定可用;還須根據實際連線結果檢查。
WireGuard
透過金鑰建立加密通道的協定,涉及本機金鑰、對端公鑰、位址及 Endpoint 等資訊。公鑰與私鑰用途不同,不可互換;路由範圍也須符合既有設定。私鑰屬於敏感資訊,排查用截圖及對外說明應先移除。
HTTP / SOCKS5
兩種代理協定,使用時須分別確認位址、連接埠與驗證要求。一般 HTTP 代理和 SOCKS5 本身不代表已建立加密通道,是否使用額外加密須依實際設定確認。也不能只憑協定名稱推定支援 UDP,應以伺服器端支援情況為準。

規則關鍵字

閱讀規則時,依序確認比對類型、比對內容與處理策略。以下片段僅用於說明語法;未確認現有 Config 前,請勿整份替換設定。

規則
將請求的比對條件與處理策略連結起來的設定項目。一般規則會依序檢查,較早命中的項目會影響最終處理結果,因此調整順序也可能改變結果。分析異常時應查看實際命中情況,而不只是確認檔案中是否有目標規則。
DOMAIN
精確比對網域名稱的規則關鍵字,例如 DOMAIN,example.com,DIRECT。此規則只適用於指定網域,不會自動涵蓋其所有子網域。若頁面請求使用其他資源網域,應分別檢查這些請求,而不只是查看網址列。
DOMAIN-SUFFIX
比對指定網域及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY。適用於相同網域層級的統一策略,不代表會比對任意包含該文字的網域。確認時應檢查請求網域及其層級關係,避免將包含關鍵字誤認為符合網域後綴。
GEOIP
依 IP 地理位置資料庫比對目標位址,例如 GEOIP,CN,DIRECT。資料庫記錄不等於網站所屬機構的位置;使用分散式服務時,更應留意實際解析結果。規則未如預期命中時,也要檢查 DNS 結果、規則順序與資料庫中的歸屬資訊。
IP-CIDR / IP-CIDR6
分別用於依 IPv4 與 IPv6 網段比對目標位址,例如 IP-CIDR,192.0.2.0/24,DIRECT。斜線後的前綴長度決定涵蓋範圍,不代表連接埠。裝置同時使用兩種位址時,只設定其中一種規則可能無法涵蓋所有連線。
FINAL
前面的規則皆未命中時採用的預設規則,例如 FINAL,PROXY。它說明其餘請求要採用哪種策略,不代表目前連線已成功。通常放在一般規則末尾;修改前先確認未命中的流量應如何處理。
PROXY / DIRECT / REJECT
規則中的處理策略,分別代表代理、直連與拒絕。它們與 Global Routing 中的 Proxy、Direct 介面選項屬於不同層級:前者描述規則結果,後者決定整體路由模式。撰寫設定時保留關鍵字原樣,並確認目前模式確實會套用該規則。

訂閱與設定

區分伺服器列表、設定檔與同步資料。成功匯入只代表資料已讀取,是否適用於目前網路及連線仍須另外驗證。

訂閱
透過連結讀取並更新伺服器項目的來源,使用者須使用自己已有的訂閱資訊。更新訂閱主要是更新該來源的項目,不等於更新 Config 中的分流規則。連結可能包含身分驗證資訊,請妥善保管;更新失敗時先確認原連結是否仍有效。
伺服器
儲存位址、連接埠、協定與驗證資訊的連線項目,日常也稱為節點。一個項目代表一組連線參數,不代表遠端服務目前可用。切換項目後應重新驗證連線,不要只憑名稱、地區標籤或上次測試結果判斷。
Config
承載規則、策略及相關設定的設定檔,也是對應的介面入口名稱。儲存或匯入檔案後,還須確認目前選用的是哪個 Config,以及 Global Routing 是否採用 Config。修改前保留原始檔案,每次調整一項,方便發生問題時還原及比對。
Scan QR Code
透過 QR Code 讀取設定內容的入口,實際匯入內容取決於 QR Code 中的資料。掃描前確認來源,掃描後檢查協定、位址和驗證欄位,不要將成功辨識等同於連線成功。QR Code 可能包含完整憑證,不應直接放入公開截圖。
URL Rewrite
依設定比對請求 URL,並執行改寫或重新導向等處理的功能,與選擇代理或直連的規則分流不同。實際行為取決於比對運算式、動作,以及相關處理機制能否取得請求資訊。排查網頁跳轉異常時,先檢查相關項目,不要同時大幅修改 DNS 與分流規則。
iCloud 同步
在適用設定下透過 iCloud 同步部分 App 資料的機制,實際範圍以目前 App 選項為準。這與 App Store 購買記錄不同,下載已購 App 不代表所有設定都會自動出現。更換裝置前請確認同步狀態,並妥善保留既有訂閱、伺服器資訊及重要 Config。

App Store 與帳號

購買記錄用來取得用戶端,連線設定則用於實際使用。Shadowrocket 是 Apple 平台的付費商業 App,主要供 iPhone 與 iPad 使用。

App Store
Shadowrocket 唯一的購買與取得管道。開啟產品頁後,請確認開發者為 Shadow Launch Technology Limited,並核對官方圖示及 App ID 932747118;系統需求與裝置相容性以 App Store 頁面標示為準。安裝及後續更新均透過 App Store 進行,入口與操作方式請參閱正版核對說明。
Apple ID
與 App Store 購買記錄連結的帳號。裝置用於 iCloud 的帳號,可能與「媒體與購買項目」所使用的帳號不同;查找已購記錄時應確認後者。商店地區會影響商品顯示與付款資訊,實際是否可購買以目前帳號看到的頁面為準。
已購項目
在 App Store 查找原購買帳號記錄的入口,名稱與位置可能隨系統介面調整。更換裝置或重新安裝時,先確認使用原購買帳號,再查找 Shadowrocket 的記錄。還原 App 與還原訂閱、伺服器及 Config 是不同操作,詳細步驟請參閱已購項目還原說明。
一次性買斷
指一次付費取得用戶端使用資格,實際售價以 App Store 頁面顯示為準。用戶端一次性買斷 ≠ 連線方案,購買 App 不會自動產生伺服器或訂閱。其他 Apple 裝置的相容性及是否支援通用購買,也以同一 App Store 頁面標示為準。