官方手冊 · 功能與設定

Shadowrocket
功能與常用設定

從 Global Routing 確認流量處理方式,再檢查規則、伺服器與連線條件。本文以 iPhone、iPad 使用者已有訂閱或伺服器資訊為前提,依「用途、位置、設定、注意事項」說明操作。

  • Config / Proxy / Direct
  • 規則與策略
  • On Demand
  • DNS 與診斷

Shadowrocket 是 Apple 平台的付費商業 App,唯一取得管道為 App Store。系統需求請以 App Store 頁面標示為準。

流量處理入口

Global Routing:Config、Proxy 與 Direct

是什麼:Global Routing 決定用戶端如何選擇連線路徑。Config、代理與直連分別對應介面中的 Config、Proxy、Direct。這三項是路由選擇,不是三台伺服器,也不代表伺服器使用哪種協定。

在哪裡:在 Home 開啟 Global Routing 查看目前選項。這裡的 Config 是路由模式;底部同名的 Config 頁面則用來管理設定檔。兩者相關,但不是同一個入口。

先依用途選擇模式,再確認連線結果。
介面選項 處理方式 適用情境 檢查重點
Config
設定
依據目前生效設定檔中的規則選擇策略。 日常依網域、位址或地區條件分流。 確認選取的設定檔及規則順序。
Proxy
代理
以代理模式處理流量。 暫時比對規則分流與代理連線結果。 確認目前伺服器可用;不能據此推斷每條規則是否正確。
Direct
直連
以直連模式處理流量。 比對目前網路直接連線的結果。 直連結果不代表代理伺服器的連線狀態。

如何設定:已有完整分流設定時,先在 Config 頁面確認使用中的檔案,再將 Global Routing 設為 Config。需要釐清問題時,可暫時切換至 Proxy 或 Direct,以同一個目標進行比對;測試結束後請恢復原設定。

注意事項:切換模式只會改變路由處理方式,不會補上伺服器位址、驗證資訊或 DNS 參數。若某個網站在 Proxy 下可瀏覽、在 Config 下失敗,應繼續檢查規則命中情況與策略去向,不要立刻重新匯入所有伺服器。直連模式也不等於關閉系統中的 VPN 設定;需要中斷連線時,請檢查 Home 的連線開關。

設定檔與比對邏輯

規則分流:比對條件與處理策略

是什麼:規則由比對類型、比對內容和策略組成。比對條件用來判斷「這項請求屬於哪一類」,策略則決定「命中後如何處理」。PROXY 表示交由代理處理,DIRECT 表示直連,REJECT 表示拒絕。若設定引用自訂策略名稱,也要確認對應策略的定義。

在哪裡:前往 Config 頁面檢查目前的設定檔,並在規則編輯入口或檔案的 [Rule] 區段查看規則。若要讓這些規則參與路由,Global Routing 應設為 Config。

DOMAIN MATCH

網域類條件

DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對指定網域及其子網域;DOMAIN-KEYWORD 檢查網域是否包含指定字串。後兩者的比對範圍不同,不要只因名稱相似就互換。

ADDRESS MATCH

位址類條件

IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍;GEOIP 依據位址歸屬資料進行比對。網域請求是否會進入位址類比對,也與解析結果及設定選項有關。

如何設定:先備份目前檔案,再新增範圍明確的目標規則。將具體條件排在較廣泛的條件之前,最後使用 FINAL 指定未由前面規則處理的請求要如何處理。以下的 example.com 僅供示範語法,不代表連線服務。

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

注意事項:規則會由上而下檢查,命中後通常不再比對後續規則。若把涵蓋範圍很廣的條件排在前面,後面的具體規則可能不會生效。FINAL 是預設兜底規則,不是「再次嘗試所有路徑」。修改後請確認檔案已儲存、設定檔已選取,並以實際請求檢查結果。更完整的比對範圍說明請見規則關鍵字與比對順序。

連線參數管理

訂閱與伺服器:匯入、更新與選取

是什麼:單筆伺服器記錄會儲存位址、連接埠、協定及驗證等連線參數;訂閱則用來讀取並更新一組伺服器記錄。訂閱管理與規則設定是兩回事,匯入伺服器不代表分流規則已設定完成。

在哪裡:Home 的 SERVER 區域可查看並選取現有伺服器。手動填寫時使用 Add Server;匯入現有訂閱時,請在新增入口選擇 Subscribe。已有 QR Code 可使用 Scan QR Code 掃描;匯入前仍應確認內容來自你已有的設定來源。

