官方手冊 · 功能與設定

Shadowrocket
代理模式與設定詳解

日常使用時先選擇 Config,再檢查設定檔規則與目前使用的伺服器。只有在暫時診斷時才切換至 Proxy 或 Direct;調整設定時一次只改一項。

適用於 iPhone / iPad / Mac / Windows / Android / Linux。以下操作路徑以 iPhone / iPad 為例;其他平台請在相應介面尋找同名功能。選項位置與適用範圍以目前客戶端為準。

先分清模式、規則與伺服器

Shadowrocket 的連線結果並非由單一開關決定。Global Routing 決定整體處理方式,Config 中的規則決定各項請求採用哪種策略,而 Home 中選取的伺服器則為需要代理的連線提供實際出口。三者各有用途:切換伺服器不會自動修正錯誤規則,更新訂閱也不代表已切換目前使用的設定檔。

開始前,請先備妥自己的訂閱或伺服器資訊。本網站不提供、不販售、不推薦節點或訂閱。客戶端一次性購買費用 ≠ 線路方案費用;客戶端的取得費用與既有線路是否可用,是兩回事。

Global Routing 三種模式

設定檔對應 Config,代理對應 Proxy,直連對應 Direct。本文以中文說明,實際操作時請認明英文選項。

是什麼:Global Routing 用來選擇整體路由方式,並非伺服器協定設定。在哪裡:在 Home 中尋找 Global Routing。如何設定:日常依規則處理流量時選擇 Config;需要比較代理與原始網路的狀況時,再短暫切換至 Proxy 或 Direct。

選項處理方式適用情境檢查重點
Config依目前設定檔中的規則決定連線策略。日常規則分流;依網域或位址區分連線方式。確認目前設定檔是否正確、規則順序是否合理,以及策略目標是否可用。
Proxy將客戶端接管的流量以代理模式處理。暫時判斷問題是否出在分流規則。確認目前伺服器能否連線;不要將此模式理解為接管裝置上的所有流量。
Direct將客戶端接管的流量以直連模式處理。暫時比較原始網路與代理路徑。確認原始網路能否連上目標;此模式不等於關閉連線開關。

注意事項:若某個網站在 Proxy 下正常、在 Config 下異常,可優先檢查命中的規則與策略。這只是排查線索,不能直接斷定設定有誤,因為 DNS 解析與已建立的連線也可能影響結果。切換模式後請重新送出請求;必要時先結束舊連線,再以相同條件比較。

排查完成後,請恢復原本使用的模式。長時間停留在 Proxy 會改變原有的分流行為;長時間停留在 Direct 則可能讓需要代理的請求直接連線。切換模式也無法補上缺少的伺服器參數,TLS、傳輸方式與驗證資訊仍須正確。

規則分流:比對條件與執行策略

先確認請求符合哪一條規則,再查看該規則指定的策略。

規則類型決定比對對象

DOMAIN 比對指定網域,DOMAIN-SUFFIX 比對網域及其子網域,DOMAIN-KEYWORD 則依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍;GEOIP 依位址所屬地區比對。USER-AGENT 涉及請求中的相應欄位,適用範圍取決於流量是否可供辨識,不能視為辨識所有加密連線的通用方法。

策略決定連線處理方式

DIRECT 表示直接連線,PROXY 表示依指定的代理策略處理,REJECT 表示拒絕連線。規則也可能引用設定檔中定義的策略群組,此時還須確認群組名稱及群組內的選擇。FINAL 用於處理未符合前面規則的請求;它不是優先級更高的強制規則,通常應放在規則清單末尾。

在哪裡:進入 Config,確認目前使用的設定檔,再檢視或編輯其中的規則。如何設定:先保留設定檔副本,將範圍較小、用途明確的規則排在通用規則之前。規則通常由上而下比對,符合後便依指定策略處理。因此,若較早的寬泛規則已涵蓋某個網域,該網域的具體規則即使放在後面,也不會達到預期效果。

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

以上僅示範語法與順序:example.com 及其子網域走 PROXY,接著依 GEOIP 規則判斷,其餘交由 FINAL 處理。這並非適用所有網路環境的完整設定。修改後請對目標網域重新送出請求,並查看連線記錄確認採用的策略;不要只看首頁是否顯示已連線。

注意事項:部分位址類規則會依賴解析結果,DNS 設定也會影響比對。遇到異常時不要立刻連續新增多條相似規則;先確認網域是否正確、目標策略是否存在,再排查規則順序與快取因素。更多關鍵字請參閱概念速查。

