官方手冊 · 術語查閱

Shadowrocket 術語手冊

介面與開關、協定、規則關鍵字、訂閱與設定、帳號與購買。

本頁保留介面用語與協定名稱的英文原文,說明各項功能與不能據此推斷的事項。適合已有訂閱或伺服器資訊的使用者查閱;首次設定可先閱讀教學,遇到連線問題再依疑難排解逐項確認。

連線與路由入口

介面與開關

先確認目前使用哪種 Global Routing 模式,再解讀測試結果。連線開關、自動觸發條件與個別請求的處理策略,是不同的設定。

介面與開關Home
Home 是查看連線狀態、Global Routing、Connectivity Test 與 SERVER 清單的主要入口。首次開啟時,Not Connected 表示尚未建立連線;啟用連線可能需要依系統提示允許加入 VPN 設定。連線狀態改變只代表通道狀態有所變化,目標網站是否能連線仍需另外確認。
介面與開關Global Routing
Global Routing 決定整體流量採用哪種處理方式:設定檔模式 Config、代理模式 Proxy 或直連模式 Direct。若要依網域或 IP 規則分流,請選擇 Config,並確認目前已選用正確的設定檔。排查時可暫時切換模式比對結果;測試後應還原原設定,避免將排查狀態當成日常規則。
介面與開關Config
Config 既是設定檔管理頁面的名稱,也是 Global Routing 中依設定檔處理流量的模式名稱。進入 Config 頁面可管理檔案;選擇 Config 模式才表示依目前設定檔中的規則處理流量。已匯入檔案不代表已選用;規則未生效時,需同時確認這兩個層級。
介面與開關Proxy / Direct
在 Global Routing 中,Proxy 讓流量走代理路徑,Direct 則讓流量直接連線,適合暫時比對兩種連線路徑。這裡首字母大寫的介面用語,與規則文字中全大寫的 PROXY、DIRECT 屬於不同層級。Direct 能連線至某個目標,不代表代理參數正確;Proxy 測試成功,也不代表 Config 中的規則順序無誤。
介面與開關On Demand
On Demand 是依已設定條件觸發連線的機制,重點在於「何時建立連線」。Rule 則決定連線後「個別請求採用什麼策略」,兩者應分開檢查。手動關閉後又自動連線時,請先查看 On Demand 的觸發條件,並在目前網路環境下重新確認。
介面與開關Connectivity Test
Connectivity Test 依選定的測試方式檢查伺服器是否可連線,結果會受目前網路、測試目標與伺服器回應影響。顯示的耗時不能直接當成持續下載速度,也不保證所有網站都能連線。比較多個結果時,請維持相同的測試方式與網路條件,再以實際目標請求確認。
介面與開關Add Server / SERVER
Add Server 用來輸入使用者已有伺服器的協定、位址、連接埠與驗證資訊,SERVER 清單則顯示這些連線項目。儲存項目只代表資訊已輸入,不代表驗證或連線已成功。手動新增時,先確認協定類型,再檢查該協定所需的傳輸與安全參數,不要只憑名稱選擇類型。
介面與開關DNS
DNS 負責將網域名稱解析為 IP 位址,是建立許多網路連線前的步驟。網域解析路徑與後續請求的連線路徑需分開檢查,因此 DNS 失敗不一定代表代理伺服器無法連線。排查時先確認解析結果與錯誤訊息,再檢查設定檔中的 DNS 設定,避免同時修改多個解析選項。
辨識伺服器參數

協定

協定決定用戶端與伺服器如何通訊,不代表速度或穩定性的等級。以下術語僅供辨識使用者已有的連線資訊;實際支援項目與參數以目前 App 介面為準。

