官方手冊 · 功能與設定
Shadowrocket 設定教學
先在 Home 確認 Global Routing,再依需求調整規則、更新現有訂閱或啟用 On Demand。本文以 iPhone / iPad 為例說明操作路徑;桌面版與 Android 版的功能位置請以應用程式內顯示為準。
01 / Global Routing
如何選擇 Config、Proxy 或 Direct
在 Home 開啟 Global Routing,依目前需求選擇 Config、Proxy 或 Direct。此選項決定連線開啟後如何處理請求,不負責建立連線,也不會改寫設定檔。
| 模式 | 請求處理方式 | 適用情境 | 切換前後的檢查項目 |
|---|---|---|---|
| Config(設定) | 依目前設定檔中的規則與策略分流。 | 日常使用,或需要讓不同請求套用不同策略時。 | 確認目前生效的設定檔,並檢查相關規則與 FINAL。 |
| Proxy(代理) | 將由用戶端接管的請求交給所選代理伺服器處理,不會依 Config 規則逐條選擇路徑。 | 暫時確認目前伺服器能否處理指定請求。 | 確認 Home 中選取的伺服器;測試後切回日常使用的模式。 |
| Direct(直連) | 用戶端接管的請求不經代理伺服器轉送。 | 排查經代理與目前網路直連時的差異。 | Direct 不等於關閉 Home 中的連線開關;若要比較用戶端未接管時的狀況,請先關閉連線再測試。 |
進行對照測試時,固定使用同一個網路、目標網址和伺服器,每次切換模式後重新送出請求。若 Proxy 可以連線而 Config 不行,優先檢查規則是否命中及策略指向;若 Direct 也失敗,再關閉連線重試,以區分網路問題與用戶端設定問題。既有連線可能仍沿用舊路徑,不能只看已開啟的頁面判斷切換結果。
02 / Rule
規則類型、比對順序與策略
規則由比對條件和命中後套用的策略組成。開啟 Config,確認目前使用的設定檔,再檢查其中的 [Rule] 區段。規則會依序比對,最先命中的項目決定該請求套用的策略。只有 Home 中的 Global Routing 設為 Config 時,才會使用這份規則清單進行分流。調整前請保留原設定檔,方便比對與還原。
DOMAIN精確比對單一主機名稱;DOMAIN-SUFFIX可涵蓋指定網域及其子網域;DOMAIN-KEYWORD依網域中的關鍵字比對,關鍵字越短越容易誤判。網域規則只填網域名稱,不要加入通訊協定、路徑或查詢參數。IP-CIDR和IP-CIDR6分別比對 IPv4 與 IPv6 位址範圍,GEOIP則依 IP 地區資料比對。這些規則判斷的是 IP,不是網域後綴;目標位址變更或使用不同位址類型時,命中結果也可能不同。USER-AGENT依據請求中可辨識的 User-Agent,不適合用來比對所有應用程式流量。FINAL會接收前面規則都未命中的請求,應放在規則清單最後。
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
範例先讓 status.example.com 使用 DIRECT,再將同一網域下其餘符合條件的請求交給 PROXY。若將前兩行對調,涵蓋範圍較大的後綴規則會先命中,第一條例外便不會生效。PROXY 會使用代理路徑,DIRECT 不經代理伺服器,REJECT 則會阻擋符合條件的請求。使用 REJECT 時,請先限定目標範圍,避免連同依賴相同網域的登入或資源請求一起阻擋。
儲存後,先測試需要個別處理的網址,再測試同網域下不應受影響的網址,最後測試預期會套用 FINAL 的目標。欄位格式與其他範例請參閱設定欄位。
03 / Server
匯入現有訂閱與管理伺服器
訂閱可依來源更新一組伺服器項目;若只有單一伺服器的連線參數,也可以個別新增。這兩種方式都需要已有自己的訂閱或伺服器資訊。訂閱網址可能包含存取憑證,請像保管密碼一樣妥善保存,勿放入公開截圖、記錄檔或共用文件。
- 在 Home 開啟 Add Server。若已有訂閱網址,請選擇 Subscribe,輸入服務供應商提供的完整網址並儲存。需要更新時,請在 Home 找到該訂閱的更新選項,再確認項目是否載入;不要將訂閱網址填入單一伺服器的位址欄位。
- 若已有單一伺服器的參數,請在 Add Server 選擇資料所列的通訊協定,例如 Shadowsocks、VMess 或 Trojan,並依欄位填入主機、連接埠和驗證資訊。若資料提供 QR Code,可使用 Scan QR Code 匯入;儲存前仍須確認通訊協定與目標位址。
- 返回 Home,在 SERVER 清單中選取要使用的項目,再執行 Connectivity Test。訂閱更新後,請重新確認目前選取的項目;同名項目可能已更換位址或參數,名稱相同不代表仍是原本的伺服器。
請將「訂閱更新成功」和「伺服器連線成功」視為兩項不同檢查。更新成功只表示用戶端已取得清單;若項目仍無法連線,請確認通訊協定、位址、連接埠及服務供應商提供的驗證參數。若更新本身失敗,請先確認訂閱網址是否完整,以及目前網路能否連上該網址。匯入後的首次連線操作請參閱快速入門。
04 / On Demand
按需連線與網路切換
On Demand 可在符合設定條件時由系統啟動連線,適合需要在切換網路後自動連線的情境。它處理的是「何時連線」,不會決定「請求走哪條路徑」;後者仍由 Global Routing 與目前設定檔決定。
在 Settings 找到 On Demand。先在 Home 手動確認目前伺服器和分流模式,再啟用 On Demand,依畫面提供的 Wi-Fi、行動網路等條件縮小啟用範圍。儲存後,分別在預期會觸發與不會觸發的網路上送出請求,再回到 Home 查看連線狀態。切換網路後請等待系統重新建立連線,不要因剛切換時一次失敗就認定規則未生效。
若手動中斷連線後又自動連線,請先檢查觸發條件是否仍符合。暫時進行中斷對照測試時,可先關閉 On Demand,測試完再重新啟用。排查耗電問題時也不要只看開關狀態;請對照系統電池用量記錄,觀察在相近網路與使用時段下是否頻繁重新連線。
05 / Data
流量統計範圍與讀數
Data 用於查看 Shadowrocket 記錄的流量,不等同於電信業者帳單或服務供應商的計量結果。在 Data 中先確認畫面顯示的統計範圍與單位,再查看傳送量和接收量。進行單次測試時不必清除既有記錄:記下開始讀數,完成一次操作後以結束讀數減去開始讀數。
若讀數增加速度超出預期,請先在同一個網路下重複觀察,並將影片播放、雲端同步、大型檔案下載等背景活動與目前測試分開。若讀數沒有變化,先確認連線已建立,再檢查請求是否經過用戶端;頁面若命中本機快取,也可能不會產生新的網路傳輸。Data 可以顯示「記錄了多少流量」,但不能只靠流量增量判斷某個網域命中了哪條規則,也不能用來推算線路剩餘用量。
06 / Settings
DNS、測試方式、系統元件、同步與診斷
先記下原始設定,只修改與目前問題相關的一項。每次修改後使用相同目標重新測試;若同時更改 DNS、伺服器和測試方式,就難以判斷結果由何者造成。
DNS:區分解析結果與分流結果
DNS 負責將網域名稱解析為位址。排查時先在 Home 確認 Global Routing,再到 Config 查看目前設定檔中的 [General],包括相關的 dns-server 設定。如有需要,依目前網路需求調整,儲存並重新連線,再分別測試可正常解析的對照網域與原本故障的網域。公司或家用網路的內部網域可能仰賴該網路的 DNS 解析器;改用公共 DNS 後,外部網域正常不代表內部網域也能正常解析。其他欄位請參閱General 設定說明。
Test Method:固定條件後再比較
在 Settings 查看 Test Method,依畫面提供的選項選擇測試方式,再回到 Home 執行 Connectivity Test。檢查連線是否建立,與確認完整請求是否成功,並不是同一件事;即使測試成功,也不能據此判定特定服務網域可用。比較不同伺服器時,盡量固定網路、測試方式及介面允許設定的測試目標。若遇到一次逾時,先以相同設定重測,再決定是否更換伺服器或檢查參數。
Today Widget:透過系統小工具查看狀態
Today Widget 是系統小工具的入口,不是獨立的連線設定。若 Settings 中顯示 Today Widget,請先確認可用選項,再依系統目前支援的方式加入 Shadowrocket 小工具。若裝置的小工具清單中找不到該入口,或小工具顯示的狀態未即時更新,請回到 Home 確認連線狀態與所選伺服器。分流模式、訂閱和設定檔仍須在應用程式內管理。
iCloud:同步前確認資料範圍
若要在自己的 iPhone 與 iPad 之間同步資料,請先確認兩部裝置登入相同的 Apple 帳號,並在系統設定中允許 Shadowrocket 使用 iCloud;接著到應用程式的 Settings 檢查 iCloud 相關選項。啟用前請保留重要設定,先只在一部裝置修改一項,再到另一部確認對應內容是否更新。同步不能取代獨立備份;看到項目已同步,也不代表連線已建立。系統權限與連線狀態仍須在每部裝置上分別確認。
Diagnostics:記錄可重現的問題
Diagnostics 可用來收集目前連線的排查線索。在 Settings 開啟 Diagnostics 前,請記下錯誤時間、目前網路、Global Routing 模式,以及問題是否只影響特定目標。依原本操作重現一次,並將診斷結果與 DNS、伺服器測試或規則檢查結果對照。提供問題說明前,請刪除完整訂閱網址、密碼及驗證資訊;只保留重現問題所需的環境與現象。若不確定下一步,請參閱連線問題問答。