官方手冊 · 功能與設定

Shadowrocket 設定
路由模式、規則與連線檢查

先確認 Global Routing,再檢查 Config 與伺服器。每次只調整一個項目,並以相同請求驗證,才能判斷設定是否確實影響連線。

依設定主題瀏覽

先釐清模式、設定檔與連線

以下介面路徑主要以 iPhone/iPad 為參考。其他平台的版面與可用選項可能不同,請以目前 App 實際顯示為準,不要將某個介面的操作路徑直接套用到所有裝置。

Home

Global Routing:設定、代理與直連

模式決定流量依照什麼原則處理。排查規則前,先確認這項設定。

功能說明:Global Routing 是連線處理方式的總開關。Config(設定)依照目前設定檔中的規則決定策略;Proxy(代理)會讓由客戶端處理的請求採用代理路徑;Direct(直連)則讓這些請求採用直連路徑。此處所說的「全部」,是指納入客戶端處理範圍的流量,不代表裝置上的所有系統流量都會經過相同路徑。

位置與設定方式:在 Home 開啟 Global Routing,選擇 Config、Proxy 或 Direct,再返回確認目前伺服器。日常需要依網域或 IP 區分路徑時,使用 Config;懷疑某條規則選錯策略時,可暫時切換至 Proxy 或 Direct 進行比對。比對期間請維持目標網址、網路與伺服器不變,否則無法判斷結果是模式或網路變動所致。

模式處理原則適用情境優先檢查項目
Config(設定)依照目前 Config 中的規則比對策略。日常規則分流;驗證特定網域或網段的處理路徑。目前選取的設定檔、規則順序及策略目標。
Proxy(代理)由客戶端處理的請求採用代理路徑。暫時排除分流規則的影響,檢查現有伺服器連線。目前伺服器是否有效,以及驗證資訊與傳輸參數是否一致。
Direct(直連)由客戶端處理的請求採用直連路徑。比對本地網路的連線結果,判斷問題是否與代理路徑有關。本地網路、目標服務與 DNS 是否正常。

注意:Proxy 無法修正錯誤的伺服器參數,Direct 也不等於關閉客戶端連線。切換模式後,請重新發出請求再查看記錄;已建立的長連線可能仍沿用原本的路徑。完成比對後請恢復日常使用的模式,避免長期保留排查設定。介面中的 Config 模式與 Config 頁面名稱相同,但前者指路由模式,後者用於管理設定檔。

Config

規則分流:分開檢查比對條件與策略

功能與位置:規則由比對條件與處理策略組成,可在 Config 查看目前選取的設定檔。DOMAIN 比對完整網域,DOMAIN-SUFFIX 比對網域後綴,DOMAIN-KEYWORD 依網域關鍵字比對;IP-CIDR、IP-CIDR6 用於比對 IP 網段,GEOIP 則依 IP 所屬地區的資料庫結果比對。USER-AGENT 是否有效,取決於能否取得相應的請求資訊;不能將它視為適用於任意加密請求的識別條件。

設定方式:先確認要變更哪個目標的連線路徑,再選擇最明確的條件。規則通常由上而下比對,最先命中的規則會決定該請求採用的策略;因此,特定網域規則應放在可能涵蓋它的廣泛規則之前,並將 FINAL 放在最後處理未命中的請求。修改後確認該設定檔仍為選取狀態,並以新請求驗證,不要只確認文字已儲存。

規則範例與策略說明

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

PROXY 代表使用代理處理,DIRECT 代表直連,REJECT 用於拒絕符合條件的請求。設定中的自訂策略名稱必須有相對應的定義。

DOMAIN IP-CIDR IP-CIDR6 REJECT

注意:以上範例僅說明規則順序,不代表適用於所有網路。依 IP 比對可能涉及 DNS 解析;網域實際指向變更時,連線路徑也可能跟著改變。REJECT 只會拒絕命中的請求,不能依頁面上的視覺區域刪除內容,也無法保證封鎖所有不需要的資源。若規則命中正確但仍無法連線,請接著檢查策略所指向的伺服器,而非一再新增類似規則。

Home · Add Server · Subscribe

訂閱與伺服器管理:先釐清來源

功能與位置:單一伺服器項目會儲存協定、位址、連接埠與驗證等連線參數;Subscribe 用來從使用者已有的訂閱網址取得並更新項目。在 Home 查看伺服器清單,手動輸入請使用 Add Server,已有 QR Code 則可透過 Scan QR Code 匯入。訂閱管理與 Config 設定檔管理是兩回事:更新伺服器清單,不代表目前的規則檔也已更新。

