官方手冊 · 概念查閱

Shadowrocket 術語表

介面用語、協定與規則關鍵字

先釐清「在哪個介面操作」、「使用哪種協定連線」以及「請求符合哪項策略」,再調整參數。本頁依五大類說明術語;英文名稱保留原文,可透過分類或條目錨點快速查找。

介面名稱 ≠ 規則關鍵字 伺服器資訊 ≠ 設定檔 連線測試 ≠ 速度測試
操作入口

介面與開關

介面用語說明操作位置或整體狀態。請特別留意,Global Routing 中的 Config、Proxy、Direct,與設定檔名稱及規則列中的策略並非同一層級。

Home

Home 可查看伺服器列表、目前選取項目與連線狀態,也是日常檢查連線的起點。列表中出現一筆紀錄,只代表參數已儲存,不代表伺服器已可使用,更不代表目前已建立連線;排查時應分別確認選取項目與連線開關。

Global Routing

Global Routing 決定整體路由方式,提供三種模式:設定(Config)、代理(Proxy)、直連(Direct)。需要規則分流時,請先確認是否選取 Config;若整體模式與預期不符,只調整單一規則可能看不到預期效果。

Config 路由模式

作為 Global Routing 的選項,Config 代表依目前設定檔中的規則與相關設定處理請求。這不表示所有請求都會經過代理:符合 DIRECT 的請求可直連,符合 REJECT 的請求則會遭拒;也須確認目前啟用的是哪一份設定檔。

Proxy

Proxy 是 Global Routing 中的代理模式,讓整體流量採用代理路徑,而非依一般規則逐項分流。它與規則中的大寫 PROXY 屬於不同層級;檢查連線時,仍須確認目前伺服器及其驗證、傳輸參數是否正確。

Direct

Direct 是 Global Routing 中的直連模式,連線不經選取的代理伺服器轉送。直連不代表忽略 DNS、系統路由或目前網路條件;切換至 Direct 後能否連上特定目標,仍取決於裝置所在網路與目標服務的實際狀態。

Add Server

Add Server 是手動新增伺服器的入口,請依據現有資訊選擇類型,再填寫位址、連接埠及相應的驗證欄位。不同協定所需欄位各異,Password、UUID 與金鑰不可互相替代;填妥後還須選取該筆紀錄並測試連線。

依步驟查看首次設定 →
連線方式

協定

協定決定客戶端與伺服器如何交換資料。類型、驗證、傳輸方式與 TLS 等參數須整組相符;不能只憑協定名稱推斷速度、延遲或實際可用性。

Shadowsocks

Shadowsocks 是一種加密代理協定,常見參數包括伺服器位址、連接埠、加密方法與密碼。加密方法須與伺服器端一致;即使位址和密碼正確,方法不符仍可能無法通訊,其他傳輸參數也應依現有資訊逐一核對。

VMess

VMess 是使用 UUID 等參數識別使用者的代理協定,連線也可能搭配不同傳輸方式與 TLS。UUID 填寫正確不代表整組參數都正確;還須核對傳輸類型、Host、Path,以及實際需要的憑證相關設定。

VLESS

VLESS 是一種輕量代理協定,通常以 UUID 識別使用者,協定本身不提供應用程式資料加密。實際傳輸保護須配合 TLS 等機制判斷;設定時不要直接套用 VMess 的欄位慣例,應以對應的伺服器參數為準。

Trojan

Trojan 通常透過 TLS 通道傳送代理資料,並使用 Password 驗證。伺服器位址與用於憑證驗證的名稱可能各有用途;連線失敗時,請核對 Password、SNI 與憑證是否相符,不宜將略過憑證驗證當成一般修復方式。

Hysteria2

Hysteria2 是以 QUIC 為基礎的代理協定,透過 UDP 傳輸通訊。驗證、TLS 與其他連線參數須與伺服器一致,所在網路也須允許相關 UDP 通訊;TCP 連線測試有結果,並不能據此證明這條連線一定可用。

WireGuard

WireGuard 是使用金鑰驗證的通道協定,設定通常包含本機私鑰、對端公鑰、Endpoint,以及位址或路由參數。公鑰與私鑰用途不同,不可交換填寫;私鑰屬於敏感憑證,分享設定或提供排查資訊前應先移除。

HTTP

在伺服器類型中,HTTP 指的是 HTTP 代理,並非表示目標網頁只能使用 HTTP。存取 HTTPS 目標時通常會透過 CONNECT 建立通道;代理連線本身是否受 TLS 保護,取決於所選類型與參數,不能只因目標位址含有 HTTPS 就判定。

SOCKS5

SOCKS5 是代理轉送協定,可依伺服器要求設定使用者名稱與密碼,但協定本身不提供傳輸加密。UDP 轉送須同時獲得客戶端設定、伺服器能力與網路條件支援;TCP 存取正常不代表 UDP 請求也會有相同結果。

查看協定概覽與填寫重點 →
比對條件 → 處理策略

規則關鍵字與策略

規則通常依由上而下的順序檢查,符合條件後套用相應策略。DOMAIN-SUFFIX 等關鍵字決定「比對什麼」,PROXY、DIRECT、REJECT 則決定「如何處理」,兩者不可混用。

一行規則的三個部分

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-SUFFIX 是類型,example.com 是比對值,PROXY 是策略。此範例用於說明語法,不代表應直接將該規則加入目前的設定。

DOMAIN

DOMAIN 會精確比對指定網域,例如 example.com,不會自動涵蓋 www.example.com。適合只處理單一主機名稱的情況;若目標服務使用多個子網域,需逐一列出,或確認涵蓋範圍後再考慮其他比對類型。