協定Shadowsocks
Shadowsocks 是一種代理協定,常見參數包括伺服器位址、連接埠、密碼與加密方法。加密方法必須與伺服器設定相符,密碼相同也無法彌補方法選錯。若使用者已有的資訊還包含額外傳輸設定,也需一併確認;不能只填入位址與密碼就認定設定完整。
協定VMess
VMess 是一種具備身分驗證機制的代理協定,連線通常需要使用者識別資訊與相應的傳輸參數。同一位址與連接埠可以使用不同傳輸方式,因此也需確認路徑、Host 與 TLS 等欄位。遇到驗證異常時,也可檢查裝置時間是否正確,而非反覆更改清單中的顯示名稱。
協定VLESS
VLESS 使用使用者識別資訊進行驗證,實際連線方式也取決於伺服器設定的傳輸與安全參數。VLESS 與 VMess 是不同協定,不能因欄位相似就互換類型。匯入後如需手動檢查,應依照已有的伺服器資訊逐項確認,不要直接套用其他協定的預設設定。
協定Trojan
Trojan 是一種通常搭配 TLS 使用的代理協定,連線時需正確設定驗證資訊與伺服器名稱。伺服器位址、TLS 使用的名稱與憑證涵蓋的名稱可能需分別確認。出現憑證錯誤時,應檢查名稱、有效期限與裝置時間,不宜將停用憑證驗證當成一般處理方式。
協定Hysteria2
Hysteria2 是一種以 QUIC 為基礎的代理協定,網路路徑需支援相應的 UDP 連線。驗證、TLS、混淆及頻寬相關參數應與使用者已有的伺服器資訊相符,具體欄位以 App 介面為準。協定名稱本身不保證速度;網路封包遺失、伺服器負載與參數設定都會影響實際效果。
協定WireGuard
WireGuard 透過金鑰組與對端設定建立加密通道,除了端點位址,也涉及通道位址與路由範圍等資訊。私密金鑰與對端公鑰用途不同,不能互換,也不應公開含有私密金鑰的設定。匯入後能否連線至目標,需一併考量對端允許的位址範圍與實際路由。
協定HTTP / SOCKS5
HTTP 與 SOCKS5 是兩種不同的代理連線協定,應依伺服器實際提供的類型選擇。是否需要使用者名稱與密碼、是否提供傳輸加密,應以具體服務參數為準,不能只憑協定名稱推斷。伺服器支援的請求類型與 UDP 能力也可能不同;一種請求測試成功,不代表其他請求也能使用。
比對條件與處理策略

規則關鍵字

規則依序由上而下比對,符合第一條規則後即採用其策略。以下網域與位址僅用於說明語法,不是可供連線的服務資訊。

規則關鍵字Rule
Rule 將比對條件與處理策略連結起來,通常寫在設定檔的 [Rule] 區段。使用 Config 模式時,請求會依序檢查規則,符合後便採用相應策略,不再繼續尋找看似更精確的後續規則。因此應先放例外或範圍明確的規則,再放較廣泛的條件,最後設定預設策略。
規則關鍵字DOMAIN
DOMAIN 精確比對完整網域名稱,不會自動涵蓋該網域的其他子網域。例如 DOMAIN,example.com,PROXY 會比對 example.com,但不會因此比對 www.example.com。若要涵蓋整個網域及其子網域,應考慮使用 DOMAIN-SUFFIX,而非逐一猜測所有子網域。
規則關鍵字DOMAIN-SUFFIX
DOMAIN-SUFFIX 會比對指定網域及其子網域,適合統一處理同一網域及其子網域。例如 DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 和 api.example.com,但不會比對任意含有 example.com 字樣的網域。若某個子網域需採用其他策略,應將該例外規則放在這條規則之前。
規則關鍵字DOMAIN-KEYWORD
DOMAIN-KEYWORD 會檢查網域名稱是否包含指定關鍵字,比對範圍通常比 DOMAIN 與 DOMAIN-SUFFIX 更廣。例如 DOMAIN-KEYWORD,example,PROXY 可能涵蓋多個互不相關、但都含有 example 的網域。只有確實需要廣泛比對時才使用,並留意是否會意外符合其他項目。
規則關鍵字GEOIP
GEOIP 依據 IP 地理位置資料庫判斷目標位址所屬區域,再採用指定策略。它判斷的是位址在資料庫中的分類,不是網頁語言、訪客所在地或服務是否可用。網域可能解析至分散各地的位址,資料庫分類也可能有差異;排查時應一併查看實際解析位址與符合的規則。
規則關鍵字IP-CIDR
IP-CIDR 依 IPv4 位址範圍進行比對,斜線後的前綴長度決定涵蓋範圍。例如 IP-CIDR,192.168.0.0/16,DIRECT 會為這段私有位址指定直連策略。網域請求是否會觸發解析以供比對,也與相關選項有關;修改前應先了解位址範圍,避免將單一位址誤設為過大的網段。
規則關鍵字IP-CIDR6
IP-CIDR6 依 IPv6 位址範圍進行比對,功能對應 IPv4 用的 IP-CIDR。例如 IP-CIDR6,::1/128,DIRECT 會比對 IPv6 迴路位址。若目標使用 IPv6 連線,只檢查 IPv4 規則不足以說明所有請求,還應一併確認解析結果與 IPv6 路由。
規則關鍵字FINAL
FINAL 為未符合前面條件的請求指定預設策略,通常放在規則末尾。例如 FINAL,DIRECT 表示其餘請求使用直連路徑,而 FINAL,PROXY 表示其餘請求使用代理路徑。FINAL 不會覆蓋已符合前面規則的請求;修改時應先確認未符合規則的流量預期要前往何處。
規則關鍵字PROXY / DIRECT / REJECT
PROXY、DIRECT 與 REJECT 是規則中常見的處理策略,分別表示使用代理路徑、直接連線與拒絕符合條件的請求。它們回答的是「符合規則後如何處理」,不是伺服器位址或比對條件。若範圍廣泛的 REJECT 規則排在前面,後續的 PROXY 規則就不會重新為已遭拒絕的請求選擇路徑。
規則關鍵字USER-AGENT
USER-AGENT 依 HTTP 請求中的 User-Agent 資訊進行比對,用來識別請求所宣告的用戶端特徵。能否生效取決於相關請求資訊是否可見,不能視為適用於所有流量的 App 識別方式。請求標頭也可能改變,因此不宜將它作為唯一的長期分流依據。
連線項目與檔案結構

