官方手冊 · 術語索引

Shadowrocket 術語表

先區分介面入口、通訊協定名稱與規則策略,再檢查詳細參數。本頁將常用詞彙分為五類;英文保留應用程式與設定中的原文,並以中文說明其用途、適用範圍及容易混淆之處。

本頁以使用者已有自己的訂閱或伺服器資訊為前提,僅說明用戶端操作。需要逐步操作說明時,請參閱使用說明;需要了解完整設定脈絡時,請參閱使用手冊。

01 · 介面與開關

入口名稱與路由模式

連線是否啟用、流量採用何種處理方式,以及目前選取哪部伺服器,是三個不同問題。

介面與開關

Home

Home 是查看既有伺服器、目前選取項目與連線狀態的主要入口。看到伺服器項目只表示資訊已匯入,不代表驗證、網路與遠端服務都已確認正常。開始排查時,請先記錄選取的項目與連線狀態,避免一邊切換一邊判斷結果。

介面與開關

Global Routing

Global Routing 用於選擇流量的全域處理模式,包含 Config、Proxy、Direct。它不是連線開關,也不會補齊伺服器參數。變更此設定後,既有規則的處理方式可能隨之改變;核對規則前,應先確認目前的模式。

介面與開關

Config / Proxy / Direct

三種模式分別為設定、代理與直連:Config 依目前設定處理流量,Proxy 以代理路徑為主要處理方式,Direct 則以直接連線為主。實際系統流量與例外情況仍須依設定判斷。這些首字母大寫的介面用語,與規則行末全大寫的策略關鍵字並不相同。

介面與開關

On Demand

On Demand 會依已設定的網路條件觸發連線行為,可依 Wi-Fi、行動網路等條件安排隨選連線。它不是在偵測到連線失敗後自動修復伺服器的機制。若手動中斷後又再次連線,請檢查觸發條件與系統狀態,而非只重複操作開關。

介面與開關

Add Server

Add Server 是輸入使用者既有伺服器資訊的入口。通訊協定類型、位址、連接埠與驗證欄位必須來自同一組有效資料;部分類型還需要傳輸方式與 TLS 參數。成功儲存只代表項目已建立,之後仍應測試連線,並透過實際連線確認結果。

介面與開關

Settings

Settings 是查看及調整用戶端設定的入口,不應與 Config 中的設定檔混為一談。排查時先記錄選項原值,再一次變更一項與問題相關的設定。若同時修改多項,結果將難以重現,也不利於確認究竟是哪個設定影響連線。

02 · 通訊協定

通訊協定名稱與參數範圍

通訊協定類型應與既有伺服器資料一致;名稱本身無法說明速度、穩定性或適用網路。

通訊協定

Shadowsocks

Shadowsocks 是一種代理通訊協定,常見參數包括伺服器位址、連接埠、加密方式與密碼。加密方式必須與遠端設定相符,不能只因位址正確就認定設定完整。匯入後若無法連線,請逐項核對原始資料,不要任意替換驗證或加密欄位。

通訊協定

VMess

VMess 使用相應的身分參數,並可搭配不同的傳輸設定。身分資訊相同,不代表傳輸路徑、Host 或 TLS 條件也相同;這些欄位必須一併核對。裝置時間異常也可能影響驗證判斷,因此排查時應確認系統時間正確。

通訊協定

VLESS

VLESS 的驗證資訊與傳輸設定必須搭配使用,不能將它視為只需更換通訊協定標籤。通訊協定名稱本身不代表連線採用何種加密保護,仍須檢查 TLS 等相關條件。匯入既有項目時,應保留原始資料中的傳輸參數與伺服器名稱。

通訊協定

Trojan

Trojan 通常搭配 TLS 使用,需核對伺服器位址、連接埠、密碼及用於驗證的伺服器名稱。建立連線的位址與憑證對應的名稱可能用途不同,不應一律填成相同內容。遇到憑證錯誤時,請先檢查名稱、裝置時間與憑證條件。

通訊協定

Hysteria2

Hysteria2 是以 QUIC 為基礎的代理通訊協定,連線狀況與 UDP 是否可用有關。即使伺服器參數完整,若目前網路限制了相應傳輸,仍可能發生逾時。通訊協定名稱不保證實際傳輸速率;應綜合網路條件、驗證設定與實際連線結果判斷。

