Shadowrocket 官方手冊 / 功能與設定

Shadowrocket 代理模式

先在 Home 確認 Global Routing,再檢查規則、伺服器與連線條件。遇到連線異常時,每次只變更一項,並以同一目標重新測試。

Global Routing
連線如何處理
On Demand
連線何時啟動
Data
流量統計數據
01 路由方式

Global Routing 三種模式

在 Home 開啟 Global Routing,可選擇設定檔(Config)、代理(Proxy)或直連(Direct)。這項設定決定納入客戶端處理的流量如何傳送,不會決定連線何時啟動,也不會改寫 Config 中儲存的規則。以下以這些介面用語為索引;各平台的入口位置請以實際介面為準。

依流量處理方式與測試情境選擇
模式處理方式適用情境
設定檔(Config) 依目前啟用的設定檔比對規則,再執行符合項目的策略。 需要依網域或位址分別處理連線時使用。先確認實際啟用的設定檔,再確認目標符合哪一條規則。
代理(Proxy) 不逐條依設定檔分流,而是將進入此模式處理範圍的連線交由所選的代理伺服器。 已有伺服器,想單獨測試是否能連到特定目標時,可暫時使用。測試完成後請切回日常模式。
直連(Direct) 客戶端仍處於連線狀態時,相關流量不會經由代理伺服器轉送。 用來比對目前網路是否能直接連到目標。若要確認完全停用客戶端時的情況,請另外關閉連線。

例如,某個網站在 Proxy 模式下可以連線,在 Config 模式下卻失敗,應先檢查是否符合預期策略,而不是直接更換伺服器。反過來說,如果同一目標透過代理連線失敗,但直連正常,再檢查伺服器資料與代理路徑。比對時請維持相同的 Wi-Fi 或行動網路,並重新送出請求;既有連線可能仍沿用切換前的路徑。

Proxy、Direct 是模式;PROXY、DIRECT 則是設定檔中的策略。選擇全域模式與命中某條規則的策略,是兩種不同操作。

02 比對順序

規則類型與分流策略

在 Config 找到目前啟用的設定檔,開啟其規則清單,再回到 Home 確認 Global Routing 設為 Config。規則用來指定比對條件與處理方式:DOMAIN 比對特定主機名稱,DOMAIN-SUFFIX 比對指定網域及其子網域,DOMAIN-KEYWORD 則依主機名稱中包含的字串比對,涵蓋範圍較廣。若只想處理單一主機,建議先用 DOMAIN,避免名稱相近的其他主機也符合規則。

IP-CIDR 與 IP-CIDR6 分別比對 IPv4、IPv6 網段;GEOIP 依 IP 位址的地理分類比對,不是依網域後綴判斷。USER-AGENT 則須視是否能讀取相應的請求識別資訊而定,不能假設所有連線都會提供這項資料。若目標可能透過網域名稱連線,也可能直接使用 IP 位址,重新測試時請分開檢查這兩種方式。

PROXY 會將符合規則的連線交由代理處理,DIRECT 會直接連線,REJECT 則會拒絕連線。以下僅示範規則順序:特定主機直連,同一網域下的其他主機走代理,其餘請求由 FINAL 作為後備處理。

DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

規則通常依序檢查,符合後便採用相應策略。若將範例前兩條規則對調,docs.example.com 會先符合範圍較廣的後綴規則。修改前請保留原設定檔,並將特定規則放在廣泛規則之前,最後再確認後備策略。儲存後,請確認目前生效的是剛編輯的檔案;若只在預覽畫面中修改,或仍啟用另一份設定檔,後續的連線測試便無法驗證這次修改。

03 既有連線資料

匯入訂閱與管理伺服器

訂閱可用來管理一組既有伺服器項目;手動新增伺服器則適合只設定一個已知端點。若手上有服務供應商提供的訂閱網址,請在 Home 開啟 Add Server,選擇 Subscribe,輸入網址後儲存。若已有單一伺服器的參數,請在 Add Server 選擇相符的協定,再填入位址、連接埠及該協定所需欄位。請勿將訂閱網址填入單一伺服器的位址欄。

匯入完成後,回到 Home 的伺服器清單,確認項目已顯示,再選擇一筆執行 Connectivity Test。測試結果會受到測試方法與目標影響;測試通過後,仍須在預計使用的 Global Routing 模式下連線至實際目標。若測試失敗,先核對協定、位址、連接埠等原始資料,再判斷是單一伺服器有問題,還是同一訂閱中的多筆資料都無法連線。

更新訂閱前,先記下目前使用的項目;遠端更新後,名稱、位址或項目數量可能改變,舊項目不一定仍可選用。訂閱網址可能含有存取憑證,請勿將完整連結貼到共用文件、公開截圖或診斷紀錄中。本網站僅說明如何使用你已有的訂閱或伺服器資料,不提供、販售或推薦這些服務。

