官方手冊 · 名稱與意義

Shadowrocket 術語表

先釐清介面選項、協定、比對條件與執行策略,再閱讀設定。以下保留英文原文,說明各名稱在 Shadowrocket 中的用途,以及不能單憑名稱推斷的內容。

Interface

介面與開關

頁面名稱代表操作入口,不表示連線已成功。排查問題時,應分別確認目前選項、連線狀態與實際要求結果。

介面與開關

Home

Home 是集中查看伺服器項目與連線入口的頁面。清單中有項目,只代表資訊已儲存,不表示該項目目前可用或 VPN 已建立。初次使用時,請先確認選取的項目與 Global Routing,再啟動連線,避免混淆清單選取狀態與實際連線狀態。

介面與開關

Global Routing

Global Routing 決定整體流量處理方式;介面中的 Config、Proxy、Direct 分別代表設定、代理與直連。Config 依目前設定處理流量,Proxy 與 Direct 則分別採用整體代理及整體直連方式。排查規則未生效時,請先確認此處的選項;修改 Rule 無法取代整體模式設定。

介面與開關

On Demand

On Demand 會依據已設定的條件觸發 VPN 連線,不是用來指定各網域的連線目的地。它與分流規則屬於不同層次,也不會補上伺服器缺少的驗證參數。如果手動關閉連線後又自動觸發,請檢查目前啟用的 On Demand 條件,再判斷是否需要調整。

介面與開關

Add Server

Add Server 是手動輸入使用者既有伺服器資訊的入口。請先選擇相符的協定,再逐一填入位址、連接埠與驗證資訊;傳輸方式和 TLS 選項也須與伺服器端一致。儲存成功只代表表單已接受,之後仍須測試連線,不可將任意一組參數直接套用到其他協定。

介面與開關

Connectivity Test

Connectivity Test 會依目前的測試方式檢查項目的連線能力,延遲數值反映特定條件下的回應時間。這不是持續下載速度,也不代表所有網站或 App 的要求都能成功。比較結果時,請使用相同的測試方式與網路環境;單次逾時還須搭配 DNS、驗證與目標位址等項目繼續排查。

介面與開關

Data

Data 用於查看流量統計,解讀數據時須考量所選畫面、統計期間與目前連線狀況。上傳與下載方向不同,以伺服器或 App 為觀察對象,彙總方式也可能不同。數值為零時,請先確認要求是否經過正在觀察的連線,不要只憑統計數字判斷服務是否正常。

介面與開關

DNS

DNS 是將網域名稱解析為 IP 位址的機制,通常會在建立目標連線前進行。網域名稱能解析,不代表目標服務一定連得上;解析失敗也不代表伺服器密碼錯誤。排查時應區分解析階段與連線階段,並依目前設定中的 DNS 選項判斷,不要同時修改多個無關選項。

Protocols

協定

協定規定用戶端與伺服器的通訊方式,不會決定規則的比對順序。以下說明以使用者已有自己的伺服器資訊為前提,請依伺服器端的實際設定核對參數。

協定

Shadowsocks

Shadowsocks 使用約定的加密方式與密碼建立代理連線。用戶端的加密方式、密碼、伺服器位址與連接埠都必須與伺服器端一致,不能只因名稱相同就判定相容。如果既有資訊還包含外掛程式或其他傳輸參數,也須核對相應欄位;修改加密方式本身無法修正位址填寫錯誤。

協定

VMess

VMess 使用使用者識別碼等參數進行驗證,連線資訊也可能包含傳輸方式與 TLS 設定。識別碼正確不代表連線參數完整,主機名稱、路徑等欄位也可能影響連線。匯入後請確認各欄位與原始資訊一致,不要將協定、傳輸方式與安全層視為同一項設定。

協定

VLESS

VLESS 使用使用者識別碼進行驗證,實際連線也取決於傳輸層與安全層參數。名稱相近的協定不能直接互換;既有伺服器採用哪種協定,就應選擇相符的類型。連線失敗時,請分別核對使用者識別碼、傳輸方式與安全設定,不能只因其中一項已填妥就認定整筆資料正確。

協定

Trojan

