Shadowrocket 官方網站 · 官方手冊

Shadowrocket
代理模式與常用設定

先決定 Global Routing 的處理方式,再調整規則、DNS 與按需連線。本頁依序說明功能用途、所在位置、設定方式與注意事項。

適合已有訂閱或伺服器資訊的使用者。以下操作位置以 iPhone / iPad 介面為例;其他平台的版面與可用項目請以實際介面為準。

Global Routing

模式與連線出口的關係

處理流程示意,非應用程式介面。

Config
目前設定 → 依序比對規則 → 對應策略
Proxy
交由客戶端處理的連線 → 目前代理策略
Direct
交由客戶端處理的連線 → 直接連線

切換模式不會更換伺服器資訊,也無法修復失效的訂閱。

Config / Proxy / Direct

Global Routing:設定、代理與直連

Global Routing 決定連線採用哪種處理方式,不是伺服器清單。在 Home 找到 Global Routing,進入後選擇 Config、Proxy 或 Direct。中文說明中的「配置」、「代理」與「直連」分別對應這三個介面用詞。選好伺服器但模式仍是 Direct 時,切換伺服器通常不會改變連線路徑;模式設為 Config 時,也不能只看目前的伺服器名稱,就判斷某個網站是否經過代理。

介面選項處理方式適用情境使用前確認
Config(配置)依目前啟用的配置檔中的規則與策略處理連線。已備妥規則,日常使用時需要區分不同連線目標。確認 Config 啟用的是哪份配置檔,以及策略是否能找到對應的伺服器。
Proxy(代理)讓交由客戶端處理的連線使用目前的代理策略。暫時測試伺服器連線,或比對規則是否命中。確認目前伺服器可用,且協定參數完整。
Direct(直連)讓交由客戶端處理的連線直接連到目標。確認目前網路能否直接連線,作為故障排查的對照。確認目標是否能透過目前網路直接連線。

日常使用與臨時測試分開處理

已有確認過的配置檔時,通常先使用 Config。若某個網站無法連線,先記下原本的模式,再暫時切換至 Proxy 測試同一目標;若 Proxy 可用、Config 不可用,優先檢查規則命中情況與策略引用。若兩種模式都失敗,應接著檢查伺服器參數、本地網路與 DNS,不要反覆更換規則。測試完成後,請恢復原本的模式。

DOMAIN-SUFFIX

規則分流:比對條件與出口策略

規則說明「哪些連線交由哪種策略處理」。在 Config 查看目前啟用的配置檔,再進入編輯位置檢查規則內容。Global Routing 選擇 Config 後,規則才會成為分流判斷的主要依據。規則通常依配置順序比對,因此精確條件應排在較寬泛的條件前面,兜底規則則放在最後;新增規則前,請先保留原配置的副本。

先認識比對條件,再確認策略名稱

DOMAIN 比對完整網域名稱;DOMAIN-SUFFIX 比對指定網域及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對。IP-CIDR 和 IP-CIDR6 分別用於 IPv4 與 IPv6 網段;GEOIP 依據 IP 位址歸屬資料判斷;USER-AGENT 的判斷取決於是否能取得請求資訊,不適用於辨識所有應用程式連線。

規則最後的策略決定命中後如何處理。DIRECT 表示直接連線,REJECT 表示拒絕連線,PROXY 用於代理策略;配置檔也可能引用自訂策略群組名稱。自訂名稱必須與配置檔中的實際定義一致,不能直接把範例名稱當成已存在的策略使用。

# 規則語法範例;example.com 僅供說明
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

這段範例表示:先比對 example.com 及其子網域,再比對 GEOIP 條件,最後由 FINAL 處理其餘連線。這不是適用於所有網路的完整配置。網域解析結果、規則順序及策略是否有效,都會影響最終連線路徑;修改後請以同一個目標重新建立連線,並搭配連線記錄確認,不要只看首頁的連線開關是否開啟。

需要拒絕連線至特定目標時,請先縮小比對範圍。過於寬泛的 DOMAIN-KEYWORD 或網段可能連帶影響登入、圖片與 API 請求。針對單一問題,每次只修改一條規則;既有連線可能仍沿用原本的處理結果,必要時請重新開啟目標應用程式進行比對。更多模式說明請見 Global Routing 三種模式詳解。

Subscribe

訂閱與伺服器管理:區分來源和配置