04 連線條件

On Demand 按需連線

On Demand 會依設定的網路條件觸發連線,並非每次瀏覽時才臨時選擇分流規則。請先在 Home 手動確認連線正常,再到 Settings 尋找 On Demand,依目前平台顯示的條件設定適用範圍。建議先從容易重現的情境開始,例如從 Wi-Fi 切換至行動網路,再確認連線是否如預期啟動。

重新測試時,請同時觀察會觸發與不會觸發的情境。若手動中斷後連線又恢復,先確認目前網路是否仍符合 On Demand 的觸發條件;若要測試純手動連線,可暫時關閉按需連線,排查完成後再恢復。若出現頻繁重新連線或待機耗電增加,先觀察網路是否反覆切換,並比較相近時段的情況,再決定是否縮小觸發範圍。

05 流量觀察

Data 流量統計

在 Data 查看客戶端記錄的流量,先確認介面顯示的是累計值還是特定統計區間,以及目前查看的是上傳或下載。若要判斷單次操作增加了多少流量,可先記下起始數值,再於同一網路下完成一次可重現的操作,最後記錄結束數值。這樣比直接清除統計資料更能保留歷史,也方便將差值與操作時間對照。

背景同步、媒體預載入及重複請求都可能讓數值持續增加。若同一時段有多個應用程式在活動,總流量差值無法單獨證明某次請求用了多少流量。Data 呈現的是客戶端的統計方式,不等同於系統行動網路用量或服務供應商帳單;若要確認某次連線採用的策略,請查看規則比對結果或診斷紀錄,不要只憑流量數值推斷。

06 設定與疑難排解

Settings 常用項目

先記錄目前的設定與數值,再依問題調整。解析異常時檢查 DNS,測試結果不一致時檢查 Test Method,自動重新連線時檢查 On Demand。請勿同時變更多個項目,否則即使連線恢復,也難以判斷是哪項設定發揮作用。

DNS:網域名稱解析

DNS 會決定網域名稱如何解析。在 Settings 查看目前設定,也確認已啟用的 Config 是否定義了解析選項。若網路原本正常,維持目前設定即可;需要調整時,先確認異常發生在一般網域,還是僅限區域網路名稱,再一次只更改一項,並以相同網路和網域重新測試。既有連線或快取可能讓結果不會立即改變;解析成功也不代表後續連線一定能建立。

Test Method:連線測試方法

Test Method 用來選擇連線測試方式。前往 Settings 查看可用選項,再回到 Home,對同一台伺服器執行 Connectivity Test。比較多個項目時,請保持測試方法、目標及網路條件一致;不同方法測量的環節不同,結果不宜直接比較。低延遲不能取代實際連線驗證,也不能據此判斷傳輸速度。

Today Widget:快速存取

在支援此功能的裝置上,可透過 Today Widget 系統小工具查看狀態,或使用介面提供的快速操作。先在 Settings 檢查此選項,再到系統小工具介面新增。若面板狀態未即時更新,請以開啟 Home 後顯示的連線狀態為準;若要變更路由模式或確認目前設定,仍須在客戶端內操作。

iCloud 同步:跨裝置使用設定檔

若要在支援 iCloud 的裝置間使用同一份設定檔,請先在 Settings 確認同步選項與實際同步範圍,再確認各裝置使用的是預期帳號。啟用前請備份重要設定檔,並選擇一份容易辨識的設定檔,確認另一台裝置是否收到。檔案出現不代表功能已啟用,也不表示連線權限會一併移轉;接收端仍須確認目前設定檔並單獨測試連線。

Diagnostics:找出連線失敗原因

在 Settings 開啟 Diagnostics,使用明確的目標重現問題,並記下發生時間、網路類型及當時的 Global Routing。若工具顯示請求紀錄,請依可見資訊判斷是網域解析失敗、規則路由不符,還是伺服器連線失敗;僅憑一筆逾時紀錄,無法斷定是伺服器端故障。對外分享前,請移除訂閱網址、帳號欄位、私人網域及不必要的存取紀錄。

查看 Settings 設定詳解 →

全平台取得與使用說明

iPhone / iPad 版請從 App Store 產品頁取得,美國商店售價為 $2.99,一次性付費,購買後可在 iPhone 和 iPad 上使用;系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片 / Intel)、Windows、Android 和 Linux 版免費,安裝檔由本站 /dl/ 提供。確認商店項目時,請核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。

客戶端一次性買斷 ≠ 連線服務方案。 設定連線時,請使用自己已有的伺服器資料或訂閱。首次設定請依使用說明操作;若要下載或查看各平台的安裝及首次開啟放行步驟,請前往全平台下載頁。