Trojan 通常搭配 TLS 建立連線,並以密碼完成驗證。除了位址和連接埠,也須核對密碼、TLS 使用的主機名稱與憑證是否相符。憑證錯誤與驗證失敗是不同問題;請先確認主機名稱和憑證設定正確,不要把略過憑證驗證當作一般處理方式。

協定

Hysteria2

Hysteria2 是以 QUIC 為基礎的代理協定,連線須具備 UDP 可連通性,並正確設定驗證與 TLS 參數。協定名稱本身不保證速度,實際表現須在不同網路環境中測試。排查時請先確認既有伺服器使用的確實是 Hysteria2,再核對連接埠、驗證資訊、主機名稱,以及目前網路是否支援 UDP。

協定

WireGuard

WireGuard 使用公鑰與私鑰建立加密通道,設定中通常須區分本端與對端資訊。對端公鑰、端點位址、通道位址及允許的路由範圍各有用途,不能互相取代。私鑰是敏感憑證,提供排查資料時請先移除;即使通道已建立,仍須確認路由與 DNS 符合預期。

協定

HTTP / SOCKS5

HTTP 與 SOCKS5 是兩種不同的代理協定,輸入資料時請選擇伺服器實際支援的類型。協定名稱本身不代表所有通訊都經過加密;代理連線的保護方式與目標網站使用的 HTTPS 須分別理解。若伺服器端要求使用者名稱與密碼,請完整填入,不能因位址和連接埠正確就省略驗證。

Rules & Policies

規則關鍵字與策略

規則先描述比對對象,再指定符合條件後的動作。順序會影響結果:通常符合第一條規則後即停止;較具體的規則應排在涵蓋範圍較廣的規則之前,FINAL 則放在最後。

規則關鍵字與策略

Rule

Rule 指設定中的規則區段;文字設定檔以 [Rule] 標示該區段。規則通常由上而下檢查,符合條件後便採用該條指定的策略,不再繼續比對後續的一般規則。修改前請先確認目前使用的 Config,並保留原始設定;只編輯未啟用的檔案,不會改變目前要求的處理方式。

規則關鍵字與策略

DOMAIN

DOMAIN 用於比對完整網域名稱,例如 DOMAIN,example.com,DIRECT 僅表示比對該網域。它不會自動涵蓋所有子網域;子網域須另設條件,或改用適合的後綴規則。網域欄位不應填入含路徑的完整網頁網址,否則比對對象便不符合規則類型。

規則關鍵字與策略

DOMAIN-SUFFIX

DOMAIN-SUFFIX 依網域後綴比對,通常同時涵蓋指定網域及其子網域。例如 DOMAIN-SUFFIX,example.com,PROXY 可用來說明涵蓋範圍,但它不是在任意網址字串中搜尋相同文字。若要讓特定子網域採用不同策略,請將更具體的 DOMAIN 規則排在此規則之前。

規則關鍵字與策略

DOMAIN-KEYWORD

DOMAIN-KEYWORD 會檢查網域是否包含指定關鍵字,涵蓋範圍通常比精確網域或後綴規則更廣。較短的詞可能出現在多個無關網域中,因此不適合取代已知的精確網域條件。若某條規則意外影響其他要求,請檢查關鍵字的涵蓋範圍及其在 Rule 中的位置,再決定是否縮小條件。

規則關鍵字與策略

IP-CIDR / IP-CIDR6

IP-CIDR 與 IP-CIDR6 分別依 IPv4、IPv6 網段比對目標位址;斜線後的前綴長度決定網段範圍。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示一項 IPv4 網段條件。這兩者比對的是位址,不是網域文字;是否需要先解析,還須依規則參數與目前的 DNS 行為判斷。

規則關鍵字與策略

GEOIP

GEOIP 依據 IP 地理資料庫中的地區歸屬比對目標位址,例如 GEOIP,CN,DIRECT。它不會分析網頁內容、網域後綴或使用者所在位置;資料庫中的地區歸屬也可能與實際服務部署位置不同。若已知網域須固定採用特定策略,可使用更具體的網域規則,並將其排在 GEOIP 之前。

規則關鍵字與策略

FINAL