訂閱用來管理伺服器清單,Config 用來規定連線的處理方式,兩者內容不同。在 Home 查看伺服器與訂閱群組;新增自己已有的資訊時,從 Add Server 進入,依實際類型選擇對應的協定或 Subscribe。可透過 Scan QR Code 匯入 QR Code,但掃描前仍應確認內容來自自己信任的來源。

新增與更新 Subscribe

將已有的訂閱網址填入 Subscribe 對應欄位,設定方便辨識的備註後儲存,再更新訂閱以取得伺服器清單。匯入完成不代表已連線:還需在 Home 選擇伺服器、確認 Global Routing,再開啟連線開關。更新後若清單為空,請先確認網址是否完整、是否已過期,以及目前網路能否連上訂閱網址;不要把訂閱網址填入伺服器地址欄位。

更新訂閱時,可能會取代由該訂閱產生的項目。若要暫時調整參數,請先記下原值或保留獨立副本,以免下次更新後修改內容遺失。刪除前請確認操作對象是單一伺服器還是整個訂閱群組;不確定時先保留原項目,並透過備註區分測試項目。

Add Server 手動新增參數確認

手動新增時,請依已有的伺服器資訊選擇 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 或其他實際支援的協定。伺服器地址、連接埠、驗證資訊,以及 TLS 和傳輸相關欄位必須彼此相符。協定名稱相近不代表欄位可以互換;也不要為了排除錯誤而任意關閉憑證驗證。儲存後先測試單一項目,再判斷是否需要修改規則。

On Demand

On Demand:依網路條件觸發連線

On Demand 管理何時嘗試建立連線,不會取代 Global Routing 的分流規則。在 Settings 尋找 On Demand;若目前介面將此項目獨立列出,請從同名入口進入。設定前先手動連線一次,確認伺服器和配置檔可用,再逐一啟用所需的 Wi-Fi 或 Cellular 條件。實際可選條件請以目前平台介面為準。

設定前先確認使用情境,例如在指定的 Wi-Fi 環境採用不同的連線行為,再檢查各條件是否重疊。若依 Wi-Fi 名稱設定條件,請確認名稱拼寫、空格,以及是否有同名網路。不要同時建立多條意思相反且範圍寬泛的條件,否則從 Wi-Fi 切換至 Cellular 時,難以判斷是哪條條件觸發連線。

需要暫停自動連線時,請檢查 On Demand 是否啟用,而不只是關閉 Home 的連線開關。只要按需條件仍符合,系統就可能再次嘗試連線。若要排查反覆重新連線,先記下條件並暫時停用 On Demand,再手動連線確認穩定性,最後逐條恢復設定。按需觸發不保證切換網路時所有既有連線都能維持,應用程式可能需要重新送出請求。

Data

Data:查看流量記錄與測試變化

Data 用來查看客戶端記錄的流量資訊,不是電信業者帳單。進入 Data 後,先確認目前頁面顯示的時間範圍、方向與分類標籤,再查看上傳和下載記錄。若目前版本提供連線詳細資訊,可比對異常時段與存取目標;不要只憑累計數字就認定某條規則一定生效。

進行單次測試時,先記下目前的統計數值與時間,暫停其他持續傳輸,再開啟明確的測試目標觀察變化。若要使用頁面提供的重設功能,請先儲存需要保留的記錄,並確認重設範圍。累計流量、目前連線階段與特定統計週期的數字意義不同,比較前必須確認時間範圍一致。

Data 與系統的行動數據用量不同,不一定代表發生故障。統計起訖時間、協定傳輸額外負載、背景連線及客戶端可記錄的範圍都可能不同。判斷是否經過代理,請一併檢查 Global Routing、規則命中情況與連線記錄;確認方案剩餘用量,則應查看自己使用的服務帳戶記錄,不要以 Data 作為計費依據。

Settings

Settings:DNS、測試與快速操作

Settings 集中管理客戶端的一般行為,但部分同類設定也可能由目前的 Config 指定。調整前先檢查配置檔內容,避免只修改全域設定,卻忽略目前配置檔的影響。不同平台、系統權限與版本的設定位置可能不同;找不到特定項目時,請以實際介面為準,不必為了配合本文而重複匯入配置檔。

DNS:分別確認網域解析與連線路徑