設定方式:向自己的服務供應商取得完整資訊,並依實際提供的類型選擇 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 或 Hysteria2 等協定。除了位址與連接埠,也要逐一確認驗證方式、TLS、傳輸方式及相關附加參數。兩個項目的位址相同,不代表其他參數也能通用。匯入後先確認項目數量與名稱,再選取一個項目執行 Connectivity Test,最後以實際目標請求驗證。

更新訂閱時,先在 Home 手動更新對應訂閱並查看結果。更新失敗與更新後清單為空是兩種不同狀況:前者先檢查連結是否能取得內容;後者還要確認回傳內容有效,且格式能被 App 識別。連結遭截斷、複製時帶入空格或回傳登入頁面,都可能導致匯入失敗。確認匯入成功前,請保留原有可用項目,以便排查時比對。

注意:手動修改由訂閱產生的項目,可能在下次更新時遭到覆蓋;若要長期保留變更,應先釐清本機項目與訂閱項目的關係。訂閱連結可能包含個人存取憑證,請勿貼到公開留言、截圖或診斷記錄中。協定名稱相同不代表設定內容一致,Connectivity Test 的結果也不能取代對驗證資訊與目標連線的檢查。

Settings · On Demand

On Demand:依條件觸發連線

功能與位置:On Demand 可依設定的網路條件觸發連線。在 Settings 中進入 On Demand,檢查目前是否啟用及已設定的條件。此功能決定何時建立連線,不負責選擇個別請求的策略;網域與 IP 的分流仍由 Global Routing 和 Config 決定。

設定方式:先手動連線並確認設定可用,再依 App 實際提供的條件設定觸發範圍。若涉及 Wi-Fi 網路,請仔細確認網路識別資訊與條件順序;儲存後分別在符合及不符合條件的網路中測試,觀察連線狀態是否符合預期。測試時盡量一次只切換一種網路條件,避免同時修改規則與伺服器。

注意:On Demand 不保證背景工作會永久執行,網路切換、系統權限與系統政策都可能影響連線過程。啟用後若連線次數增加或耗電情況改變,請記錄發生時的網路切換狀況,先減少不必要的觸發條件,再判斷是否需要調整其他設定。不同平台可用的條件請以實際介面為準。

Data

Data:透過流量變化協助排查

功能與位置:Data 顯示客戶端處理範圍內的流量統計;實際分類、統計期間與可查看的明細,請以目前介面為準。可用來觀察測試前後是否有請求與流量變化,但不能直接視為服務供應商的帳單,也不能據此認定裝置的所有網路活動都已納入統計。

使用方式:進入 Data 後,先確認統計範圍與目前數值,再返回目標 App 發出可重複的請求,之後查看數值變化。若 App 也提供請求或連線記錄,可搭配目標網域、發生時間與策略判斷連線路徑。不要只看累計總量:系統背景活動可能同時產生流量,明顯增加也不一定來自剛才測試的網頁。

注意:客戶端與服務供應商的統計方式可能因協定額外流量、統計週期及上下載計算方式而異,因此數字不必完全一致。清除記錄或重設統計前,先保存本次排查所需資訊;記錄中可能包含網域、位址與存取時間,分享前請先去除個人資訊。Data 有流量只代表發生資料傳輸,不代表目標回應內容正確,更不能據此保證速度。

Settings · Config

DNS:先確認解析路徑,再調整位址

功能與位置:DNS 會將網域解析為 IP 位址,解析結果會影響後續連線,也可能參與 IP 規則比對。請檢查 Settings 中與 DNS 相關的選項,同時查看目前 Config 是否包含 DNS 設定;設定檔也可能影響實際行為,因此不要只修改單一頁面的選項,就假定所有請求都會採用新設定。

設定方式:先確認問題是否確實發生在 DNS 解析階段:目標網域是否拼寫正確、多個網域是否都無法解析,以及本地網路是否正常。記下目前 DNS 設定後,一次只調整一個解析選項,並保持伺服器與路由模式不變。輸入的解析位址必須符合該欄位支援的格式;若欄位要求特定協定格式,請勿混用一般 IP 與完整協定位址。

修改後請以新請求重複測試,並留意既有快取與長連線的影響。若網域可以解析但連線仍逾時,應改為檢查伺服器、規則與目標服務;若只有少數網域無法連線,則比較實際命中的策略與解析結果。IPv4 與 IPv6 的連線狀況可能不同;問題間歇發生時,請記錄實際使用的位址類型,不要立刻停用其中一種位址支援。