通訊協定

WireGuard

WireGuard 是使用金鑰對驗證對端的隧道通訊協定,設定包含本機位址、金鑰與對端資訊。公開金鑰、私密金鑰和預先共用金鑰用途不同,不可互換填寫。分享排查資料時,請隱藏私密金鑰等敏感內容,並確認位址範圍與路由設定符合既有設定。

通訊協定

HTTP / SOCKS5

HTTP 與 SOCKS5 是不同的代理通訊協定,不能因位址和連接埠相同就互相替換。是否需要驗證、是否有額外加密保護,以及可處理的流量類型,都須依具體設定確認。使用時應依既有伺服器資料選擇類型,不要只憑名稱推測功能。

03 · 規則關鍵字

比對條件與處理策略

關鍵字說明「比對什麼」,策略說明「如何處理」;規則順序決定哪一條先發揮作用。

規則關鍵字

[Rule]

[Rule] 是設定中的規則區段,規則由上而下依序檢查,符合條件後套用對應策略。範圍較廣的規則若排在前面,後續更精確的規則可能無法生效。修改前請先確認 Global Routing 設為 Config,並備份目前設定。

規則關鍵字

DOMAIN / DOMAIN-SUFFIX

DOMAIN 用於比對完整網域名稱;DOMAIN-SUFFIX 用於比對指定網域及其子網域。後綴不是網頁路徑,也不是任意字串搜尋。若只想處理明確的主機名稱,應優先考慮精確比對,避免一併涵蓋整個網域範圍。

規則關鍵字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 依網域名稱中包含的字串進行比對,涵蓋範圍可能超出預期。同一字串可能出現在多個互不相關的網域中,因此它不等同網域後綴比對。用於拒絕規則時尤其應檢查比對紀錄,避免誤處理正常請求。

規則關鍵字

IP-CIDR / IP-CIDR6

IP-CIDR 與 IP-CIDR6 分別依 IPv4、IPv6 網段比對,斜線後的數字代表前綴長度。這些關鍵字判斷的是位址範圍,而非網域文字。同一服務可能使用多組位址;核對規則時,不能只根據單次解析結果推斷所有請求都會符合。

規則關鍵字

GEOIP

GEOIP 依據 IP 地理位置資料庫進行比對,不代表裝置或使用者的實際所在地。資料庫中的地理歸屬也不一定與服務營運地點相同,分散式服務可能使用多個地區的位址。判斷分流結果時,應一併檢查目標位址、資料庫資訊與規則順序。

規則關鍵字

FINAL

FINAL 為未符合前述規則的流量指定預設策略,通常放在規則區段末尾。它不是「最後再連線一次」,也不代表會依速度自動選擇路徑。調整後會影響所有未被前面規則涵蓋的流量,因此應先確認預設處理目標再修改。

規則關鍵字

PROXY / DIRECT / REJECT

以下三個全大寫詞是規則中的處理策略:PROXY 交由代理路徑處理,DIRECT 直接連線,REJECT 則拒絕符合條件的流量。它們不是伺服器通訊協定名稱,也不會提供驗證參數。必須將策略與規則條件一併閱讀,才能判斷特定請求為何如此處理。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
04 · 訂閱與設定

項目、檔案與購買紀錄

伺服器清單、路由設定與 App Store 購買紀錄各自保存不同資訊,不能互相取代。

訂閱與設定

訂閱

訂閱通常是用來取得或更新一組伺服器項目的網址,前提是使用者已有自己的有效訂閱。訂閱不一定包含完整的路由規則;匯入訂閱與啟用 Config 是不同操作。訂閱網址可能含有存取憑證,不應在公開截圖、紀錄或求助內容中完整顯示。

訂閱與設定

伺服器

伺服器項目會儲存遠端位址、通訊協定、連接埠與驗證等資訊,清單項目也常稱為節點。項目顯示名稱只是識別標籤,無法據此確認實際地區、速度或服務狀態。判斷是否可用,應檢查實際參數、連線狀況與服務有效條件,而不只是查看名稱。

訂閱與設定

Config 設定檔

