官方手冊 · 功能介紹

Shadowrocket
功能與常用設定

先確認 Global Routing,再檢查規則、伺服器與網路狀況。依照這個順序設定,可區分「流量走哪條路徑」和「何時建立連線」,避免同時變更多個選項而難以判斷原因。

  • 先保留原有設定
  • 每次調整一項
  • 以同一目標重新測試

01 · 流量路徑

Global Routing 三種模式

Global Routing 決定客戶端如何處理進入其網路通道的流量,並非連線是否成功的指標。在 Home 找到此項目,先確認目前選取的是 Config、Proxy 或 Direct,再判斷實際行為。

模式與介面用詞 處理方式 適用情境 確認重點
設定 · Config 依目前生效設定中的規則決定處理策略。 日常依網域、位址或其他條件進行分流。 確認已選取預期設定,並檢查規則順序與最終策略。
代理 · Proxy 對進入通道且未遭系統或設定排除的流量,採用代理路徑。 暫時判斷問題是否來自分流規則。 確認目前伺服器可用;此模式並不代表會接管所有系統通訊。
直連 · Direct 客戶端處理的流量一律採用直連路徑。 與代理路徑交叉測試,檢查本地網路是否正常。 Direct 不等於關閉連線開關,也不等於刪除系統 VPN 設定。

設定時先在 Home 選取 Global Routing,再選擇所需模式。使用 Config 時,應前往 Config 確認目前生效的檔案,而非只確認清單中是否有該檔案。檔案已匯入、已編輯及已生效是三種不同狀態。

若同一目標在 Proxy 下可正常連線、在 Config 下卻不行,請優先檢查命中的規則與策略。若兩種模式都失敗,再檢查伺服器、DNS 與目前網路。交叉測試後請恢復原本模式,避免臨時排查設定影響後續使用。

02 · 比對與策略

規則分流與 Config

規則說明「比對哪些內容」,策略則說明「比對後如何處理」。在 Config 查看目前檔案中的規則;需要分流時,Global Routing 應設為 Config。

先看類型,再看排列順序

DOMAIN 比對指定網域,DOMAIN-SUFFIX 比對網域及其子網域,DOMAIN-KEYWORD 依網域中的關鍵字比對。後兩者涵蓋範圍較廣,關鍵字過短可能導致不相關的請求也符合同一條規則。

IP-CIDR 與 IP-CIDR6 用於比對位址範圍,GEOIP 則依 IP 地理資料庫分類。網域解析結果、資料庫內容及相關設定都會影響位址類規則的判斷,不能只憑網站名稱推斷一定會符合哪一條規則。

規則通常依序比對,前面第一條符合條件的有效規則會決定處理方式。請將具體規則排在涵蓋範圍較廣的規則之前,並確認結尾的 FINAL。它會處理前面規則都未符合的流量,不應視為一般網域條件。

策略須對應實際路徑

DIRECT 表示直連,REJECT 表示拒絕,PROXY 用於代理處理。設定也可能引用自訂策略群組;遇到群組名稱時,還要確認群組內實際選取的伺服器,不能只看規則末尾的文字。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,10.0.0.0/8,DIRECT
FINAL,DIRECT

以上片段用於說明比對邏輯,並非可直接取代現有設定的完整檔案。修改前請先保留原始檔案,再以已知網域重新測試。若請求符合 REJECT 規則,改用其他伺服器通常不會改變該規則的拒絕結果。

03 · 連線資訊

訂閱與伺服器管理

訂閱用於集中提供伺服器項目,個別伺服器項目則儲存連線參數;Config 用來設定規則及其他選項。三者彼此相關,但匯入其中一項不代表另外兩項也已設定完成。

Home、Add Server 與 Subscribe

以下操作以使用者已有自己的訂閱或伺服器資訊為前提。在 Home 開啟新增入口,進入 Add Server 後依內容選擇合適的 Type;使用訂閱連結時選擇 Subscribe,輸入完整連結並儲存。返回 Home 後確認是否出現預期群組,再選取要使用的伺服器。