注意:DNS 不等於代理傳輸,變更 DNS 無法修正錯誤的密碼或連接埠。加密 DNS 說明的是 DNS 請求的部分傳輸方式,不能據此推斷所有 App 流量的隱私狀況。請勿同時變更多項 DNS 設定、路由模式與伺服器,否則即使恢復正常,也難以確認是哪項變更生效。

Settings

Test Method、Today Widget 與 iCloud

這些設定分別影響測試、快速操作與資料同步,不應混為連線品質開關。

Test Method:釐清測試結果的意義

功能與位置:在 Settings 中查看 Test Method;此設定會影響 Connectivity Test 採用的測試方式。不同方法檢查的連線階段不同,結果不適合直接比較。某種測試方式能完成,不代表驗證資訊、目標網站回應與持續傳輸都已確認正常。

設定方式與注意事項:請依目前介面提供的方式選擇;比較多個伺服器時,應使用相同方法。若可設定測試目標,也要維持目標一致。結果異常時,先檢查測試目標本身是否可連線,再核對伺服器參數。若要確認實際使用情況,仍須在目標 App 中發出請求;不要將單次測試數值視為持續速度或長期穩定性的結論。

Today Widget:使用快速操作後返回 App 確認

功能與位置:Today Widget 相關設定可用於透過系統小工具快速操作。先在 Settings 檢查對應選項,再依系統提供的方式加入小工具;不同系統版本的小工具顯示位置與操作方式可能有所差異。

設定方式與注意事項:加入後先執行一次操作,再返回 Home 確認連線狀態與選取的伺服器是否符合預期。小工具顯示狀態可能受系統更新時間影響,不要只憑過期狀態判斷連線是否仍在進行。若小工具無法顯示或更新,先檢查系統是否允許使用該小工具,以及 App 是否已首次開啟,不要因此重寫規則檔。

iCloud:釐清同步、備份與目前選擇

功能與位置:iCloud 相關選項用於 App 支援的資料同步或匯入操作。請在 Settings 檢查對應項目,同時確認已登入系統 iCloud 並允許 App 使用。若介面提供 Import from Cloud JSON,請依該入口支援的格式匯入,不要將任意訂閱文字當成同類檔案。

設定方式與注意事項:確認目標裝置收到資料後,再檢查目前選取的 Config 與伺服器;不要假定選取狀態、系統連線權限或所有本機設定也會同步一致。同步前後都請保留可用的設定檔副本,發生衝突時先確認要保留哪一份內容。伺服器憑證與訂閱網址屬於敏感資訊,也應留意雲端帳號的存取權限;跨平台資料互通範圍請以實際功能為準。

Settings · Diagnostics

Diagnostics:從問題現象開始逐步確認

功能與位置:Diagnostics 是診斷入口,可收集或查看 App 提供的網路檢查資訊。在 Settings 找到 Diagnostics,並依目前介面選取可用項目。診斷記錄反映的是特定測試當下的環境,不應將舊記錄視為目前網路狀況的判斷依據。

使用方式:先描述問題:開關無法建立連線、所有目標都無法連線、只有一個網域失敗,還是訂閱無法更新。記下當時的網路、Global Routing、選取的伺服器與 Config,然後只重現一次問題。依時間查看記錄,區分 DNS 解析失敗、連線逾時、驗證失敗與規則選擇不符。請勿先大量修改設定再收集記錄,否則記錄就無法對應原本的問題。

  1. 先確認基本網路。在可控制的條件下比對本地網路連線,排除網路尚未連線或需要登入驗證的情況。
  2. 接著檢查連線資訊。確認伺服器位址、連接埠、協定與驗證參數,必要時以另一個已有項目進行比對。
  3. 接著檢查模式與規則。確認目前 Config 已選取,並查看請求實際採用的策略,不要只看規則文字。
  4. 最後還原並重新測試。撤回尚未驗證的臨時變更,使用相同目標重新發出請求,記錄還原前後的差異。

注意:分享記錄前,請移除訂閱網址、驗證欄位及其他個人資訊,只保留錯誤類型、發生順序與必要的環境說明。若問題出現在更新或切換設定檔之後,請優先與原有設定檔副本比對,不要立刻清除所有資料。更多問題情境請參閱排查手冊;首次建立連線的完整操作請參閱使用教學。