官方手冊 · 功能索引

Shadowrocket 功能與設定

先在 Home 確認連線狀態與 Global Routing,再決定要檢查伺服器、調整規則,或修改 Settings。以下以 iPhone / iPad 介面為例,說明各項功能的位置、用法與確認方式。

Home
查看連線狀態、路由模式與伺服器。
Config
確認啟用中的設定檔,檢查規則與策略。
Data
比較流量計數,確認統計範圍。
Settings
調整連線觸發、測試與診斷選項。
01 · 連線路徑

Global Routing 三種模式

先選擇流量處理方式,再檢查伺服器與設定檔。

在 Home 點開 Global Routing,可選擇設定檔、代理或直連,分別對應介面上的 Config、Proxy 和 Direct。這項設定決定用戶端如何處理接管的連線;它與頂部的連線開關各自獨立,切換至 Direct 不代表中斷系統 VPN。

介面選項連線處理方式適用情境
Config(設定檔) 依目前設定檔中的規則與策略處理。 日常需要依不同目的地分流時使用。請先確認啟用的是預期設定檔。
Proxy(代理) 由用戶端接管的連線都經由所選代理,不會逐條依設定檔中的分流規則選路。 規則模式下請求失敗時,可用相同目標短暫測試代理路徑。
Direct(直連) 由用戶端接管的連線不經過代理伺服器。 在相同網路下比對目標能否直接連線,或暫時不使用代理路徑。

排查前先記下原本模式,並保持伺服器、網路與測試目標不變,只切換模式後發出一次新請求。如果 Proxy 可以連線、Config 不行,優先檢查 Config 中的規則順序與策略選擇;如果兩種模式都失敗,再確認伺服器參數與目前網路。比對結果可協助縮小範圍,但不能只憑一次成功或失敗就判定原因。測試結束後,請切回日常使用的模式。

02 · 比對與處理

規則分流與策略

檢查規則順序,也確認策略最後指向何處。

規則分流會在同一條規則中指定「比對什麼」以及「比對後如何處理」。在 Config 找到目前使用的設定檔,先備份一份,再進入設定檔的規則編輯介面。檢查時由上往下閱讀:越具體的例外越適合放在通用規則之前;未符合前面規則的連線則交由末尾的 FINAL 處理。

規則類型:先確認比對對象

  • DOMAIN 比對完整網域名稱;DOMAIN-SUFFIX 比對網域後綴,適合涵蓋主網域及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對,條件設得太寬可能影響無關網域。
  • IP-CIDR 與 IP-CIDR6 分別比對 IPv4 與 IPv6 網段;GEOIP 依據 IP 位址歸屬資料比對,不能用來判斷頁面語言、帳號地區或網站營運者所在地。
  • USER-AGENT 取決於用戶端能否取得請求欄位,並非依應用程式名稱比對。若無法取得該欄位,就不應將它當作穩定的分流依據。

策略動作:檢查規則右側

DIRECT 表示直連,PROXY 表示經由代理,REJECT 表示拒絕連線。如果規則右側填的是策略組名稱,還要確認該組目前選擇的項目。在 Home 更換伺服器,不一定會改變指定策略組中規則的路由方式。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
03 · 連線資料

訂閱與伺服器管理

分別確認清單來源、目前選項與連線狀態。

新增單一伺服器

伺服器項目會儲存建立連線所需的參數。已有伺服器資料時,從 Home 開啟 Add Server,先選擇與資料相符的協定,再逐一填入位址、連接埠及該協定要求的驗證參數。Shadowsocks、VLESS 與 Trojan 的欄位並不完全相同;不要以某個頁面的填寫方式推斷其他協定所需的參數。儲存後回到伺服器清單,選取剛新增的項目,再連線測試。項目出現在清單中,只代表資料已儲存。

匯入與更新現有訂閱

訂閱是透過現有訂閱網址維護的一組伺服器項目。在 Home 開啟新增入口,選擇 Subscribe 並輸入使用者現有的完整訂閱網址。匯入後確認群組是否出現,再從中選擇要使用的伺服器。日常更新應針對原有訂閱群組操作,避免重複匯入相同網址。更新後若原本的選項消失,先確認該項目是否已遭移除或改名,並檢查相關策略組是否需要重新選擇。

區分訂閱更新與伺服器測試

訂閱更新檢查的是能否取得清單;Connectivity Test 檢查的是所選測試方法下的連線狀態,兩者並不相同。清單可以更新,不代表每台伺服器都能接受連線。若只有一台失敗,先確認該項目的協定與參數;若同一群組中多台同時失敗,先在相同網路下重新測試一筆已知可用的紀錄,再檢查更新是否變更了項目。訂閱連結與 QR Code 可能含有帳號憑證,不宜貼在公開回報或截圖中。