手動新增時,Type 必須符合伺服器要求。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 的欄位各不相同,不能只更改 Type,卻沿用舊參數。請依現有資料逐項填寫位址、連接埠、驗證資訊及傳輸相關欄位;欄位說明請參閱協定技術參考。

更新後確認選取項目

在現有訂閱項目的操作選單中執行更新,再檢查群組中的伺服器是否如預期變更。更新訂閱主要是刷新其管理的伺服器資訊,不代表目前的 Config 也會一併替換。更新後名稱或項目數量可能改變,請重新確認目前選取的伺服器是否仍在清單中。

更新失敗時,先確認連結是否完整、目前網路能否取得內容,以及訂閱是否仍有效。請勿將含有存取憑證的完整連結貼在公開截圖或診斷紀錄中。刪除訂閱或項目前,先確認其所屬群組,避免將手動維護的項目與訂閱項目混淆。

04 · 連線觸發

On Demand 按需連線

On Demand 依據條件請求系統建立或調整連線。它回答「何時連線」,Global Routing 則回答「連線後如何處理流量」,兩者屬於不同層級的設定。

先手動連線,再新增條件

在 Settings 尋找 On Demand 相關設定;若目前介面需從連線選項進入,請以實際入口為準。啟用前先手動連線並測試存取,確認伺服器與設定本身可用,再新增 Wi-Fi、Cellular 或網域相關條件。

依 Wi-Fi 名稱設定時,請確認名稱完全相符。依 Cellular 設定時,必須實際切換至行動網路觀察;只在 Wi-Fi 下修改選項,無法驗證行動網路的觸發結果。網域條件涉及系統對網域請求的判斷,並非透過啟動特定 App 圖示觸發。

避免條件互相衝突

每次只新增一種條件,儲存後切換至對應網路,等待系統處理,再觀察連線狀態與實際存取結果。若同時設定多個條件,請檢查排列順序、比對範圍及動作,避免對同一網路同時設定互相矛盾的連線與中斷條件。

若手動中斷後又自動連線,請先檢查 On Demand 是否仍啟用。排查一般連線問題時,可暫時停用,避免自動觸發干擾測試;確認手動連線正常後再重新啟用。按需連線會由系統協助執行,不應將它視為隨時持續運作的排程工作。

05 · 使用狀況觀察

Data 流量統計

Data 用於查看客戶端記錄的流量狀況,可協助判斷請求是否經過目前連線,以及特定時段是否有資料傳輸;不應作為服務計費或剩餘流量的唯一依據。

先確認統計範圍

開啟 Data 後,先確認目前畫面的時間範圍、上傳與下載方向,以及可用的分類方式。不同畫面可能顯示目前連線或累積紀錄;只有統計範圍相同的數值才適合直接比較。若要清除紀錄,請先儲存有用資訊,再確認重設會影響哪個範圍。

驗證時可先記下目前數值,再存取已知目標,返回 Data 查看變化。數值增加只能表示有資料傳輸,不能單獨證明目標頁面已完整載入,也不能證明符合預期規則;還應搭配實際存取結果與連線紀錄一併確認。

客戶端與伺服器端的統計可能因協定額外開銷、統計週期及計數範圍不同而有差異。Data 未出現預期變化時,請依序確認連線開關、目前模式及請求是否遭排除,不要立即據此判斷伺服器無法使用。排查結束後保留必要紀錄即可,避免長期累積包含存取目標的資訊。

06 · 常用選項

Settings 檢查清單

Settings 中的選項可能依裝置與系統能力而異。找不到某個項目時,請先確認目前 App 介面;不要為了配合教學名稱而修改功能相近但意義不同的設定。

DNS:區分解析與連線

