OFFICIAL MANUAL / GLOSSARY

Shadowrocket 術語手冊

依介面位置與設定用途查找詞彙。先分清連線開關、路由模式與規則策略,再對照使用者已有的伺服器資訊核對參數。

  • 31 個術語項目
  • 介面用語保留英文原文
  • 規則範例使用 example.com

01 / INTERFACE

介面與開關

先確認目前操作的是哪個頁面。連線是否開啟、請求採用哪條路徑,以及是否依條件自動連線,是三個不同的問題。

Home
在 Home 查看伺服器項目,選擇使用者已有的伺服器後,再操作連線開關。開啟開關表示用戶端開始建立或維持連線,不代表所有目標請求都已成功。首次使用時,應先檢查項目參數,再測試連線與存取。
Global Routing
在 Home 開啟 Global Routing,選擇 Config、Proxy 或 Direct,以決定整體流量的處理方式。此選項會影響請求如何進入規則或代理路徑,不會變更伺服器位址與密碼。排查存取差異時,應記錄目前的模式,避免將切換模式後的結果誤認為伺服器參數有所變動。
Config / Proxy / Direct
在 Global Routing 中,設定對應 Config,代理對應 Proxy,直連對應 Direct。Config 依目前設定中的規則處理請求;Proxy 使用所選的代理路徑;Direct 則直接連線至目標。選擇 Config 前,請確認已啟用所需設定;選擇 Proxy 也仍需有可用的伺服器資訊。
On Demand
在相關設定中設定 On Demand 後,系統可依指定網路條件觸發連線行為。此功能處理的是何時連線,而非特定網域應採用哪種策略。若連線關閉後又被觸發,請先核對 On Demand 條件,再判斷是否有連線異常。
Data
在 Data 查看用戶端記錄的流量統計,觀察連線後的資料活動。統計範圍、起算時間與重設方式應依目前頁面顯示判讀。服務商端的計費方式可能不同,因此此處的數字不應直接視為帳戶剩餘用量。
Settings
在 Settings 尋找用戶端行為相關的設定項目,實際名稱與可用選項請以目前的 App 介面為準。修改前先記錄原值,每次只調整一個相關選項,並在相同網路下重新測試。不要只因名稱相似,就將全域設定與單一伺服器的參數視為同一項。

02 / PROTOCOLS

協定

在 Add Server 選擇與使用者既有參數相符的協定類型。協定名稱決定欄位的意義,不能只複製 Address 與 Port 後任意切換類型。

Shadowsocks
在 Add Server 選擇 Shadowsocks,再依既有資料填入位址、連接埠、加密方式與密碼。雙方必須使用相符的參數;即使密碼正確,加密方式不同也會影響連線。它是代理協定名稱,不是某個特定伺服器或設定檔的名稱。
VMess
在 VMess 項目中核對伺服器位址、連接埠、使用者識別碼及傳輸相關欄位。使用者識別碼與傳輸設定須與伺服器端一致;若啟用 TLS,還要檢查相應的名稱與憑證資訊。成功匯入只代表項目已辨識,不能取代實際連線測試。
VLESS
在 VLESS 項目中依既有資料填入使用者識別碼與傳輸參數,不要套用其他協定的驗證欄位。VLESS 本身不提供完整的傳輸加密,連線安全也取決於所選傳輸方式與 TLS 等設定。遇到交握失敗時,應分別核對驗證資訊與傳輸資訊。
Trojan
在 Trojan 項目中填入位址、連接埠與密碼,並核對 TLS 相關參數。Trojan 透過 TLS 傳輸,SNI 與憑證名稱不符可能導致連線在交握階段失敗。若出現憑證錯誤,應先檢查名稱、裝置時間與憑證狀態,而不是直接略過驗證。
Hysteria2
在協定類型中選擇 Hysteria2,再填入既有的驗證與 TLS 參數。它以 QUIC 為基礎,底層依賴 UDP,因此目前網路能瀏覽一般網頁,並不代表此連線路徑一定可用。排查時先核對協定類型與參數,再比較不同網路下的狀況。
WireGuard
在 WireGuard 設定中核對本機私密金鑰、Peer 公開金鑰、端點與位址範圍等資訊。私密金鑰與對端公開金鑰的用途不同,不可互換填入;Allowed IPs 也不是網域清單。私密金鑰屬於敏感資訊,分享排查資料時應先移除,不可放入公開截圖或筆記。
HTTP / SOCKS5
在 Add Server 依既有服務的實際類型選擇 HTTP 或 SOCKS5,再核對驗證方式。兩者是不同的代理連線協定,是否加密傳輸、是否支援 UDP,都須視具體設定與服務能力而定。不能只因位址和連接埠相同,就認為兩種類型可以互換。

