OFFICIAL MANUAL · 功能參考

Shadowrocket 功能與設定
路由、連線與診斷

先決定流量的處理方式,再檢查伺服器與設定,最後調整自動連線、DNS 和測試項目。每次只變更一項,並以相同目標重新測試,方便判斷設定是否生效。

01 · GLOBAL ROUTING

三種模式,先選處理範圍

Global Routing 的模式選擇與伺服器選擇是兩回事。選取伺服器,不代表所有請求都會經過該伺服器。

功能與位置:Global Routing 是 Home 中的全域路由入口,提供 Config、Proxy、Direct 三種模式。中文可分別理解為設定、代理、直連,但操作時請以英文介面名稱為準。Config 依目前設定中的規則處理流量;Proxy 將由用戶端接管的請求交由代理策略處理;Direct 則讓接管的請求直接連線至目標。三者決定的是處理方式,而非伺服器是否可用。

介面模式處理方式適用情況優先檢查
Config · 設定依目前設定中的規則與策略分流。需要讓部分目標走代理、部分目標直連時。啟用中的設定、規則順序、策略引用。
Proxy · 代理將接管的請求交由代理處理。暫時確認代理連線,或需要統一透過代理處理時。所選伺服器、協定參數、目標是否可連線。
Direct · 直連讓接管的請求直接連線至目標。需要直連,或比對代理連線路徑時。目前網路本身能否連線至目標。

設定方式:在 Home 開啟 Global Routing,依需求選擇模式,再返回確認目前伺服器。日常已有明確分流規則時使用 Config;排查特定目標時,可先記下原本模式,再暫時切換至 Proxy 或 Direct,以相同目標比較結果。測試後恢復原設定,避免將暫時的排查狀態當成長期設定。

注意事項:Direct 不代表關閉用戶端連線,Proxy 也不保證目標一定可連線。即使已選取伺服器,請求仍可能依規則走 DIRECT 或遭 REJECT。切換模式後若結果不同,請先檢查規則與 DNS,不要立即認定是協定問題。首次連線步驟請參閱Global Routing 教學。

02 · RULES & POLICIES

規則與分流,比對對象與執行策略

規則決定「比對哪個請求」,策略決定「命中後如何處理」。兩者都要一併檢查。

比對類型:從網域到 IP

DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對網域本身及其子網域;DOMAIN-KEYWORD 比對網域中的關鍵字。IP-CIDR 與 IP-CIDR6 用於比對 IP 網段;GEOIP 則依 IP 地理資料庫的結果比對。USER-AGENT 依賴請求中可取得的相關資訊,不能視為通用的 App 辨識規則。

DOMAIN,www.example.com,PROXY
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

基本策略:明確指定請求去向

PROXY 透過代理處理,DIRECT 直接連線,REJECT 拒絕請求。FINAL 是前面的規則都未命中時使用的備援規則,不是第四種策略。設定也可能引用具名策略群組,此時還要檢查群組內的選擇,不能只因規則命中就認定連線路徑已確定。

位置與設定方式:在 Config 確認目前啟用的設定,再進入相應設定的編輯畫面查看 Rule 區段。先保存可還原的副本,再新增適用範圍明確的規則;優先比對的具體規則應放在範圍較廣的規則之前,FINAL 則放在最後。儲存後使用 Config 模式測試,並在可用的連線記錄中確認命中規則與最終策略。

注意事項:規則通常依序比對,前面的規則一旦命中,後續較具體的規則可能就不會執行。範例中的 example.com 僅用來說明語法,並非連線服務。IP 類規則也可能涉及網域解析;網域規則與 IP 規則的結果不一致時,應一併檢查解析結果。完整設定結構請參閱設定檔參考。

03 · SERVER MANAGEMENT

訂閱與伺服器,分別管理來源與參數

訂閱用於管理一組伺服器資訊;設定檔則用於管理規則及其他設定。匯入其中一項,不代表另一項也已完成。

使用現有資訊建立連線項目

功能與位置:Home 顯示可選取的伺服器與訂閱群組。Add Server 用於新增連線資訊,Subscribe 用於訂閱類型,Scan QR Code 可讀取現有資訊的 QR Code。不同匯入方式只是輸入途徑不同,最後仍須取得完整且與伺服器端一致的連線參數。