訂閱與設定

匯入伺服器清單不等於匯入分流規則。請先辨認收到的是訂閱網址、單一連線項目還是設定檔,再選擇相應操作。

訂閱與設定Subscribe
Subscribe 用來透過使用者已有的訂閱網址匯入或更新伺服器項目;網址應向使用者自己的服務供應商取得。訂閱連結可能包含存取憑證,應妥善保管;分享截圖時也要遮蔽完整連結。更新訂閱通常只會處理伺服器清單,不能據此推斷目前設定檔中的 Rule 也已更新。
訂閱與設定Server
Server 是包含連線端點、協定與驗證參數的伺服器紀錄,中文說明中也常稱為節點。清單中的名稱供辨識使用,可能與實際伺服器位址不同;名稱本身無法證明地理位置或連線品質。排查時應查看實際參數,並區分項目是手動新增還是透過訂閱更新,以免更新時覆蓋手動修改。
訂閱與設定.conf
.conf 是 Shadowrocket 設定檔常用的副檔名,檔案可包含 [General]、[Rule]、[Host] 與 [URL Rewrite] 等區段。它描述全域參數、分流條件或請求處理方式,不等同於伺服器訂閱清單。修改前請保留原始檔,選用修改後的設定檔,並在 Config 模式下逐項測試。
訂閱與設定Host
[Host] 區段用於設定本機網域對應,讓指定網域使用設定的解析結果。它改變的是「網域對應到哪個位址」,而不是「請求採用哪種策略」;後續仍需依實際路由設定處理。伺服器項目中的 Host 欄位可能表示傳輸請求所用的主機名稱,應依欄位所在位置判別,不要將兩者視為相同的設定入口。
訂閱與設定URL Rewrite
URL Rewrite 依比對條件處理請求網址,與決定代理或直連路徑的 Rule 是不同功能。改寫能否生效,取決於比對運算式、處理方式,以及 App 是否能讀取相關請求資訊。設定前應確認目標網址與預期結果,只套用在明確了解的請求上;遇到異常時,可先停用新增項目進行比對。
正版取得管道與購買紀錄

帳號與購買

App 購買、伺服器服務與本機設定分別管理。購買與還原相關操作應以 App Store 目前顯示的資訊為準;取得 App 的權益不等於設定備份。

帳號與購買App Store 正版驗證
Shadowrocket 僅於 Apple 平台發行,唯一取得管道是 App Store。驗證時請同時確認官方圖示、開發者 Shadow Launch Technology Limited,以及產品頁網址中的 App ID 932747118,不要只憑同名搜尋結果判斷。iPhone、iPad 與其他相容裝置的系統需求及購買範圍,以 App Store 頁面標示為準。
帳號與購買一次性買斷
一次性買斷是指一次性購買用戶端 App 本身;Shadowrocket 是閉源商業 App。用戶端一次性買斷 ≠ 連線方案;購買 App 不會自動取得伺服器、訂閱或相關服務的使用額度。實際價格與幣別以 App Store 購買確認頁面為準,連線所需資訊須由使用者自行持有。
帳號與購買已購項目
已購項目是 App Store 中查找購買紀錄並重新取得 App 的入口;更換裝置或重新安裝時,應先確認目前使用的購買帳號。還原 App、伺服器資訊與設定檔是不同事項;重新取得 App 不代表原有設定一定會一併還原。相容性、通用購買與家人共享的適用範圍,以 App Store 頁面標示為準。

需要確認產品頁與購買步驟時,請前往App Store 正版驗證說明;需要依實際操作順序閱讀時,請接著查看Shadowrocket 教學。