訂閱與伺服器管理

Subscribe 用於管理批次來源,Add Server 用於管理單一伺服器參數。

是什麼:訂閱是用來取得及更新伺服器清單的來源;單一伺服器則包含協定、位址、連接埠與驗證等連線參數。更新訂閱通常只會更新該來源中的項目,不代表伺服器一定可用,也不代表 Config 中的分流規則已更新。

在哪裡:在 Home 透過新增入口尋找 Subscribe;手動新增請使用 Add Server,透過 QR Code 匯入則使用 Scan QR Code。如何設定:將服務商提供的完整訂閱連結填入相應欄位,儲存並更新清單,再選取要使用的伺服器。手動新增時先選擇協定,再依現有資訊填入位址與驗證參數;VLESS、VMess、Trojan 等協定的欄位不可混用。

  1. 匯入前請確認資訊完整,尤其留意複製內容是否夾帶空格、換行或說明文字。
  2. 匯入後請檢查群組與項目名稱,確認內容來自預期來源,並避免重複匯入相同訂閱。
  3. 需要更新時,請更新相應訂閱;若客戶端提供自動更新選項,再依實際需求啟用。
  4. 選取伺服器後執行 Connectivity Test,並以實際請求驗證;測試通過不代表所有目標都能連線。

注意事項:訂閱連結可能包含個人驗證資訊,請勿放入公開截圖、記錄或討論內容。訂閱產生的項目可能在更新時遭到覆寫;若需長期修改參數,應先另存副本,並確認與後續維護方式相容。刪除訂閱前也請確認是否要保留其中的伺服器,避免將「更新」誤操作為「移除」。

清單為空時,先檢查來源連結與回傳內容,再確認自己的服務狀態;若清單有項目但無法連線,則應檢查伺服器參數與網路。兩類問題的發生環節不同,不要反覆重新匯入,將問題混為一談。詳細匯入步驟請見入門指南。

On Demand 按需連線

控制何時嘗試建立連線,與規則決定請求如何路由屬於不同層面。

先建立可用的手動連線

是什麼:On Demand 利用系統支援的條件觸發連線行為。在哪裡:在 Settings 中尋找 On Demand;實際可設定的條件依目前系統與客戶端介面而定。如何設定:先關閉自動觸發,手動確認伺服器、Config 與連線授權均正常,再逐項新增需要的按需條件。

再確認觸發與停止條件

注意事項:啟用後,手動中斷連線可能因條件仍成立而再次觸發連線,這不一定表示開關失效。測試時請記錄目前的網路條件,分別檢查符合與不符合觸發條件時的結果。若要暫停自動連線,應先調整或關閉 On Demand,再操作連線開關,避免將重複觸發誤判為伺服器故障。

切換網路不保證既有連線完全不受影響。Wi-Fi 與行動網路之間切換可能導致重新建立連線,背景行為也會受到系統排程影響。On Demand 無法修復失效的訂閱或伺服器,也不能取代規則設定;完成觸發測試後,仍須確認實際請求採用了預期策略。

Data 流量統計

是什麼:Data 用來查看客戶端記錄的流量,協助判斷特定使用期間是否有送出請求,以及流量分布是否符合預期。在哪裡:開啟 Data,依目前介面提供的統計項目查看;各平台的細項與統計週期可能不同。

如何設定:先確認頁面顯示的是累計值還是目前週期的數值,再執行一次可重現的存取並比較前後變化。若準備重設統計,請先記錄需要保留的數字,避免清除後失去問題發生時的參照。查看下載與上傳時,請區分流量方向,不要混淆即時速率與累計流量。

注意事項:客戶端、裝置系統與服務商記錄的計算範圍可能不同,協定額外開銷、連線時間與統計週期也可能有差異,因此 Data 不能直接當作線路計費帳單。流量增加只能表示有活動,不能據此證明某個網頁請求一定成功;若流量沒有增加,也應先確認查看的是正確週期與記錄範圍。

Settings 常用項目

先記下原始值,再逐項修改;同時檢查設定檔內設定與全域設定。

DNS:網域解析

是什麼:DNS 會將網域名稱解析為位址,是連線及部分規則判斷的前置步驟。在哪裡:在 Settings 中尋找 DNS,並檢查目前 Config 是否包含相關設定。如何設定:先確認實際生效的設定來源,再依網路環境填入可連線的解析服務,並保留原始值以便還原。

