官方手冊 · 術語速查

Shadowrocket 術語速查

先確認術語出現的位置，再判斷它控制的項目。本文分別說明介面選項、協定名稱、規則語法與網路概念；同一個詞出現在不同位置時，作用範圍可能不同。

30 個常用術語
介面用語保留英文
每個項目都可透過錨點直接定位

01 · 介面與開關

路由方式與連線狀態

Global Routing 決定整體處理方式，連線開關則控制是否建立連線。請勿將路由模式、單條規則的動作與測試結果混為一談。

Global Routing: Home 頁中用來選擇整體路由方式的介面項目；設定、代理、直連分別對應 Config、Proxy、Direct。排查規則未生效時，先確認這裡是否選擇 Config，再檢查目前的設定。切換模式不等於修改伺服器的協定參數。

Config: 在 Global Routing 中，Config 表示依照目前設定處理請求，由規則決定各請求的路徑。作為頁面名稱時，Config 則是管理設定檔的入口。看到這個詞時，先確認目前是在選擇路由模式，還是在檢視檔案清單。

Proxy: Global Routing 中的代理模式，主要依照目前選擇的代理處理流量，而非逐條按照分流規則選擇路徑。它與規則中的大寫 PROXY 分屬不同層級。選擇 Proxy 也無法補上缺少的驗證資料或修正錯誤的連接埠。

Direct: Global Routing 中的直連模式，讓請求透過直接連線路徑存取目標，可用來比較本機網路與代理路徑的狀況。直連仍仰賴 DNS、目標服務及目前的網路環境。Direct 並不代表「所有網站都能連線」。

On Demand: 依條件觸發連線的功能，實際行為須配合 App 內條件與系統狀態確認。此功能關心何時連線，分流規則則決定如何處理請求。排查自動連線問題時，應一併檢查相關條件，不能只看 Home 頁的開關。

Connectivity Test: 用來輔助判斷伺服器在指定測試條件下的回應情況，結果會受測試方式、目標及網路狀態影響。測試成功不代表每個網站都能連線，測試耗時也不是下載速度。若結果異常，還應檢查實際請求與錯誤紀錄。

02 · 協定

連線類型與參數限制

協定類型必須符合既有伺服器資訊。不能只修改 Add Server 中的類型，就把同一組憑證變成另一種協定；更多設計取捨請參閱協定詳解 →

Shadowsocks: 使用指定加密方式與憑證建立代理連線的協定，常見參數包括伺服器位址、連接埠、密碼及加密方式。以上資訊須與伺服器端一致，尤其不能憑名稱猜測加密方式。連線表現也會受伺服器負載與本機網路影響。

VMess: 具有身分驗證機制的代理協定，通常使用 UUID 識別使用者，並可搭配不同傳輸方式。UUID 正確只是必要條件之一，傳輸路徑、伺服器名稱及 TLS 等設定也須相符。排查時應逐項核對欄位，而非反覆更改項目名稱。

VLESS: 以精簡驗證與轉送為設計方向的代理協定，通常也使用 UUID，但不能因此與 VMess 共用設定。連線保護取決於搭配的安全層與傳輸設定。匯入後應確認類型、驗證欄位及傳輸參數都符合原始資訊。

Trojan: 通常搭配 TLS 與密碼驗證使用的代理協定。除了伺服器位址和密碼，也須留意伺服器名稱及憑證驗證。位址能解析，不代表 TLS 交握一定能完成。遇到憑證錯誤時，先核對名稱、裝置時間與伺服器設定。

HTTP / SOCKS5: 這是兩種不同的代理協定，支援的請求形式、驗證方式與承載能力並不完全相同。協定名稱本身不代表傳輸已加密，也無法據此推斷是否支援特定類型的流量。新增時應依既有伺服器說明選擇相符的類型及安全選項。

WireGuard: 以金鑰身分識別與 UDP 傳輸為基礎的隧道協定，設定項目包含 PrivateKey、PublicKey、介面位址、Endpoint 與 AllowedIPs。金鑰、位址與路由範圍各有用途，不可互換填寫。PrivateKey 屬於敏感資訊，分享排查資料時應先移除。

Hysteria2: 以 QUIC 為基礎的代理協定，仰賴可用的 UDP 網路路徑，設定也包含驗證與伺服器名稱等參數。協定名稱中的數字是名稱的一部分，不是本站提供的 App 版本號。速度與耗電表現取決於網路封包遺失、傳輸負載及裝置狀態，不能只憑類型判斷。

03 · 規則關鍵字

比對條件與處理策略

先了解「比對什麼」，再了解「命中後要做什麼」。下列網域與位址僅用於說明語法，不是可用的伺服器資訊；規則順序也會影響最終結果。

DOMAIN: 用來比對完整網域名稱，例如 DOMAIN,example.com,DIRECT 針對的是 example.com 本身。它不會自動涵蓋該網域的所有子網域，也不是比對完整網頁 URL。若請求使用其他網域，請檢查實際請求紀錄。