設定方式:已有訂閱時,在 Add Server 選擇相應類型並填入自己的訂閱網址,確認後儲存並更新;若已有單一伺服器資訊,則依協定填寫位址、連接埠與驗證參數。返回 Home 後展開對應群組,選取要使用的項目。先執行 Connectivity Test,再嘗試連線至實際目標,避免只憑名稱判斷連線是否正常。

更新時的處理方式:更新訂閱會重新取得該來源的伺服器清單,無法修復伺服器端本身的故障。更新前先確認訂閱網址仍有效;更新後重新檢查目前選取的項目,因為項目名稱、參數或清單範圍可能有所變動。由訂閱管理的項目可能在下次更新時被覆蓋,長期修改前應先確認其來源。

注意事項:訂閱網址可能包含存取憑證,截圖、同步或提交診斷資料前,應移除完整連結與敏感參數。不同協定的欄位不要混填,也不要把伺服器位址當成訂閱網址。訂閱匯入的完整操作步驟請參閱訂閱教學;已有設定的啟用方式請參閱設定檔章節。

04 · PROTOCOL PARAMETERS

協定支援,以參數一致為前提

協定名稱相同只是第一步。驗證、傳輸與 TLS 相關參數也必須符合自己的伺服器資訊。

協定 · Add Server

WireGuard

功能與位置:WireGuard 是一種以金鑰為基礎的隧道協定,可在相應的伺服器類型中設定。其金鑰、位址與對端資訊各有用途,不能用其他協定的帳號密碼代替。

設定方式:依據現有的 WireGuard 設定,檢查本機 Private Key、位址、對端 Public Key 與 Endpoint 等資訊;原始設定若還包含其他參數,也應逐項對照。匯入後確認位址與路由相關欄位,不要只確認 Endpoint 已填寫。

注意事項:Private Key 屬於敏感資訊。若握手或連線失敗,先檢查金鑰配對、Endpoint、網路是否可連線至 UDP,以及位址設定;排查時不要公開完整設定。Global Routing 與 App 規則仍須另行確認。

協定 · Add Server

VMess

功能與位置:VMess 是其中一種伺服器類型。連線資訊除了位址與連接埠,也包含 UUID 及相應的傳輸設定;實際需要哪些欄位,取決於自己的伺服器設定。

設定方式:在 Add Server 選擇 VMess,依現有資訊填寫並確認 UUID。若使用 WebSocket 或 TLS,還要逐項確認相應的 Host、Path 與 Server Name 等欄位。這些欄位的值可能各不相同,請依伺服器端設定原樣填寫。

注意事項:系統時間異常可能影響驗證;參數不一致也可能造成連線逾時。遇到錯誤時,先核對原始資訊與裝置時間,不要為了消除錯誤而任意關閉憑證驗證。成功匯入只表示資訊已讀取,不代表連線已通過驗證。

Shadowsocks、VLESS、Trojan、HTTP、SOCKS5 與 Hysteria2 等類型,也應依相同順序檢查:先確認協定,再確認位址與連接埠,最後檢查驗證、傳輸及 TLS 相關欄位。不同協定所需參數不盡相同,也不是每個入口都適用於所有類型。編輯時請以 App 目前顯示的欄位及自己的伺服器說明為準,不要猜測補上缺少的資訊。

05 · ON DEMAND

On Demand,依條件觸發連線

先確認手動連線正常,再啟用自動連線條件。自動化無法取代正確的伺服器與規則設定。

先檢查條件,再確認連線行為

功能與位置:On Demand 可依設定條件觸發系統的 VPN 連線行為。請透過 Settings 中的 On Demand 入口檢查可用選項;是否顯示網路類型、SSID 等條件,以及如何設定,請以 App 目前的畫面為準。On Demand 與 Global Routing 的用途不同:前者決定何時連線,後者決定連線後如何處理請求。

設定方式:先關閉自動觸發,手動連線並確認自己的伺服器與 Config 可正常使用。接著進入 On Demand,從範圍明確的條件開始設定。儲存後切換至符合條件的網路,觀察系統連線狀態,再確認目標連線與策略是否符合預期。需要新增其他條件時,逐項加入並分別測試。

注意事項:多個條件可能重疊,條件順序或動作設定也可能影響結果。若手動中斷連線後又自動連上,請先檢查 On Demand 是否仍在觸發,不要反覆新增系統設定。排查時記錄目前網路、條件與預期動作;暫時停用 On Demand 後再次測試,有助於區分自動連線行為與一般連線故障。