DOMAIN-SUFFIX

DOMAIN-SUFFIX 會比對指定網域及其子網域,例如 example.com 與 api.example.com。它依網域邊界辨識後綴,不是任意文字包含比對;適合將同一網域體系交由統一策略處理,但仍須留意前方是否已有規則先行符合。

DOMAIN-KEYWORD

DOMAIN-KEYWORD 依網域是否包含指定關鍵字進行比對,範圍通常比後綴比對更廣。較短的關鍵字可能同時符合彼此無關的網域;新增前應先確認影響範圍,不宜以過短片段取代明確的完整網域。

GEOIP

GEOIP 依 IP 地理資料庫記錄的國家或地區歸屬比對目標 IP,而非依使用者所在地或網頁內容判斷。資料庫結果可能與網站品牌所屬地區不同,CDN 也可能回傳不同位址;須配合實際解析結果理解符合原因。

IP-CIDR

IP-CIDR 使用 CIDR 表示法比對 IPv4 位址範圍,例如 192.0.2.0/24。斜線後的數字代表網路前綴長度,不是連接埠;前綴越長,涵蓋範圍通常越小,修改前請先確認目標位址確實位於該網段。

IP-CIDR6

IP-CIDR6 用於比對 IPv6 位址範圍,例如 2001:db8::/32,與 IPv4 位址範圍規則分開處理。同一網域可能同時回傳兩種位址;只新增 IPv4 規則,不代表 IPv6 連線也會套用相同策略,須依實際連線位址檢查。

FINAL

FINAL 為未符合前序規則的請求指定最終策略,通常放在規則列表末尾。它不填寫網域或位址比對值,例如 FINAL,DIRECT;若放在具體規則之前,後續規則可能無法如預期參與比對。

PROXY

PROXY 是規則中的代理策略,代表將符合條件的請求交由代理路徑處理。它不是伺服器位址,也不是協定名稱;實際使用哪個出口,須配合目前選取項目與設定判斷,填入 PROXY 本身不會產生可用的伺服器資訊。

DIRECT

DIRECT 是規則中的直連策略,符合條件後該連線不經代理伺服器轉送。這不等於關閉所有網路處理,也無法保證一定能連上目標;DNS 解析、系統網路狀態與目標服務仍會影響連線結果。

REJECT

REJECT 代表拒絕符合條件的連線,而不是從頁面中精確刪除某個元素。若同一網域承載多種內容,依網域拒絕可能連帶影響正常功能;設定後應檢查實際請求,不要將拒絕連線視為內容層級的篩選。

繼續閱讀比對範圍與排列順序 →
資料與檔案

訂閱與設定檔

先確認匯入內容的用途,再決定匯入位置。伺服器紀錄用於管理連線參數,設定檔則管理規則與設定;更新訂閱也不代表目前設定已切換。

Subscribe

Subscribe 用於匯入或更新現有訂閱內容,實際包含哪些紀錄取決於訂閱格式與回傳資料。訂閱網址應向你的服務商取得,並視為敏感資訊妥善保管;更新失敗時,先檢查網址、網路與回傳格式,不要公開完整網址以供排查。

Server

Server 是一組伺服器參數紀錄,通常包含協定、位址、連接埠與驗證資訊,也常稱為節點。顯示名稱只是方便辨識的標籤,不參與驗證;兩筆紀錄即使名稱相同,實際位址、協定或憑證參數也可能不同。

Config 設定檔

Config 也指管理規則、DNS 等內容的設定檔及相關介面,須依語境與 Global Routing 中的同名模式區分。儲存或匯入檔案後,還須檢查目前啟用的項目;更新主要承載伺服器資訊的訂閱,不代表規則檔也會一併更新。

查看 Config 管理說明 →
解析、連線與同步

設定項目

設定項目可能影響解析路徑、連線觸發條件或資料同步。排查時一次只變更一類設定,並記下原始值;實際選項名稱與適用範圍以 App 內顯示為準。

DNS

DNS 會將網域解析為 IP 位址,是許多網路連線建立前的必要步驟。變更解析設定可能改變回傳位址與後續規則判斷,但不會直接改變伺服器驗證參數;遇到問題時,應區分解析失敗、連線失敗與憑證驗證失敗。

查閱 DNS 設定 →

On Demand

On Demand 是依據設定條件由系統觸發連線的隨選連線機制,可減少反覆手動切換連線開關的需求。這不代表伺服器始終可用;若出現自動重新連線,應同時檢查觸發條件與目前網路,而非只看開關狀態。

查閱 On Demand 設定 →

Connectivity Test

Connectivity Test 用於檢查連線是否可用,結果會受測試方式、測試目標與當時網路狀態影響。延遲數值不是下載速度,某次探測成功也不能證明所有目標或 UDP 請求都可用;比較結果時應使用相同的測試方式。

查閱測試與 Ping →

URL Rewrite

URL Rewrite 依比對條件改寫請求 URL,例如調整請求位址或執行相關重寫動作。它與決定連線出口的路由規則不同,生效範圍受請求可見性與設定條件限制;不能只新增網域規則,就推斷加密請求內容也能改寫。

iCloud

iCloud 是用於應用程式資料同步的系統服務,實際同步項目須在 App 中確認,並會受帳戶、系統權限與同步狀態影響。它與 App Store 購買紀錄用途不同;換機前應確認同步已完成,不要把開啟同步視為所有資料都已備份。

查閱 iCloud 同步 →