FINAL 是前面的規則都未符合時採用的預設規則,應放在 Rule 區段最後。例如 FINAL,PROXY 表示將其餘要求交由 PROXY 策略處理。FINAL 不會再次覆寫前面規則的結果,也不保證代理連線可用;若提早放置,後續規則就無法發揮預期的比對作用。

規則關鍵字與策略

PROXY / DIRECT / REJECT

PROXY、DIRECT、REJECT 是規則中的策略名稱,分別表示交由代理策略處理、直接連線與拒絕要求。這些全大寫關鍵字與 Global Routing 中的 Proxy、Direct 介面選項屬於不同層次。PROXY 不包含特定伺服器的驗證資訊,DIRECT 也不等於關閉整個 VPN;實際動作仍須配合目前模式與設定判斷。

Subscribe & Config

訂閱與設定

訂閱主要用於管理連線項目,設定則主要描述處理方式。匯入、儲存、選取與實際啟用是不同操作,請分別確認結果。

訂閱與設定

Subscribe

Subscribe 透過使用者既有的訂閱網址匯入或更新伺服器項目,內容取決於該網址傳回的結果。更新可能新增、修改或移除項目,因此更新前後請確認目前選取的項目仍然存在。匯入訂閱不等於匯入完整的分流設定;連結可能含有存取憑證,排查時請勿公開完整網址。

訂閱與設定

SERVER

SERVER 表示由連線目標及其參數組成的伺服器項目,通常包含協定、位址、連接埠、驗證與傳輸設定。項目的顯示名稱只是方便辨識的標籤,不能證明實際部署位置或連線能力。檢查使用者既有資訊時,請以具體欄位為準,並區分手動建立的項目與由訂閱管理的項目,避免更新後誤判修改結果。

訂閱與設定

Config

Config 既是儲存與選取設定的介面名稱,也是 Global Routing 中選擇依設定處理流量的選項。設定檔可包含 General、Rule 等區段,用來描述不同層面的行為。檔案已儲存不代表已選取;選取檔案後也須配合 Global Routing 判斷。排查時請先確認目前實際啟用的是哪份設定。

訂閱與設定

URL Rewrite

URL Rewrite 依比對運算式改寫要求網址等內容,與決定連線目的地的路由規則不同。能否處理特定要求,取決於比對範圍及要求是否符合相應處理條件;不能只因規則存在就認定已執行。修改前請先了解運算式與替換目標;涉及加密要求時,也須另行核對相關處理條件。

App Store

App Store 與購買

購買 App、裝置相容性與連線資訊須分別核對。Shadowrocket 是閉源商業 App,商店中的購買紀錄不包含使用者的伺服器設定。

App Store 與購買

App Store

App Store 是 Shadowrocket 唯一的購買與安裝管道,主要使用裝置為 iPhone 與 iPad。Mac、Apple TV、Apple Vision 的相容性也可在同一產品頁查看;系統需求及購買適用範圍一律以 App Store 頁面標示為準。本網站的取得 App 說明整理了核對步驟。

App Store 與購買

正版辨識

確認是否為正版時,請一併核對官方圖示、開發者 Shadow Launch Technology Limited,以及 App ID 932747118。可在產品頁網址中確認 id932747118,不要只憑搜尋結果中相似的名稱判斷。官方圖示應與本站頁首使用的圖示一致,三項資訊都須確認。

App Store 與購買

已購項目

已購項目是查找 App 購買紀錄並重新下載的入口,請使用購買時的 Apple ID 查看。重新下載 App 與還原 App 內設定是兩件事;伺服器項目與設定內容仍須透過自己的備份或既有資訊還原。找不到紀錄時,請先確認購買帳號與商店狀態;詳細還原方式請參閱已購項目還原說明。

App Store 與購買

一次買斷

一次買斷是指一次付費購買 App 本身;美國 App Store 售價為 $2.99,實際價格以 App Store 頁面為準,各商店會以當地貨幣顯示。一次買斷 App ≠ 購買連線方案;購買 App 不會自動產生可用的伺服器資訊。連線前仍須匯入使用者既有的訂閱或伺服器參數,購買適用範圍以商店頁面標示為準。