DOMAIN-SUFFIX: 用來比對網域後綴，例如 DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 及其子網域。它的涵蓋範圍比 DOMAIN 廣，但不是比對任意包含該字串的內容。新增前請確認是否確實要讓整組子網域採用相同策略。

GEOIP: 依據 IP 地理位置資料庫進行比對，結果會受資料庫內容及目標解析位址影響。IP 歸屬不等於使用者所在地或實際服務位置。一個網域可能解析到多個位址，因此不能只看網站名稱推斷比對結果。

IP-CIDR: 用來比對 IPv4 網段，例如 IP-CIDR,192.168.0.0/16,DIRECT 表示一個私有位址範圍。斜線後的數字是網路前綴長度，不是連接埠或連線數量。設定範圍過廣時，可能一併比對到原本需要分開處理的位址。

IP-CIDR6: 用來比對 IPv6 網段，與 IP-CIDR 對應的位址族不同。若目標同時有 IPv4 與 IPv6 位址，只設定 IPv4 規則不代表已檢查所有請求路徑。排查結果不一致時，應確認實際使用的位址族。

FINAL: 用來處理先前未命中其他規則的請求，通常作為規則末尾的兜底項目。FINAL,DIRECT 表示其餘請求交由直接連線路徑處理，不代表前面的規則失效。排查意外分流時，先找出實際命中的規則，再確認是否落入 FINAL。

PROXY / DIRECT / REJECT: 三者都是規則中的處理策略：PROXY 交由代理路徑處理，DIRECT 使用直接連線，REJECT 則拒絕請求。它們描述命中後的動作，不是協定類型或比對條件。大寫策略與 Global Routing 中的 Proxy、Direct 須依所在位置區分。

04 · 訂閱與設定

項目、檔案與購買紀錄

更新訂閱、切換設定檔與更新 App 是三件不同的事。以下說明以使用者已有自己的訂閱或伺服器資訊為前提；購買 App 不會自動產生這些資訊。

伺服器項目: 儲存伺服器位址、連接埠、驗證資料與協定參數的連線紀錄，也常稱為節點。SERVER 區塊中的顯示名稱只是標籤，無法證明伺服器位置、速度或可用性。使用 Add Server 手動填寫時，請逐項對照既有資訊。

設定檔: 用來整理規則、DNS 等設定的文字檔，與單一伺服器項目用途不同。匯入檔案後，還須確認目前啟用的是哪一份，並搭配 Global Routing 判斷其作用。更換檔案前請保留原本可用的設定，方便比較與還原。

規則: 由比對條件與處理策略組成的設定項目，例如比對網域後選擇 DIRECT。規則通常依序檢查，範圍較廣的條件可能先命中，導致後面的精確條件無法生效。判斷問題時應查看實際命中的項目，而不只是搜尋檔案中是否有目標網域。

已購項目: 在 App Store 查找既有購買紀錄的入口。更換裝置或重新安裝時，請先確認使用購買時的 Apple ID。Shadowrocket 為一次性買斷，價格及通用購買適用性以 App Store 頁面標示為準。App 一次性買斷 ≠ 線路方案；重新取得 App 也不代表伺服器資訊會一併還原。

05 · DNS 與網路

解析、交握與回應時間

一次連線可能依序經過解析、建立連線、安全交握與資料傳輸。其中一個階段成功，不代表後續階段也成功；請依錯誤發生的階段找出問題。

DNS: 用來將網域名稱解析為 IP 位址等紀錄的系統，解析結果是後續連線的重要依據。解析成功只表示取得回覆，不代表位址可連線或目標服務正常運作。DNS 查詢路徑也不一定與實際服務請求的路徑相同，須分別檢查。

DNS over HTTPS: 透過 HTTPS 傳送 DNS 查詢的方式，通常簡稱 DoH，用來保護用戶端與解析服務之間的查詢傳輸。解析服務本身仍須可連線，其網域也可能需要先行解析。啟用 DoH 不代表所有服務請求都會經由代理路徑。

TLS: 用來保護傳輸連線並驗證對端身分的安全協定，與代理協定類型並非同一概念。憑證驗證失敗可能與伺服器名稱、憑證有效期限、信任鏈或裝置時間有關。排查時應核對這些資訊，不要直接將錯誤歸因於密碼。

SNI: TLS 交握時用來宣告目標伺服器名稱的擴充資訊，可協助同一位址上的服務選擇對應網站與憑證。它不一定與實際連線的 IP 位址相同，但必須符合伺服器部署要求。名稱不符時，即使連接埠可連線，也可能無法完成交握。

延遲: 在指定測試方式下測得的回應時間，須搭配測試類型、目標與本機網路狀況解讀。低延遲不等於高傳輸量，也無法保證大型檔案傳輸穩定。比較結果時，應盡量維持測試條件一致，並參考實際連線與錯誤紀錄判斷。