如何設定:手動新增時,先選擇與伺服器端相同的協定,再逐項填寫位址、連接埠及驗證欄位。若涉及 TLS、傳輸方式或其他附加參數,請依據已有的伺服器資訊填寫,不要靠反覆猜測參數來測試。匯入訂閱後,先確認預期的群組是否出現,再選取一台伺服器進行測試,最後才啟用連線。

更新訂閱前,先分清哪些記錄由訂閱管理,哪些是手動新增。訂閱產生的記錄可能在更新時被取代或移除,直接修改前請先保留必要資訊。訂閱名稱相同,也不代表其中所有伺服器使用相同協定或參數。

注意事項:訂閱網址可能包含存取憑證,不應貼在公開截圖、公開文章或診斷留言中。匯入失敗時,先確認連結是否完整、是否多了空格,再檢查目前網路能否讀取內容。匯入成功只代表用戶端讀取到記錄,不代表每台伺服器都能連線。

用戶端一次買斷 ≠ 連線服務方案。購買 Shadowrocket 取得的是用戶端使用權,不包含連線服務。本網站不提供、不販售、不推薦節點或訂閱;操作說明以使用者已有自己的訂閱或伺服器資訊為前提。

想了解協定欄位,請接著閱讀協定參考;首次新增與連線的完整步驟請見使用說明。

連線觸發條件

On Demand:依條件觸發連線

是什麼:On Demand 用來依預設條件管理 VPN 連線觸發時機。它處理「何時連線」;Global Routing 與設定規則則處理「連線後如何路由」。啟用前者不會自動修正後者。

在哪裡:在 Settings 中開啟 On Demand,查看目前可設定的條件。實際可用條件與顯示位置請以 App 內頁面為準;設定時也可能需要檢查系統中的 VPN 設定狀態。

如何設定:先停用自動觸發的影響,手動完成一次連線與瀏覽驗證,確認伺服器和設定都可正常使用。接著再設定所需的網路條件,每次只調整一項。切換至目標網路後,分別觀察系統 VPN 狀態、Home 連線狀態及實際瀏覽結果,確認觸發行為符合預期。

注意事項:按需連線不是修復伺服器故障的功能,也不保證網路切換時所有現有連線都能持續。若手動中斷後又自動連線,請先檢查 On Demand 條件及系統 VPN 設定,不要只靠反覆切換開關來判斷是否異常。排查連線問題時,先記錄原有條件,暫時排除自動觸發因素;完成手動測試後再還原設定。

使用記錄與統計範圍

Data:查看流量,不等同於伺服器端記錄

是什麼:Data 顯示用戶端記錄的流量使用情況,可用來觀察一段使用期間的上傳與下載變化。這是排查線索,不是頻寬測試,也不是伺服器端的計費憑證。

在哪裡:開啟底部的 Data 頁面,先確認目前顯示的統計項目與時間範圍,再查看數值。不要直接加總或比較統計口徑、時間區段或裝置不同的結果。

如何設定:若要觀察某項操作,先記下目前統計數據與時間,再進行一段可重複的瀏覽操作,之後回到 Data 比對變化。若頁面提供清除統計的功能,執行前請先保存需要的記錄;清除統計不等於重新整理伺服器狀態。

注意事項:背景 App、系統請求及連線重試也可能產生流量。用戶端與伺服器端的統計範圍、起訖時間及協定額外負荷的計算方式可能不同,因此數字不一致不代表其中一方一定出錯。若要確認某條規則是否命中,應搭配連線記錄與目標請求檢查,不要只根據流量增加推斷路由策略。

Settings 常用項目

DNS、測試方式、快速入口與同步

Settings 集中放置 App 設定與相關工具入口。部分行為也可能由目前的設定檔控制,調整前應先分清 App 設定與檔案參數。以下項目請以 App 內實際顯示的選項為準,不必一次全部啟用。

DNS:網域解析與路由的配合

是什麼、在哪裡:DNS 會將網域解析為位址,相關選項可在 Settings 的 DNS 入口檢查;目前設定檔的 [General] 區段也可能包含 DNS 參數。進入設定前,先記下正在使用的設定檔,避免忽略檔案設定對解析行為的影響。

