官方手冊 / 設定參考
Shadowrocket 功能與設定
先在 Home 確認流量如何轉送,再檢查 Config 中的規則;需要自動連線或排除異常時,再調整 Settings。以下以 iPhone / iPad 介面為例。
Global Routing
在 Home 選擇分流模式
連線開關與分流模式是兩項不同設定。連線開關控制 Shadowrocket 是否接管流量,Global Routing 則決定如何處理已接管的流量。在 Home 開啟 Global Routing,選擇 Config、Proxy 或 Direct。初次設定時,可先選 Proxy 確認伺服器能否轉送流量,再切回 Config 驗證實際規則。
| 介面選項 | 流量處理方式 | 適用情境 |
|---|---|---|
| Config(設定) | 依目前設定的規則與策略處理。 | 日常分流,例如讓區域網路服務直連,其他指定請求則使用代理。 |
| Proxy(代理) | 將已接管的流量交由目前選取的代理伺服器處理。 | 暫時排除規則比對的影響,以確認伺服器能否轉送流量。 |
| Direct(直連) | 已接管的流量直接連線至目標,不經過代理伺服器。 | 比較目前網路的直連狀況。 |
排查時請維持網路、伺服器和測試目標不變,每次只切換一項設定。Proxy 可用但 Config 不可用時,先確認是否已啟用預期的設定檔,再檢查規則是否已被前面的項目比對。Direct 也失敗時,先確認目前網路能否連線至該目標。Direct 不等於關閉連線;若要比較完全不經 Shadowrocket 接管的結果,請關閉 Home 的連線開關後再測試。
規則分流
在 Config 編輯比對條件與處理策略
每條規則由比對條件與處理策略組成。在 Config 確認目前啟用的設定檔,並保留一份原始設定以便還原,再編輯其中的 Rule。儲存後回到 Home,確認 Global Routing 已選擇 Config。若編輯的是另一份設定檔,單純儲存並不會使其生效。
- 依網域比對:
DOMAIN比對指定主機名稱;DOMAIN-SUFFIX比對網域及其子網域;DOMAIN-KEYWORD比對網域中的指定字串。只想涵蓋單一主機時,優先使用DOMAIN,避免關鍵字誤比對到其他網域。 - 依 IP 位址比對:
IP-CIDR和IP-CIDR6分別比對 IPv4、IPv6 網段;GEOIP依目標 IP 的地理區域分類比對,而非依網域後綴或裝置所在地判斷。同一網域解析至不同位址時,IP 比對結果可能隨之改變。 - 依請求特徵比對及設定預設處理方式:
USER-AGENT需依賴請求中可辨識的 User-Agent,不適合作為所有連線的通用條件。FINAL用於處理先前未比對到的請求,應放在規則清單末尾。
常用策略包括 PROXY、DIRECT 和 REJECT,分別用於代理轉送、直接連線和拒絕請求。規則通常依序比對,由第一個符合條件的項目決定流量走向。較具體的例外規則應放在範圍較廣的規則之前;否則即使後面的例外設定正確,也可能無法生效。
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
此範例會先讓 status.example.com 符合直連規則,example.com 及其其他子網域則走代理,未符合規則的請求會直連。範例僅用來說明規則順序,並非完整設定檔。驗證時,請分別以新請求存取例外目標和一般目標;如仍有疑問,請參閱規則語法與比對順序,逐步縮小排查範圍。
訂閱與伺服器
在 Home 管理 SERVER 清單
SERVER 清單會儲存可供選用的伺服器。若已有單一伺服器的參數,可手動新增:在 Home 開啟 Add Server,選擇服務商指定的協定,填入相應的位址、連接埠和驗證資料後儲存。各協定所需欄位不同;遇到不熟悉的欄位,請先核對服務商提供的資料,不要將某個協定的設定直接套用到另一個協定。
訂閱可匯入並更新一組伺服器,訂閱網址請向你的服務商取得。在 Add Server 選擇 Subscribe,填入已有的訂閱網址並儲存,再回到 SERVER 確認是否出現相應項目。續約或更換訂閱網址後,請更新相應的訂閱群組,並重新確認目前選取的伺服器;舊項目可能已被替換,清單中仍有項目不代表目前使用的伺服器仍可用。
請分開檢查「訂閱能否更新」、「伺服器能否通過 Connectivity Test」及「目標服務能否連線」。訂閱更新成功只代表用戶端取得清單,不表示清單中的每台伺服器都能連線;測試通過也不代表目前規則一定會將目標請求交給該伺服器。向他人求助時,可提供協定名稱和出錯步驟,請勿附上完整訂閱網址、驗證資料,或包含這些資訊的畫面截圖。
On Demand
在 Settings 設定連線啟動時機
On Demand 可設定系統在符合條件時是否自動建立 VPN 連線;它不會取代 Global Routing,也不會自動將 Config 切換為 Proxy。建議先在 Home 手動建立一次連線,並確認系統 VPN 設定權限已就緒,再到 Settings 開啟 On Demand,依介面提供的網路條件設定自動連線範圍。
初次設定時,請只驗證一種條件。例如只確認連上特定 Wi‑Fi 網路後是否會自動連線:先確認網路名稱符合條件,再離開並重新連上該網路,回到 Home 查看連線狀態。確認這項設定有效後,再新增其他條件。飯店或公共 Wi‑Fi 若需先完成網頁認證,可先完成認證再測試自動連線;認證前後的網路連線狀況並不相同。
若手動中斷連線後又自動重新連上,請先檢查目前網路是否仍符合 On Demand 條件,而非一再關閉 Home 的開關。排查時可暫時停用 On Demand,手動測試相同目標;若手動連線也失敗,請優先檢查網路、伺服器和分流設定,確認手動連線正常後再恢復自動連線。
Data 流量統計
記錄基準值,再比較上傳與下載
Data 可查看用戶端記錄的流量。開啟 Data 後,先確認目前檢視的統計範圍、時間範圍和單位,再比較上傳與下載數據。若要驗證單次操作,可先記下目前數值,再發出一次可控制的小流量請求,完成後回到相同畫面查看增量。測試期間請盡量避免同時播放影片或下載檔案,背景活動也可能計入同一時段。
Data 的統計範圍、計量方式和時間區間可能與服務商帳單不同,無法直接用來核對連線服務的流量餘額。數值沒有變動時,先確認連線仍在使用中、請求並非直接讀取快取,並檢查目前畫面是否包含該連線。清除統計前,請先確認操作影響範圍;若要比較調整前後的變化,記錄原始數值和測試時間,會比只保留總量截圖更有幫助。
Settings 常用項目
釐清 DNS 解析、測試、快速入口與同步
DNS:先確認由哪份設定檔決定解析
DNS 會將主機名稱解析為 IP 位址,解析異常有時會看起來像伺服器無法連線。若只有部分網域連線失敗,先在 Config 檢查目前設定檔中與 DNS 相關的設定;若設定檔的 [General] 中包含 dns-server,修改前請先記下原始值。每次只修改一項設定,重新建立連線後,使用相同網域發出新請求。若區域網路服務的名稱原本由本機網路解析,貿然改用其他 DNS 可能反而導致這些名稱無法解析。
Test Method:先統一測試條件
Test Method 決定 Connectivity Test 如何判斷連線結果。在 Settings 查看目前的 Test Method,選擇符合排查目標的方式,再回到 Home 執行 Connectivity Test。如果介面也能調整測試目標,請使用相同目標比較調整前後的結果。單次逾時可能是測試目標或目前網路造成;單次成功也不代表其他網站都能連線。若要確認實際服務是否可用,還需測試遇到問題的目標。
Today Widget:確認快速入口的操作範圍
Today Widget 是快速入口,不是另一種分流模式。若 Settings 提供 Today Widget,請先在用戶端確認相關設定,再到系統的小工具管理介面查看是否能加入。新增後可試著執行一次連線操作,再回到 Home 核對最終狀態及目前的 Global Routing。若系統沒有列出相應的小工具,直接在 Home 操作即可,不必因此更改規則或伺服器。
iCloud 同步:確認同步內容後再跨裝置啟用
在 Settings 查看 iCloud 相關選項,先確認可同步哪些項目,並檢查兩台裝置是否登入相同的 iCloud 帳號。可先以一項不含憑證的設定變更測試同步,再到另一台裝置確認實際啟用的設定檔。請勿將同步視為完整備份,也不要假設同步會一併複製系統 VPN 權限或目前的連線狀態;更換裝置後應逐項確認。
Diagnostics:記錄可重現的問題
若反覆發生逾時或斷線,先記下發生時間、網路類型、Global Routing 模式及失敗範圍。若 Settings 提供 Diagnostics,可在問題重現期間查看診斷資訊,再比對 Home 的連線狀態與 Connectivity Test 結果。不同次測試盡量維持相同條件;分享記錄前,請移除伺服器位址、訂閱連結、驗證欄位及不必要的瀏覽記錄,只保留排查問題所需資訊。
用戶端取得方式與相關手冊
iPhone / iPad 版可於 App Store 產品頁以 $2.99 一次買斷,系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費;安裝檔及各系統首次開啟時的允許方式,請參閱下載用戶端;安裝檔由本站 /dl/ 提供。
尚未完成首次連線,可先參閱快速入門。需要依階段檢查權限、連線和日常維護時,請參閱完整使用手冊;遇到特定錯誤訊息時,可查閱疑難排解。