注意事項:不要只因「連線失敗」就更換 DNS。網域解析成功與目標連線成功是不同階段;修改後也可能受到快取或舊連線影響。若問題只與 IPv6 有關,請檢查位址與連線路徑是否相符,不要同時修改 DNS、協定與規則。

Test Method:測試方式

是什麼:Test Method 決定相應的連通性測試採用哪種方式。在哪裡:在 Settings 中尋找 Test Method,並搭配 Home 的 Connectivity Test 使用。如何設定:選用目前介面提供的方式,在相同網路、相同伺服器及相近時間內比較結果。

注意事項:不同測試方式測量的對象不盡相同,數值不可直接比較。測試逾時可能與測試目標有關;測試成功也不代表所有網站或 App 都正常。最終仍應以實際目標請求及診斷記錄作為判斷依據。

Today Widget:快速入口

是什麼:系統支援時,Today Widget 可提供快速操作入口。在哪裡:在 Settings 中尋找 Today Widget,並於系統允許的元件管理介面確認是否可新增。如何設定:依目前顯示的選項設定,先在 App 內確認連線正常,再測試元件操作。

注意事項:元件能否新增、重新整理及顯示哪些內容,會受系統版本限制。若目前系統沒有提供相應入口,就不必尋找不存在的開關;直接從 Home 操作連線即可。元件顯示可能有所延遲,排查連線狀態時請返回 App 確認。

iCloud:設定同步

是什麼:iCloud 相關功能可在支援的 Apple 裝置間儲存或同步客戶端允許的資料。在哪裡:在 Settings 中尋找 iCloud,並檢查系統中的 iCloud 權限與帳號狀態。如何設定:操作前先保留本機副本,確認要執行的是上傳、還原還是同步,再依介面提示操作。

注意事項:同步範圍以介面說明為準,不要預設所有伺服器憑證與執行狀態都會同步。多部裝置同時編輯可能導致覆寫或衝突,請先確認要保留哪個副本。此處的 iCloud 功能不代表可在所有平台間共用設定,也不是用來還原 App Store 購買記錄的入口。

Diagnostics:定位故障階段

是什麼:Diagnostics 提供目前客戶端支援的診斷資訊,協助區分解析、連線、驗證或規則處理等階段的問題。在哪裡:在 Settings 中尋找 Diagnostics;若目前平台將診斷功能放在其他位置,請以實際介面為準。如何設定:通常先依需求啟用或執行相關診斷,重現一次問題,再查看相應時段的結果。

  1. 記下問題發生時的網路環境、Global Routing 選項、目前 Config 與伺服器,先建立可供比較的條件。
  2. 只存取一個明確目標,記錄錯誤發生的時間與提示,避免同時執行大量測試造成干擾。
  3. 先確認網域能否解析,再檢查是否建立連線;若出現驗證或 TLS 提示,請檢查伺服器參數與裝置時間。
  4. 若只有在 Config 下出現異常,請檢查規則與策略;若在 Proxy 下也異常,則檢查伺服器與網路路徑。

注意事項:診斷結果只是線索,並非自動修復結論。不要將單一逾時資訊直接解讀為整個網路無法使用。若要保留記錄,請先確認其中是否包含訂閱連結、伺服器位址或驗證資訊;分享前移除敏感內容。排查完成後,請將臨時增加的記錄選項恢復至適當範圍。

常用設定檢查順序

分層檢查比同時重設多項設定更容易重現問題,也更方便還原。

  1. 確認來源。現有訂閱能否更新、伺服器欄位是否完整,以及是否誤選舊項目。
  2. 確認模式。日常使用時是否選擇 Config,暫時測試後是否忘記切回原模式。
  3. 確認設定檔。目前啟用的 Config 是否為剛修改的檔案,以及策略名稱是否存在。
  4. 確認解析與路徑。分別檢查 DNS、伺服器連通性與實際目標請求,不要以單一測試數值代替所有判斷。
  5. 確認自動行為。On Demand 是否再次觸發,以及 iCloud 或訂閱更新是否覆寫本機修改。
  6. 記錄並還原。每修改一項就重新測試,記錄有效變化;若沒有改善,先還原原始值,再檢查下一層。

若尚未完成第一次匯入,請先閱讀入門指南;需要了解規則關鍵字時,請參閱概念速查;若遇到商店取得、系統安裝或已購項目還原問題,請前往全平台下載說明及常見問題。這些問題與 Global Routing 的用途不同,不必透過重寫規則解決。