06 · DATA

Data,檢視流量,不推測計費

流量統計有助了解連線活動,但不能取代服務供應商或系統的計量方式。

功能與位置:Data 顯示用戶端記錄的流量資訊。進入 Data 後,先確認目前畫面的統計範圍與單位,並區分上傳、下載,以及頁面實際提供的時間或連線維度。統計數值反映用戶端記錄的活動,不應直接解讀為訂閱的剩餘用量。

使用方式:要確認某項操作的結果時,先記下測試前的數值,再連線至明確的目標,之後返回查看變化。若目前介面提供重設功能,請先了解其影響再使用,並自行記錄重設時間。搭配連線記錄與 Global Routing 一併檢視,才能判斷這次活動是否符合預期。

注意事項:背景同步、網頁資源與系統請求都可能造成流量變化。數值增加本身無法證明目標連線採用了預期策略,也無法證明請求內容已正確傳回。統計範圍、連線額外流量與其他計量工具可能不同;排查連線問題時,應優先檢查特定請求及其比對結果,而非只比較總流量。

07 · SETTINGS

常用設定,每次只調整一項

以下依功能名稱定位。部分設定也可能由目前的 Config 控制,修改前請先確認生效來源。

DNS:先確認解析路徑

功能與位置:DNS 會將網域名稱轉換為連線所需的位址。先查看 Settings 中的 DNS 相關入口,同時檢查目前 Config 的 General、Host 等相關設定,避免只修改一處,卻忽略設定檔中的定義。

設定方式:先記下原始值,確認所選的解析服務在目前網路中可連線,再修改相應設定。使用相同網域重新測試,並搭配解析結果、規則命中情況與目標連線一併判斷。若目前設定已指定 DNS,請先釐清其適用範圍。

注意事項:直接連線至 IP 成功、以網域連線卻失敗,可能與解析有關,但仍須檢查 TLS 等因素。不要頻繁更換 DNS 來掩蓋規則錯誤;Host 中已有的對應設定也可能影響最終結果。

Test Method:統一測試方式

功能與位置:Settings 中的 Test Method 用來選擇連線測試方式。它會影響 Connectivity Test 如何檢查伺服器,但不會替你修改協定參數或 Global Routing。

設定方式:依目前介面提供的選項選擇測試方式;若該方式提供測試目標等附加項目,請確認目標本身可連線。比較多個項目時,請維持相同測試方式與網路;必要時重複測試,以降低偶發波動的影響。

注意事項:測試成功不代表所有網站都能連線,測試失敗也須搭配測試方式判斷。握手可連線性、網頁回應與實際傳輸速度是不同指標。若要繼續排查,請參閱連線問題說明。

Today Widget:快速查看與操作

功能與位置:Today Widget 是系統元件的相關入口,可在 Settings 中確認其提供的內容與選項。系統是否提供相應的加入方式,請以裝置目前的元件介面為準。

設定方式:先在 App 中選好伺服器並完成手動連線測試,再依系統元件的編輯流程加入可用元件,並確認顯示內容。透過元件執行操作後,如有需要,返回 Home 確認實際連線狀態。

注意事項:元件畫面可能有更新間隔,不要將單次畫面變化當成即時診斷結果。若透過元件操作後的狀態不如預期,請先返回 App 檢查授權、伺服器選擇與 On Demand 條件。

iCloud:確認同步範圍

功能與位置:Settings 中的 iCloud 相關功能,可在 App 提供的範圍內同步或備份資料。同步不代表所有系統授權也會一併複製;實際包含哪些內容,請查看該入口的提示。

設定方式:確認裝置已登入自己的 iCloud 帳號,並在系統設定中允許相應的存取權限。首次啟用前,先保留現有設定的副本;在另一部裝置確認同步結果後,再決定是否取代原有內容。

注意事項:從 App Store 恢復已購項目與透過 iCloud 同步資料是兩回事。重新下載 App 後,仍須確認伺服器、設定與連線授權。同步內容可能包含訂閱網址或驗證資訊,請妥善保護帳號與裝置存取權限。

完成設定後,返回 Home 確認伺服器與 Global Routing,再測試實際目標。若要從匯入開始依序操作,請參閱完整使用教學;若要修改規則語法,請前往規則手冊。

Shadowrocket 正版下載