03 / RULE KEYWORDS

規則關鍵字

先看比對條件,再看處理策略。以下片段僅示範語法,其中 PROXY 須與實際設定中可用的策略引用一致。

規則
在目前設定的規則區段查看比對條件與策略;只有在 Global Routing 選擇 Config 時,才會依該設定分流。規則通常由上而下檢查,較寬泛的條件若排在前面,可能會先行涵蓋後續項目。調整規則後,應先儲存並確認正在使用修改後的設定,再以相同目標測試。
DOMAIN
在規則中使用 DOMAIN,example.com,PROXY,表示比對完整網域名稱後交由指定策略處理。此處比對的是網域名稱,不包含 URL 路徑,也不會自動涵蓋所有子網域。若要涵蓋子網域,請確認 DOMAIN-SUFFIX 是否更符合所需範圍。
DOMAIN-SUFFIX
在規則中使用 DOMAIN-SUFFIX,example.com,PROXY,可比對 example.com 及其子網域。它依網域後綴邊界判斷,不是任意搜尋整段 URL。設定前應確認要涵蓋的網域範圍,避免將路徑或協定前綴寫入比對值。
DOMAIN-KEYWORD
在規則中填入 DOMAIN-KEYWORD 與指定字串,即可比對網域名稱中包含該字串的請求。其涵蓋範圍比完整網域比對更廣,可能命中名稱相近但並非目標網站的網域。若只想處理特定網域,應優先考慮更精確的條件。
GEOIP
在規則中使用 GEOIP,CN,DIRECT,表示依據 IP 地理資料庫中的歸屬紀錄決定策略。判斷依據是目標 IP,不是網頁語言,也不是訪客所在地。資料庫紀錄可能與服務實際部署狀況不同;發生異常時,應一併檢查解析結果與命中的規則。
IP-CIDR / IP-CIDR6
在規則中使用 IP-CIDR 比對 IPv4 位址範圍,使用 IP-CIDR6 比對 IPv6 位址範圍。CIDR 中斜線後的數字表示網路前綴長度,不是連接埠。填寫前應確認目標位址所屬範圍;前綴設定過寬,可能改變大量無關請求的路徑。
FINAL
在規則清單末尾查看 FINAL,例如 FINAL,PROXY 表示前面的規則都未命中時採用相應策略。這是兜底處理,不會重新測試所有伺服器,也不會自動挑選回應最快的項目。若大量請求都落入 FINAL,應先確認前面的規則是否涵蓋預期目標。
PROXY / DIRECT / REJECT
在規則末尾查看策略標記:DIRECT 表示直接連線,REJECT 表示拒絕,PROXY 則應依目前設定中的引用關係確認。PROXY 不是伺服器位址,也不是固定的一組連線參數。路由模式 Proxy 與規則標記 PROXY 屬於不同層級,不應只因拼寫相近就視為同一設定。

04 / SUBSCRIPTION & CONFIG

訂閱與設定

以下操作皆以使用者已有自己的訂閱或伺服器資訊為前提。本網站提供官方手冊,不提供、不販售也不推薦節點或訂閱服務。