如何設定與注意事項:依照現有網路與設定需求填寫解析參數,每次只調整一項,再以相同網域重新測試。伺服器測試有結果,但網頁仍無法開啟,可能是解析失敗、解析結果不適用或後續連線失敗。不要只憑一次測試結果就更換所有 DNS 設定;先確認問題發生在解析階段還是連線階段,詳見DNS 解析失敗排查。

Test Method:確認測試項目

是什麼、在哪裡:Test Method 用來選擇連線測試方式,可在 Settings 中查看。Home 的 Connectivity Test 用來啟動測試。不同測試方式涵蓋的連線環節可能不同。

如何設定與注意事項:比較伺服器前,固定測試方式、測試目標與目前網路,再重複觀察結果。不要把不同方式測得的數值混在一起當作同一結論。測試成功不代表所有網站都能瀏覽,測試時間也不等於實際下載速度。若只有測試失敗、實際瀏覽卻正常,請先檢查測試目標與測試方式。

Today Widget:快速操作入口

是什麼、在哪裡:Today Widget 用來查看或設定相關快速顯示與操作,可在 Settings 中檢查對應選項。能否加入系統的指定位置,請以裝置目前提供的元件入口為準。

如何設定與注意事項:先在 App 內完成伺服器選取與連線驗證,再依系統提供的元件編輯方式新增入口。使用快速操作後,返回 Home 確認實際狀態。元件畫面可能有更新間隔,不要只把某一刻顯示的文字當成完整的連線診斷;元件也不會替你補上尚未匯入的伺服器資訊。

iCloud:確認同步項目與覆寫方向

是什麼、在哪裡:iCloud 相關功能可在 App 支援的範圍內儲存或同步資料,請在 Settings 檢查相關入口,並確認系統允許 Shadowrocket 使用 iCloud。同步功能與透過 App Store 還原已購項目是不同機制。

如何設定與注意事項:先保留目前裝置的重要設定,再閱讀 App 內對同步項目、上傳或還原操作的說明。另一台裝置讀取資料前,應核對目前內容與修改時間,避免較舊資料覆寫正在使用的設定。App 購買記錄不會自動補上伺服器驗證資訊;同步後仍須分別檢查選取的伺服器、設定檔與路由模式。

Diagnostics:針對單次故障蒐集線索

是什麼、在哪裡:Diagnostics 是診斷工具入口,可在 Settings 中尋找。它用來取得排查線索,不能只憑單一結果就判定所有連線環節都正常。

如何設定與注意事項:先記錄故障目標、目前網路、路由模式及重現步驟,再執行相關診斷。保存與這次故障相符的結果,避免混入多次修改後的無關資訊。分享記錄前,請檢查並遮蔽訂閱網址中的存取憑證、密碼、驗證欄位及其他個人資訊。診斷結果應分別與 DNS、伺服器連線及規則命中情況比對,不能取代這些檢查。

調整前後檢查清單

每次只變更一個變數

排查時先建立可重複的基準。記下目前使用的網路、選取的伺服器、設定檔與 Global Routing,再選擇一個明確目標進行瀏覽。如此才能判斷某次修改是否改變結果,而不是把網路波動誤認為設定生效。

  1. 檢查參數是否完整。確認伺服器位址、連接埠、協定與驗證資訊來自你已有的設定,先排除漏填或複製錯誤。
  2. 檢查連線與測試。手動連線後執行 Connectivity Test,並記錄 Test Method,不要只保留單一數值。
  3. 檢查路由模式。使用 Config 時,確認目前的檔案與規則。暫時切換其他模式進行比對後,請恢復原設定。
  4. 檢查解析環節。若已建立連線但無法瀏覽網域,請分別檢查 DNS 結果與後續連線,不要把所有故障都歸因於伺服器。
  5. 恢復自動功能。手動操作穩定後,再恢復 On Demand 與快速入口,並觀察網路切換後的狀態。

編輯設定檔前,先保留可還原的副本。訂閱更新、設定修改、DNS 調整與網路切換應盡量分開進行。若一次同時變更多項設定,即使恢復正常,也很難判斷真正發揮作用的是哪一項。

首次設定請依使用說明逐步完成;協定欄位與選擇方式請見協定參考;購買、還原與商店資訊核對請見App Store 正版確認說明。開發者為 Shadow Launch Technology Limited,App ID 為 932747118。

前往 App Store 下載 Shadowrocket