官方手冊 · 術語參考

Shadowrocket 術語表

先分清介面入口、連線協定與規則動作,再調整設定。本文依使用情境說明常見名稱;英文名稱保留 App 與設定檔中的原文,各詞條皆可透過錨點直接查看。

5 個主題 30 個詞條 介面用語與規則關鍵字保留原文
介面與開關

連線入口與運作模式

開關決定是否建立連線,Global Routing 則決定如何處理流量。兩者屬於不同層級,疑難排解時應分別確認。

Home

主畫面與連線狀態

Home 是查看伺服器項目、選擇連線目標及操作連線開關的主要頁面。看到伺服器項目只代表資訊已儲存,不表示伺服器目前可用;連線後仍須以實際請求確認存取結果。

Global Routing

全域流量處理方式

Global Routing 包含設定檔(Config)、代理(Proxy)、直連(Direct)三種模式。Config 依據目前的設定檔進行分流,Proxy 將流量交由代理處理,Direct 則直接連線;這些模式仍會受系統網路狀況及 App 相關設定影響。

On Demand

依條件自動連線

On Demand 會依設定條件請求系統自動建立 VPN 連線,實際觸發與所選條件及系統狀態有關。它不會逐一依網域選擇 PROXY 或 DIRECT;若手動中斷後又自動連線,應先檢查此設定,而非立刻刪除設定檔。

Add Server

新增伺服器資訊

Add Server 是新增伺服器項目的入口,不同協定會顯示不同欄位。請依據自己已有的伺服器資訊,逐一確認位址、連接埠、驗證方式及傳輸設定;只填一般欄位而漏掉協定專用參數,可能會儲存成功卻無法連線。

Config

頁面名稱與設定檔模式

Config 可指管理設定檔的頁面,也可指 Global Routing 中的設定檔模式,閱讀操作步驟時須依所在位置判斷。在頁面中儲存某個檔案,與讓該檔案實際參與目前分流是兩回事;修改規則後,請確認目前使用的設定檔。

Connectivity Test

連線測試與結果範圍

Connectivity Test 用於檢查特定測試方式下的連線狀況,不同測試方式涵蓋的連線環節可能不同。測試成功不代表所有網站都能存取,顯示的耗時也不是下載速度;若結果有差異,應一併檢查 DNS、規則命中情形與實際請求。

協定

驗證、傳輸與加密參數

協定名稱決定所需欄位,並不直接代表速度。先確認伺服器端與用戶端參數一致,再檢查網路是否支援所使用的傳輸方式。

Shadowsocks

位址、密碼與加密方法

Shadowsocks 使用伺服器位址、連接埠、加密方法與密碼等參數建立代理連線,加密方法必須與伺服器端一致。匯入分享連結後仍應檢查欄位是否完整;即使密碼正確,只要加密方法不符,也可能無法通訊。

VMess

身分資訊與傳輸組合

VMess 使用 UUID 等身分資訊,也可能搭配不同的傳輸方式與 TLS 設定。UUID 並非完整設定:位址、連接埠、傳輸路徑和伺服器名稱等欄位,均須依實際伺服器需求填寫;裝置時間不正確也可能影響驗證。

VLESS

分別檢查驗證與傳輸安全

VLESS 本身不提供內容加密,通常需搭配相應的傳輸安全機制使用。填入 UUID 後,還應確認傳輸類型、安全設定及其他參數;不要直接把其他協定中名稱相似的欄位照搬到 VLESS 項目。

Trojan

密碼驗證與 TLS

Trojan 通常透過 TLS 與密碼驗證建立連線,伺服器名稱及憑證驗證是疑難排解的重要環節。位址可連線但交握失敗時,先確認密碼、SNI 與憑證是否相符;不應把停用憑證驗證當成一般解決方式。

Hysteria2

以 QUIC 為基礎的傳輸

Hysteria2 以 QUIC 為基礎,連線狀況與網路是否支援 UDP 有關。驗證、TLS 及選用的附加設定都必須與伺服器一致;同一項目在不同網路上的表現不同時,應先檢查 UDP 是否可用,而非一再修改密碼。

WireGuard

金鑰與通道路由

WireGuard 使用金鑰組建立加密通道,設定涉及本機位址、對端公鑰、端點及允許的路由範圍。交握成功只代表部分連線已建立,實際存取仍可能受路由或 DNS 影響;私鑰屬於敏感資訊,不應放在公開截圖中。

HTTP / SOCKS5

一般代理連線類型

HTTP 與 SOCKS5 是不同的代理協定,須分別確認位址、連接埠及是否需要帳號驗證。協定名稱本身不保證連線已加密,對 UDP 等流量的支援也有所不同;請依自己已有的伺服器實際提供的類型選擇。

規則關鍵字

比對條件與處理策略

規則通常依設定檔中的順序逐一比對。左側關鍵字描述比對條件,末尾的策略則說明處理動作;精確規則應放在可能涵蓋它的廣泛規則之前。

DOMAIN

完整網域比對

DOMAIN 比對指定的完整網域,例如 api.example.com,不會自動涵蓋其下其他子網域。規則中的比對內容應是網域,不應填入完整網頁 URL、路徑或查詢參數;適合只為特定主機設定策略。

DOMAIN-SUFFIX

比對網域及其子網域