訂閱 / Subscribe
在相應的匯入入口使用 Subscribe,填入使用者已有的訂閱網址以取得伺服器項目。訂閱網址指向可更新的資料來源,更新後項目名稱、數量或參數可能隨來源內容變動。連結通常包含帳戶識別資訊,應完整保存並妥善保密;匯入後還需選擇伺服器、核對路由模式並測試連線。
伺服器 / Add Server
在 Add Server 選擇協定,再填入 Address、Port 及該協定所需的驗證參數。此處的伺服器項目是一組連線資訊,不等同於規則設定。通常只輸入網域名稱與連接埠仍不足以完成設定;缺少的欄位應向使用者自己的服務商確認。
Config
在 Config 頁面管理及啟用設定檔;檔案可包含規則、DNS 等設定。Global Routing 中的 Config 則表示依目前設定處理流量,兩者名稱相同但用途不同。切換設定前,先記錄原本啟用的檔案,並確認新檔案中的策略引用能對應現有的伺服器選擇。
Scan QR Code
在 Scan QR Code 入口讀取使用者已有 QR Code 中的連線資訊,必要時依系統提示允許存取相機。QR Code 是資料載體,內容可能是單一伺服器連結,也可能是訂閱網址;匯入後應逐項核對。含有驗證資訊的 QR Code 同樣屬於敏感資料,不宜公開轉傳。
用戶端一次性買斷
在 App Store 購買 Shadowrocket,取得的是用戶端授權;用戶端一次性買斷 ≠ 線路方案。購買不會自動建立伺服器、訂閱網址或驗證參數,既有設定仍需自行匯入。Shadowrocket 是閉源商業 App,系統需求、相容性及一般購買適用情況請以 App Store 頁面標示為準;購買前可先查看正版查驗說明。

05 / DNS & NETWORK

DNS 與網路

將網域解析、協定交握與目標存取分開檢查。單次測試結果只能反映當時、以目前測試方式測得的狀況。

DNS
在目前設定的 DNS 相關選項中查看解析方式。DNS 的作用是將網域名稱轉換為 IP 位址。網域無法解析與代理伺服器無法連線屬於不同環節,應分別檢查。解析結果也可能影響後續 IP 類規則判斷,因此變更 DNS 後,應一併觀察解析結果與規則命中狀況。
DNS over HTTPS
在支援的 DNS 設定中填入 DNS over HTTPS 服務網址,即可透過 HTTPS 傳送解析查詢。它保護的是查詢傳輸過程,不代表所有 App 資料都會改走同一條代理路徑。解析服務本身仍須可連線;若發生逾時,應檢查服務網址、連線路徑與相關規則,而不是反覆變更多項設定。
Connectivity Test / 延遲
在 Connectivity Test 執行測試,結果反映目前測試方式下的回應狀況。延遲數值不等於下載速度,測試成功也不代表每個網域或每種連線方式都可用。比較結果時應維持相同的網路、測試方式與目標,並以實際需要存取的服務繼續驗證。
TLS / SNI
在伺服器的 TLS 相關欄位中核對 SNI;SNI 用於交握時標示目標伺服器名稱。TLS 負責保護傳輸並透過憑證驗證對端身分,連線 Address 與憑證名稱不一定相同,但必須符合伺服器端的實際部署。若憑證錯誤,應優先核對名稱、有效期限與裝置時間,不應將略過驗證當作一般解決方式。
MTU
在相關協定設定中查看 MTU,它表示網路介面傳輸單一封包的大小上限。部分路徑上的數值不合適,可能導致分片或部分請求停滯,但網頁無法開啟不一定是 MTU 所致。調整前先記錄原值,排除驗證、DNS 與路由問題後,再一次變更一個數值並重新測試。

需要依操作順序閱讀時,請前往完整使用手冊;需要確認購買入口時,請前往App Store 正版查驗。