官方手冊 · 功能與設定

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 或介面提供的診斷入口,記下問題發生的時間,然後只重現一次失敗操作。查看前後相鄰的紀錄,先區分網域解析失敗、規則選錯策略與連線逾時,再檢查對應設定。若要轉送診斷資訊,只保留與故障相關的片段,刪除訂閱連結、驗證欄位與私人位址;排查完成後,將為了診斷而暫時調高的紀錄層級還原。

查看各項設定說明 · 查詢介面與規則術語