DNS 會將網域名稱解析為 IP 位址。先在 Settings 的 DNS 相關入口查看現有設定,再檢查 Config 中是否包含 DNS 設定。若網頁無法開啟,但 Connectivity Test 有結果,應先分辨「伺服器可連線」與「目標網域能否正確解析」。保留原設定,每次只調整一項與解析相關的設定,再用同一個網域重新測試。

解析器可連線不代表一定能連上目標;更換 DNS 也無法修復錯誤的伺服器密碼或傳輸參數。輸入地址及選擇解析方式時,請依介面要求操作,避免將包含路徑的網址填入只接受伺服器地址的欄位。若只有部分網域連線失敗,請接著確認規則以及 IPv4、IPv6 路徑。詳細步驟請見 DNS 解析失敗排查。

Test Method:統一 Connectivity Test 的測試條件

Test Method 會決定 Connectivity Test 採用的測試方式。在 Settings 尋找 Test Method,先確認目前使用的方法,以及介面是否提供測試目標設定,再開始測試。比較多台伺服器時,應使用相同的本地網路、測試方法與目標,並在相近時間內測試,避免將不同條件下的結果混在一起判斷。

測試結果只反映該次測試過程。能取得結果不代表所有網站、協定或持續傳輸都正常;單次逾時也不足以判定伺服器長期失效。若測試結果與實際存取情況不一致,請以實際目標重現問題,再從 DNS 與連線記錄中找出原因。

Today Widget:快速入口與系統權限

Today Widget 可在系統支援的範圍內提供快速查看或操作功能。在 Settings 查看相關設定,再到系統提供的小工具管理位置新增。是否能顯示及可執行哪些操作,取決於系統版本和目前應用程式提供的小工具類型;若沒有顯示,請先確認曾開啟應用程式,並檢查系統是否允許小工具執行。

快速入口與主應用程式使用相同的連線狀態。使用快速操作後,請回到 Home 確認伺服器、模式與連線開關,不要只根據小工具短暫顯示的內容判斷最終狀態。自動連線相關問題仍須回到 On Demand 檢查。

iCloud:確認同步範圍後再更換裝置

若目前版本提供 iCloud 同步,請在 Settings 找到相關項目,並確認系統已登入預期的帳戶,且允許 Shadowrocket 使用 iCloud。啟用前先查看頁面列出的同步範圍,不要假設伺服器資訊、配置檔、統計資料和連線狀態都會一併同步。

更換裝置時,先等待同步完成,再在新裝置逐項確認配置內容;避免兩台裝置同時修改同一份資料。同步不能取代獨立備份,也不代表伺服器憑證失效後仍能使用。訂閱網址或驗證資訊等內容應視為敏感資料管理;轉交裝置前,請使用系統與應用程式提供的功能清除資料。

Diagnostics

Diagnostics:逐層定位,避免反覆修改設定

Diagnostics 用來蒐集故障線索,無法自動證明伺服器或規則設定正確。在 Settings 尋找 Diagnostics,依目前介面提供的項目執行檢查。重現問題前,先記下本地網路、所選伺服器、Global Routing 與啟用的配置檔;若需要暫時開啟記錄,測試結束後請恢復原本的記錄層級。

  1. 先檢查本地網路。確認裝置本身可以連上已知可用的目標;必要時在 Wi-Fi 與 Cellular 之間進行一次比對,不要同時修改客戶端參數。
  2. 接著檢查伺服器。對同一個項目執行 Connectivity Test,確認協定、地址、連接埠與驗證資訊。若多個項目同時出現異常,優先檢查共同的網路條件。
  3. 接著比對模式。記錄使用 Config 與 Proxy 存取同一目標時的差異。若只有 Config 異常,優先檢查規則順序、策略引用及 DNS 相關設定。
  4. 最後查看記錄。依問題發生時間找出目標網域、錯誤訊息與實際採用的處理策略;每次修改一項後重新建立連線,確認變化是否能穩定重現。

診斷資料可能包含存取網域、伺服器地址、訂閱連結及驗證相關內容。需要儲存或提交排查資料時,請先刪除完整訂閱網址、密碼和可識別個人身分的資訊;不要直接公開整份配置檔或所有記錄。排查完成後,整理最終生效的修改、刪除臨時測試項目,並恢復日常使用的 Global Routing 與 On Demand 條件。

需要從匯入開始按步驟操作,請前往入門指南;已找到特定錯誤,請查看故障排查。iPhone / iPad 的系統需求請以 App Store 頁面標示為準。