設定檔包含一般選項、規則等設定,與伺服器清單分開管理。介面中的 Config 入口與 Global Routing 中的 Config 模式使用相同詞彙,但前者涉及檔案管理,後者表示依設定處理流量。匯入檔案後,請確認目前啟用的是哪一份設定。

訂閱與設定

[General]

[General] 是設定中的一般設定區段,可包含 DNS、系統流量處理及略過代理的位址等選項。它與 [Rule] 用途不同,不可將規則行任意放入此區段。複製局部範例時,應一併核對所屬區段、欄位語法及其對現有設定的影響。

訂閱與設定

Scan QR Code

Scan QR Code 可透過 QR Code 讀取設定內容;QR Code 本身只是資料載體。掃描結果可能是伺服器資訊,也可能是需要進一步處理的網址,請先確認內容類型。匯入成功後仍須核對通訊協定與參數;含有驗證資訊的 QR Code 也應視為敏感資料妥善保存。

訂閱與設定

已購項目

已購項目是 App Store 中查詢原始購買紀錄的入口;更換裝置或重新安裝時,應先確認原購買帳號。購買紀錄不是用戶端設定備份,重新取得應用程式不代表所有伺服器與規則都會自動還原。iPhone 與 iPad 的購買適用範圍,以 App Store 頁面標示為準。

05 · 連線與診斷

測試結果與實際連線

先判斷問題出在解析、連線、驗證還是規則;單一測試數值無法取代完整的連線流程。

連線與診斷

DNS

DNS 會將網域名稱解析為位址,是連線流程中的一個環節。解析成功不代表伺服器驗證成功;解析失敗也不一定表示代理伺服器離線。若只有部分網域異常,請分別檢查 DNS 設定、回傳位址、快取與相關規則,避免直接修改所有伺服器項目。

連線與診斷

Connectivity Test

Connectivity Test 依目前的測試方式檢查連線能力,結果取決於測試目標、網路及當時的伺服器狀態。測試通過不保證每個網站或每類請求都能正常處理;測試失敗也應搭配紀錄判斷原因。比較多個項目時,請保持測試方式與網路條件一致。

連線與診斷

延遲

延遲是指測試請求在特定條件下收到回應所需的時間,不等同傳輸頻寬。數值較低不保證傳輸大型檔案或維持長連線時表現更好;封包遺失、壅塞與遠端負載也會影響使用體驗。選擇既有伺服器時,應綜合多次測試與實際連線結果,不要只依單次結果排序。

連線與診斷

Data

Data 可用於查看流量紀錄及相關資訊,協助檢查目標、規則與連線行為。統計方式取決於具體檢視畫面,不能直接將其中的數字視為服務端計費流量。排查問題時,請對照同一次操作的紀錄;分享前應隱藏目標位址與驗證資訊等敏感內容。

連線與診斷

TLS

TLS 是用於保護傳輸連線的機制;伺服器名稱、憑證信任條件與裝置時間都會影響驗證。連線位址能回應,不代表憑證驗證一定會通過。發生錯誤時,請核對原始設定中的名稱與憑證條件,不宜將略過驗證當作日常排查的預設做法。

連線與診斷

VPN 設定授權

VPN 設定授權是 Apple 系統允許用戶端建立網路隧道所需的授權,首次連線時可能會出現系統確認畫面。完成授權只代表系統允許建立該設定,不代表既有伺服器已能連線。即使系統顯示已連線,也應進一步確認 DNS、路由策略與實際連線結果。

依問題繼續查閱

項目已匯入但無法使用時,可依「伺服器參數 → VPN 設定授權 → Global Routing → DNS → 個別規則」的順序逐步縮小範圍。每次只變更一個條件,並保留可還原的原始設定,才能將測試結果與變更項目對應起來。

  • 首次匯入與連線:參閱使用說明,依序完成新增、選取、連線與驗證。
  • 規則順序與日常維護:參閱使用手冊,搭配完整設定理解局部規則。
  • 購買、已購項目還原與正版確認:參閱App Store 正版確認說明。
  • 主題操作與排查:參閱技術筆記,再回到相關術語確認概念。

介面中可使用的欄位可能因裝置與應用程式實際狀態而異,請以應用程式目前顯示為準。本頁說明術語,不取代既有服務的參數說明;系統需求與購買適用範圍以 App Store 頁面標示為準。