官方手冊 · 功能與設定
Shadowrocket 功能與設定
在 Global Routing 選擇流量的路由方式,在 On Demand 設定連線時機。本頁以 iPhone / iPad 介面為例,其他平台請以各自客戶端顯示的選項為準。
- Config配置 · 依規則選擇策略
- Proxy代理 · 使用所選伺服器
- Direct直連 · 不經代理伺服器
01 路由模式
Global Routing:配置、代理與直連
在 Home 開啟 Global Routing,選擇 Config、Proxy 或 Direct。此選項決定進入 Shadowrocket 的流量如何選擇路由,並非連線開關。切換模式不會自動建立連線;選好模式後,返回 Home 確認連線狀態。
| 介面選項 | 流量處理方式 | 適用情境 | 切換前確認 |
|---|---|---|---|
Config(配置) |
依目前配置中的規則選擇策略。 | 不同網站或位址需要採用不同路徑。 | 在 Config 確認實際啟用的檔案與規則順序。 |
Proxy(代理) |
進入客戶端的流量皆經由所選代理伺服器,不依分流規則選擇路徑。 | 暫時排除規則的影響,確認目前伺服器能否處理測試請求。 | 在 Home 確認選取的是要測試的伺服器。 |
Direct(直連) |
進入客戶端的流量不經代理伺服器。 | 為相同請求建立直連基準,判斷問題是否只出現在代理路徑。 | 這不會中斷連線;如需中斷,請使用 Home 的連線開關。 |
如果同一網站在 Proxy 模式下可以存取,在 Config 模式下卻失敗,請先查看命中的規則及該規則指定的策略,再決定是否修改配置。如果兩種模式都失敗,先別重新排列整份規則;先確認目前網路、所選伺服器及實際測試的目標位址。比較時只切換模式,其他條件維持不變。
02 比對與策略
規則分流:比對條件、順序與最終規則
在 Config 開啟準備使用的配置,檢查其中的 Rule 區段。規則前半部列出比對條件,末尾指定符合條件後採用的策略,例如 PROXY 走代理、DIRECT 走直連、REJECT 拒絕請求。配置生效後,還須在 Global Routing 選擇 Config,否則修改規則不會改變此模式下的路由。
依請求資訊選擇規則類型
DOMAIN精確比對主機名稱,適合只調整單一網域的路徑;DOMAIN-SUFFIX比對網域後綴,適合讓主網域及其子網域採用相同策略。DOMAIN-KEYWORD依網域中的字串比對。字串越短越容易誤判,使用前應先確認是否會比對到無關網域。IP-CIDR和IP-CIDR6分別依 IPv4 與 IPv6 網段比對;GEOIP依 IP 位址的地理分類比對。若以網域名稱發出的請求需要依目標位址判定,也應檢查解析結果。USER-AGENT依可取得的請求識別資訊比對,並不等同於依應用程式名稱辨識流量。客戶端無法取得相應欄位時,不應依賴此規則進行分流。
具體規則放前面,FINAL 放最後
規則依序比對,由第一條符合的規則決定策略。以下以示範網域說明例外規則:第一行只讓 static.example.com 直連,第二行才讓相同網域後綴的其他請求使用代理。若調換前兩行,範圍較廣的後綴規則會先符合,具體例外便不會生效。
DOMAIN,static.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
這是規則順序範例,並非完整配置。FINAL 只處理前面都未符合的請求;是否以 DIRECT 作為最終規則,應依你希望如何處理未列出的目標來決定。修改前先儲存原配置,驗證時至少檢查一個明確符合規則的目標,以及一個應套用最終規則的目標。如要使用 REJECT 攔截,請先從範圍明確的網域開始,避免連登入或靜態資源也一併攔截。
03 連線資料
Subscribe、Add Server 與伺服器選擇
在 Home 管理現有的伺服器資料。如果取得的是訂閱連結,請從新增入口進入 Add Server,將類型選為 Subscribe,貼上完整連結並儲存;若介面提供更新功能,再更新訂閱並確認項目已出現在 SERVER 清單中。訂閱連結可能包含存取憑證,請勿將完整連結貼到公開文章、截圖或診斷紀錄中。
如果取得的是單一伺服器的參數,請在 Add Server 選擇資料中註明的協定,再逐項填入位址、連接埠,以及該協定所需的驗證與傳輸參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的欄位不盡相同,請勿將某種協定的參數套用到另一種協定。儲存後返回 Home,從 SERVER 選取要使用的項目,再執行 Connectivity Test 並實際測試存取。
更新訂閱與更新配置檔是兩回事:前者更新伺服器項目,後者會變更參與比對的規則。更新訂閱後,如果原有項目已被替換,請重新確認目前選取的項目;若配置以名稱引用伺服器或策略群組,也要檢查名稱是否仍相符。若訂閱更新失敗,先查看更新狀態,確認清單是否未能載入;不要把現有項目的連線問題與訂閱更新問題混在一起排查。
04 連線條件
On Demand:依網路條件連線
On Demand 控制系統何時依條件觸發連線,不負責決定個別請求要走代理或直連。先在 Home 手動連線一次,確認已完成系統連線授權且伺服器可用;再到 Settings 開啟 On Demand,依介面提供的網路條件設定。先啟用一項需要的條件並驗證,再加入例外,比較容易判斷是哪個設定改變了連線行為。
例如,若希望切換到行動網路後才自動連線,可以先只設定相應的網路條件。儲存後,在 Wi-Fi 與行動網路之間切換,使用相同的測試目標,分別記錄切換前、切換後及返回原網路時的連線狀態。只看到設定頁上的開關已開啟,並不足以證明條件已觸發。
手動中斷連線後,如果裝置仍符合自動連線條件,系統可能再次建立連線。若要確認手動中斷的效果,請先暫時關閉 On Demand 再測試。若連線狀態符合預期,但存取路徑不正確,應檢查 Global Routing 與規則,而不是反覆調整隨選連線條件。
05 用量確認
Data:查看流量統計
Data 可查看客戶端記錄的流量。進入 Data 後,先確認目前的統計範圍與單位,再區分上傳與下載流量。若要估算某項操作產生的用量,先記下目前數值,只執行一次操作,等數值更新後比較前後差異。測試時盡量避免同時下載、同步或播放媒體,以免其他請求也被計入。
應用程式端統計、系統行動網路數據統計及服務商帳單,可能涵蓋不同的流量與時間範圍,不宜直接相減來判斷是否漏計。若讀數看起來沒有變化,先確認連線仍在運作,再確認請求是否進入客戶端,以及顯示精度是否足以呈現這次變化。若要判斷個別請求是否符合某條規則,應查看請求紀錄;單憑流量總量無法確定實際採用的策略。
06 常用選項
Settings:解析、測試、同步與診斷
開始排查前,記下目前的配置、伺服器與路由模式。每次只修改一個選項,並使用相同目標重新測試。即使結果沒有改善,也能還原原設定,不必重新設定整套連線。
DNS:先檢查目前配置的解析設定
DNS 決定網域名稱如何解析為位址。若目前配置已指定解析伺服器,請先在 Config 查看該檔案的 General 區段,例如是否設定了 dns-server;尚未檢查配置前,不要直接將結果歸因於系統網路。確認有解析問題時,先記錄原設定,再修改解析項目,並重新測試同一個網域。自訂解析伺服器必須能在目前網路環境下連線;能連上伺服器,不代表目標網域一定能解析。
Test Method:統一連線測試條件
在 Settings 查看 Test Method,依介面提供的方式選擇測試方法,再返回 Home 執行 Connectivity Test。比較多個項目時,應維持測試方法、網路與目標一致。測試成功只代表這次探測達到該方法的成功條件,不保證所有網站都能存取;反之,單一探測目標失敗,也不表示伺服器對所有目標都無法連線。
Today Widget:查看狀態與使用快速操作
在 Settings 找到 Today Widget,依應用程式中顯示的選項設定小工具功能,再前往系統小工具介面確認裝置是否支援新增。使用小工具執行操作後,可返回 Home 確認連線狀態與目前伺服器。小工具提供快速操作;如果操作後連線很快又重新建立,請先檢查 On Demand 條件。
iCloud:更換裝置前確認同步範圍
在 Settings 找到 iCloud 相關選項。準備同步時,先確認兩部裝置使用相同的 Apple 帳號,且系統已啟用相應的 iCloud 功能,再確認客戶端實際列出的同步項目。更換裝置前,請保留重要配置的備份;更換後逐項檢查伺服器清單、已啟用的配置與連線授權。已購項目的還原與應用程式資料同步是兩回事,重新安裝成功不代表原有設定已還原。
Diagnostics:依時間定位故障
在 Settings 開啟 Diagnostics 或介面提供的診斷入口,記下問題發生的時間,然後只重現一次失敗操作。查看前後相鄰的紀錄,先區分網域解析失敗、規則選錯策略與連線逾時,再檢查對應設定。若要轉送診斷資訊,只保留與故障相關的片段,刪除訂閱連結、驗證欄位與私人位址;排查完成後,將為了診斷而暫時調高的紀錄層級還原。