04 · 自動觸發

On Demand 按需連線

連線觸發條件與規則分流是兩層不同的設定。

On Demand 用來設定用戶端何時依條件建立連線;Global Routing 則決定連線建立後如何處理流量。設定前,先在 Home 使用手動開關確認伺服器與路由模式可正常運作,再前往 Settings 開啟 On Demand,依頁面提供的條件設定觸發網路。只加入目前需要的條件,方便確認是哪一項觸發了連線。

儲存後,在測試裝置上從一種網路切換至另一種網路,發出一次新請求,再回到 Home 確認連線狀態。若手動中斷後又自動連線,先暫時停用 On Demand 再測試;如果停用後能維持中斷,回到條件清單逐項檢查,不要先刪除設定檔或伺服器。若問題只在某個 Wi-Fi 網路出現,也應單獨確認該網路是否符合觸發條件,以及是否需要先完成登入。

05 · 計數與範圍

Data 流量統計

觀察前後數值差異,不要將計數視為路由紀錄。

Data 可查看 Shadowrocket 記錄的流量。進入介面後,先確認目前顯示的統計範圍,以及傳送與接收兩個方向,再進行比較。若要觀察單次操作,可在發出請求前記下數值,執行一次可重複的連線操作,再查看數值變化。盡量維持相同的網路與路由模式;背景重新整理或下載也可能同時增加計數。

如果數值沒有明顯變化,先確認 VPN 是否已連線、請求是否確實重新送出,以及前後讀數是否來自相同的統計範圍。瀏覽器若命中快取,重新開啟同一頁面不一定會產生新的網路傳輸。若介面提供清除計數的選項,而你需要保留比較紀錄,請先記下原始數值。Data 不是涵蓋所有裝置的系統流量帳單,也無法單獨證明某個網域符合哪條規則。若要確認流量路由方式,應一併參考目前模式、規則與可查看的連線紀錄。

06 · 常用選項

Settings 常用項目

每次只修改一項,並記錄修改前後的測試條件。

DNS:確認網域解析

DNS 負責將網域名稱解析為位址,與 Global Routing 的選路判斷並非同一項功能。在 Settings 檢查 DNS;若使用的設定檔也定義了解析設定,再到 Config 檢查該設定檔。修改前記下原始值,一次只改一處,並在相同網路下重新測試相同網域。尤其是公司或家用網路的內部網域,可能仰賴網路提供的解析服務;改用其他解析位址後,即使公網網域可以開啟,也不代表內部網域仍能解析。

Test Method:選擇連線測試方法

Test Method 決定如何執行 Connectivity Test。在 Settings 選擇符合目前排查目的的方法,再回到 Home 測試同一台伺服器。如果選用的方法需要連線至測試位址,結果也會受到該位址是否可連線影響。不同方法測量的環節不同,不宜將結果混在一起排序;單次測試通過也不代表所有目的地都能連線。比較前後兩次結果時,請維持相同的測試方法、目標與網路。

Today Widget:系統快速入口

Today Widget 可透過系統提供的小工具區域使用用戶端的快捷操作。先在 Settings 確認應用程式內與 Today Widget 相關的選項;若系統支援,再前往系統的小工具編輯介面新增或檢查入口。能否新增及可顯示哪些控制項,取決於系統支援情況。使用快捷操作後,若要確認 VPN 是否已連線,請回到 Home 查看實際狀態,不要把小工具上的顯示視為連線已建立的證明。

iCloud:確認同步範圍

iCloud 可在符合條件的 Apple 裝置間同步應用程式支援的資料。先確認兩台裝置登入相同的 iCloud 帳號,並在系統設定中允許應用程式使用 iCloud,再查看 Settings 中的相關選項。開始同步前,請保留目標裝置上需要的設定檔;同步後逐台確認伺服器清單、目前設定檔與路由模式,不要假設所有本機狀態都會原樣複製。系統 VPN 授權仍須依目標裝置上的提示操作。

Diagnostics:記錄可重現的問題

Diagnostics 用來彙整排查所需資訊。在 Settings 找到 Diagnostics,先記下目前網路、Global Routing 選項及受影響的操作,再重現一次並查看可見的診斷結果。請分別記錄「無法啟動連線」、「已連線但請求失敗」及「只有特定目標失敗」,不要將它們視為同一種故障。對外提供紀錄前,請移除訂閱網址、驗證欄位及不宜公開的網域,保留可重現問題的步驟與不含憑證的錯誤訊息。