DOMAIN-SUFFIX 比對指定網域及其子網域,例如 example.com 與 api.example.com。它依據網域階層關係比對,不是搜尋任意字串;若需對特定子網域例外處理,應先加入更精確的 DOMAIN 規則。

DOMAIN-KEYWORD

網域字串比對

DOMAIN-KEYWORD 會依網域是否包含指定字串來判斷是否符合,涵蓋範圍可能比後綴規則更廣。關鍵字太短,可能讓不相關的網域也符合;因此僅適用於需求明確的情況,新增後應檢查實際請求紀錄。

IP-CIDR / IP-CIDR6

依位址網段比對

IP-CIDR 用於 IPv4 網段,IP-CIDR6 用於 IPv6 網段,斜線後的前綴長度代表網段範圍。這些規則比對的是目標 IP,而非網域文字;目標位址是否已解析,以及相關規則參數,都會影響比對過程。

GEOIP

依 IP 資料庫歸屬比對

GEOIP 依據 IP 地理資料庫中的紀錄判斷目標位址歸屬,不會參考網頁語言或網域後綴。資料庫歸屬資訊可能與伺服器實際部署位置不同,使用 CDN 的網域也可能解析到不同位址,因此不能將結果視為固定的實際地理位置證明。

FINAL

未符合規則時的預設策略

FINAL 用來處理未符合先前規則的請求,通常放在規則清單末尾。它不會重新檢查所有規則,而是指定其餘請求的去向;若預設策略選錯,未個別列出的網域可能會以不同於預期的方式連線。

PROXY / DIRECT / REJECT

規則末尾的處理動作

PROXY 代表交由代理策略處理,DIRECT 代表直接連線,REJECT 代表拒絕請求。它們是規則動作,不是協定名稱;也要區分大寫的 PROXY、DIRECT 與 Global Routing 介面中的 Proxy、Direct 模式。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
訂閱與設定檔

連線資料、規則與購買紀錄

訂閱會更新連線資料,設定檔用來編排處理邏輯,商店購買紀錄則確認 App 使用權益。三者各自管理,不能互相取代。

訂閱

可更新的伺服器資訊來源

訂閱透過遠端網址取得並更新一組伺服器資訊,需向你的服務供應商取得。訂閱不同於單一伺服器分享連結,也不一定包含分流規則;訂閱網址可能含有存取憑證,請避免公開貼上或分享。

SERVER

伺服器項目

伺服器項目是一組連線參數,通常包含協定、位址、連接埠及驗證資訊,日常也稱為節點。項目名稱只是方便辨識的標籤,無法證明伺服器的位置或可用性;疑難排解時應檢查實際參數與連線結果。

.conf

分段編排的設定檔

設定檔以文字分段編排設定,[General] 管理全域行為,[Rule] 定義分流順序,[Host] 可用於本機對應。匯入檔案不代表已匯入可用伺服器;修改前應先保留副本,並確認編輯的是目前使用的檔案。

URL Rewrite

請求 URL 處理

URL Rewrite 依比對條件對請求 URL 執行指定處理,與選擇代理或直連的規則屬於不同層級的功能。處理加密請求時,可見內容會受 TLS 及相關設定限制;不能假設一條改寫運算式就能處理所有請求。

iCloud

App 資料同步

iCloud 同步可在支援的裝置間同步 App 支援的資料,實際範圍請以 App 內選項為準。同步、備份與還原購買是不同流程;更換裝置前,請分別確認設定檔副本、同步狀態,以及 App Store 使用的購買帳號。

已購項目

App Store 購買紀錄

已購項目是 App Store 中與購買時使用的 Apple ID 關聯的 App 紀錄,可在更換裝置或重新安裝時用來尋找 Shadowrocket。此紀錄不包含服務供應商訂閱的續訂狀態;裝置相容性、系統需求及通用購買適用性均以 App Store 頁面標示為準。

DNS 與網路

解析、交握與測試耗時

網域解析、建立連線與傳輸內容是不同階段。先判斷問題發生在哪個步驟,再調整相應設定,避免同時變更多個因素。

DNS

網域解析為位址

DNS 會將網域解析為 IP 位址,供後續連線使用。解析失敗可能導致網頁無法開啟,即使某項連線測試正常也一樣;反過來,取得 IP 位址也不代表伺服器可連線,還需繼續檢查路由、連接埠與交握。

dns-server

設定檔中的解析伺服器

dns-server 是 [General] 中用來指定 DNS 解析伺服器的設定項目;system 代表使用系統提供的解析設定。修改前,請確認目前使用的設定檔確實生效,並考量解析請求所經過的網路路徑;更換位址不一定能解決所有存取問題。

TLS / SNI

傳輸保護與伺服器名稱

TLS 用於保護傳輸;SNI 則是在交握時向伺服器指出要求連線的伺服器名稱,兩者並不相同。連線位址可能與憑證驗證所用的名稱不同,請依伺服器要求填寫;若出現憑證錯誤,先確認名稱與裝置時間。

延遲與逾時

測試結果的適用範圍

延遲代表某個測試環節所花的時間;逾時代表未能在指定時間內完成測試目標,不代表已確認伺服器故障。測試方式、DNS 與網路路徑都會影響結果;延遲較低不保證傳輸量較高,速度問題仍須搭配實際傳輸情況判斷。

前往 App Store