DNS 會將網域名稱解析為位址。請在 Settings 的 DNS 相關選項及 Config 的全域參數中確認解析設定;設定檔也可能影響最終行為,因此不能只修改一處就認定所有請求都已套用新設定。

先保留目前可用的值,再依明確需求修改。若設定使用 dns-server = system,表示採用系統的 DNS 解析來源,不代表代理伺服器一定正常。修改後請以同一網域重新測試;若解析成功但連線失敗,應繼續檢查路由與伺服器,而非反覆更換 DNS。

Test Method:了解測試項目

Test Method 決定連線測試採用的方式。在 Settings 找到此項目,確認測試方法與相關目標,再返回 Home 執行 Connectivity Test。比較伺服器時,應保持測試方法、目標與目前網路一致。

測試數值會受握手方式、目標回應及網路狀態影響,不等同實際下載速度,也無法保證所有網站都能使用。發生逾時時,先確認測試目標本身能否回應,再檢查伺服器參數;不要只根據一次測試結果刪除現有項目。

Today Widget:快速查看與操作

Today Widget 用於系統支援的快速入口或狀態顯示。在 Settings 尋找相關選項,再前往系統允許的元件區域進行設定;能否加入及可操作範圍,請以目前裝置系統和 App 介面為準。

先在 App 內確認連線正常,再驗證元件顯示或操作後的結果。元件狀態可能有更新延遲,不能取代 App 內的檢查。若元件與 App 顯示不一致,請先開啟 Home 確認實際連線,不要連續重複切換。

iCloud 同步:確認內容與方向

iCloud 相關選項可在支援範圍內儲存或同步 App 資料。在 Settings 檢查同步開關,同時確認系統已允許 App 使用 iCloud。啟用前先閱讀目前提示,確認將處理的是設定、伺服器資訊或其他內容。

同步不等於完整的裝置備份,也不保證立即完成。更換裝置時,先保留原裝置上的有效設定,再於另一部裝置確認同步內容。若出現覆寫、合併或還原提示,請先確認資料流向;訂閱連結與驗證資訊也應妥善管理。

Diagnostics:收集問題線索

Diagnostics 用於檢查連線問題或收集診斷資訊。在 Settings 找到相關入口後,先依目前介面說明啟用必要紀錄,再重現一次問題。記下當時的網路類型、Global Routing 模式、目標網域及錯誤狀況。

診斷紀錄可能包含存取網域、伺服器位址或設定細節。分享前請檢查並移除憑證與個人資訊,尤其不要公開完整訂閱連結。取得所需結果後,請停止額外記錄;紀錄越長不代表越容易找出問題,單次且可重現的樣本通常更容易判讀。

07 · 修改後重新測試

依相同順序驗證設定

連線圖示、測試數值與頁面存取分別反映不同環節。請至少分開確認「已建立連線」、「符合預期路徑」及「目標可正常使用」,才能判斷設定是否達到目的。

保留基準,再逐項排查

  1. 記錄目前狀態。確認 Home 中選取的伺服器、Global Routing 模式與 Config 檔案,保留修改前可正常使用的值;先暫停可能自動觸發的 On Demand 條件。
  2. 檢查基本連線。在相同網路下執行 Connectivity Test,再嘗試存取固定目標。測試失敗時先檢查參數與網路;測試成功但目標無法存取時,繼續檢查規則與 DNS。
  3. 比對分流結果。必要時暫時切換 Proxy 與 Config,並以相同目標重新測試。若只有 Config 失敗,請檢查比對順序、策略群組與 FINAL,不要同時更換協定。
  4. 恢復日常設定。確認結果後,恢復預期模式與 On Demand,停止臨時診斷紀錄,並在實際使用的 Wi-Fi 或行動網路上再次驗證。

首次匯入尚未完成時,請先依教學建立一條可驗證的連線;需要查詢介面用語時,請參閱術語表;已能穩定重現的問題,可依常見問題逐項排查。每次只變更一個變數,才能將結果對應到特定設定。

下載 Shadowrocket