官方手冊 / 功能介紹

Shadowrocket 功能與設定

先確認 Global Routing,再檢查 Config 與伺服器資訊。分流、按需連線和診斷各有不同用途,應分別設定並逐項確認。

  • Global Routing
  • Config
  • On Demand
  • Data
  • Settings

適用於 iPhone 與 iPad 的操作說明;實際介面位置與可用選項請以裝置上顯示為準。

01 / 路由入口

三種 Global Routing 模式

Config、Proxy、Direct 決定連線採用哪種路由邏輯,並不代表三台不同的伺服器。

功能說明:Global Routing 是設定整體路由方式的入口。Config 依目前設定中的規則決定請求的處理方式;Proxy 會將適用流量交由選取的代理伺服器轉送;Direct 則不經選取的代理伺服器轉送。在檢查「規則是否生效」之前,先確認此處是否選擇 Config。

介面位置與設定方式:在 Home 開啟 Global Routing,選擇所需模式,再返回確認目前顯示的選項。已有分流設定時,先使用 Config;若要單獨測試所選伺服器能否處理目標請求,可暫時切換至 Proxy;若要比較目前網路直接連線的結果,可暫時切換至 Direct。每次只變更這個選項,並維持其他條件不變,結果才有比較意義。

Global Routing 常用模式對照
介面用語 / 中文處理方式適用情境檢查重點
Config / 設定依目前 Config 中的規則與策略處理請求。日常依網域、IP 等條件進行分流。已啟用的設定、規則順序與策略引用。
Proxy / 代理適用流量經由選取的代理伺服器轉送。暫時測試伺服器與目標連線路徑。目前選取的伺服器及其參數。
Direct / 直連不經選取的代理伺服器轉送。確認目前本地網路的直接連線結果。目前網路、DNS 與目標服務狀態。

注意事項:Proxy 無法修正填錯的驗證參數;Direct 也不是解決所有網路問題的通用方法。切換模式後,既有的長連線可能仍沿用先前的連線路徑,測試時應重新發出請求。若只是暫時排查問題,完成後請切回原本使用的 Config,避免將測試狀態誤當成日常分流設定。

02 / 比對與處理

規則類型與策略

規則用來判斷請求是否符合條件;策略則決定符合後要如何處理。

功能說明:規則分流會逐項比對請求特徵與條件。DOMAIN 用於完整網域;DOMAIN-SUFFIX 用於網域及其子網域後綴;DOMAIN-KEYWORD 用於網域關鍵字。IP-CIDR、IP-CIDR6 分別表示 IPv4、IPv6 網段;GEOIP 則依 IP 地理位置條件比對。規則類型不是伺服器協定,不需要在規則類型欄位填入 VLESS 或 Trojan 等協定名稱。

介面位置與設定方式:進入 Config,先確認目前啟用的設定,再查看其中的規則內容。通常應將具體條件放在較寬泛的條件之前;FINAL 用來處理前面規則都未符合的請求。常見處理策略包括 DIRECT、PROXY、REJECT,也可能引用設定中已有的策略群組名稱。引用策略群組時,名稱必須與設定中的定義完全一致。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

此範例僅用於說明語法:example.com 及其子網域使用 PROXY;指定的本地 IPv4 網段使用 DIRECT;其他未符合規則的請求則由 FINAL,DIRECT 處理。這不是完整的通用設定,也不表示所有家庭或辦公室網路都適合採用相同設定。編輯前請保留原有設定,並確認最後的預設處理方式符合需求。

注意事項:規則依序比對時,較前面的寬泛規則可能先符合,導致後續的精確規則無法生效。只新增一條 DOMAIN-SUFFIX 規則,不足以證明分流已改變;還要確認 Global Routing 是否設為 Config、設定是否已套用,以及目標是否實際使用其他網域或 IPv6 位址。如需進一步了解規則與設定,請參閱設定詳解。

03 / 連線資料

現有訂閱與伺服器管理

Subscribe 用來管理現有訂閱的更新來源;Add Server 用來管理單筆伺服器資訊。兩者都不等同於 Config 規則檔。

Subscribe:匯入與更新

現有訂閱包含可供用戶端讀取的伺服器資料。通常可在 Home 點選新增入口,進入 Add Server 後選擇 Subscribe,並填入已有的訂閱網址。儲存後返回清單,確認是否成功讀取伺服器。實際操作入口請以目前介面為準。

更新訂閱會重新讀取來源內容。更新後請再次確認選取的伺服器是否仍在清單中,以及設定中的策略群組是否仍符合預期項目。清單中出現名稱不代表驗證成功,也不表示每筆伺服器資料都可用。

Add Server:逐項填寫

手動新增時,先選擇與現有伺服器資料相符的協定,再填入 Address、Port,以及該協定所需的驗證、傳輸與 TLS 參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的參數結構各不相同,不能只更改協定名稱,卻沿用其他協定的欄位。

透過 Scan QR Code 匯入後,同樣要檢查內容,尤其是位址、連接埠及安全性相關選項。備註名稱方便辨識,但不能取代真正的伺服器位址或驗證欄位。儲存後返回 Home,並明確選取要使用的項目。

設定方式:先完成一種匯入方式,避免同時手動新增並反覆更新訂閱,以免產生難以辨識的重複項目。可用清楚的備註區分不同用途;刪除項目前,先確認目前設定是否仍有引用該項目。若訂閱更新失敗,請先確認網址是否完整、目前網路能否連線至來源,以及來源是否提供用戶端可讀取的內容。

注意事項:訂閱網址、QR Code 與驗證資訊都屬於敏感資料,尋求協助時請先遮蔽這些內容。用戶端一次買斷 ≠ 連線服務方案;購買 App 只取得用戶端的使用資格,伺服器資訊與訂閱須由使用者自行準備。本網站不提供、不販售,也不推薦節點或訂閱。首次匯入的完整操作流程請參閱快速入門。

04 / 連線觸發條件

On Demand 按需連線

此功能管理何時觸發連線,不會取代 Global Routing,也不負責判斷某個網域應直連或經由代理連線。

功能說明與介面位置:On Demand 依設定的網路條件管理連線行為,可在 Settings 的相關項目中查看。它與 Config 的用途不同:On Demand 決定連線觸發條件,Config 則決定連線啟動後如何分流。了解兩者差異,才能避免將「切換網路後連線再次出現」誤判為規則檔問題。

設定方式:先在手動連線狀態下確認伺服器、DNS 與分流都能正常運作,再設定 On Demand 中實際提供的網路條件。依照使用 Wi-Fi 與行動網路的情境分別檢查;若涉及網路名稱,請以裝置目前辨識到的名稱為準。儲存後不要只查看設定頁,應實際切換網路,再確認連線狀態是否符合預期。

注意事項:啟用後,系統可能在符合條件時再次觸發連線。暫時排查連線中斷行為時,也要檢查 On Demand,而不只是從 Home 關閉連線。若要取消變更,請先關閉相應的按需條件,再重新觀察。不要依賴此功能補救失效的伺服器資料;成功觸發連線與連線可正常使用是兩件不同的事。

05 / 使用狀況

Data 流量統計

先確認統計範圍與時間,再透過上傳和下載數據了解實際使用狀況。

功能說明與介面位置:Data 彙整用戶端可觀察到的流量資訊。進入 Data 後,先查看目前的統計對象與可用檢視方式;若介面提供依伺服器或 App 檢視,前者適合觀察各伺服器的使用分布,後者則有助於了解 App 產生的流量。上傳與下載代表資料量,不是網路延遲,也不能直接反映連線品質。

使用方式:記下測試前的統計範圍與讀數,只進行一次明確的連線操作,再返回查看變化。判斷某條規則時,應一併參考 Data、目前的 Global Routing、實際選取的伺服器及連線記錄。裝置背景同步也可能產生流量,不能將測試期間增加的所有數據都歸因於剛開啟的頁面。

注意事項:瀏覽一次頁面通常會連線至多個網域,因此伺服器讀數增加只能作為線索,無法單獨證明每個請求都套用了相同策略。不同檢視方式、統計週期及可能的重設操作,都會讓前後讀數失去直接比較的基準。Data 也不等於服務提供者的計費紀錄;若要釐清差異,請先確認統計起始時間與範圍一致。

06 / 常用設定

Settings 檢查要點

以下依用途說明,不預設所有裝置的初始值都相同。實際設定值請以目前的 App 與設定內容為準。

DNS:網域解析

功能說明與位置:DNS 會將網域解析為連線所需的位址。檢查時,除了查看 Settings 中的 DNS 相關設定,也要確認目前的 Config 是否包含相應設定;只檢查其中一處,可能無法釐清實際的解析行為。

設定方式與注意事項:先確認問題是網域解析失敗還是連線失敗,再檢查解析位址、請求路徑與目前網路的連線狀況。不要一次更改多個選項。使用 IP 條件規則時,解析出的位址也會影響比對結果;修改後請重新發出請求,並同時確認本地網路資源仍可正常存取。

Test Method:測試方式

功能說明與位置:Settings 中的 Test Method 會決定連線測試採用的方式,解讀 Connectivity Test 的結果時應一併考量此設定。不同測試方式驗證的層面不同,不能直接用某一類測試結果推論其他網路功能是否正常。

設定方式與注意事項:先記下目前的測試方式,再從實際提供的選項中選擇,並在相同網路與相同伺服器下重新測試。若測試方式需要指定目標,也要確認目標本身可連線。連線測試通過,不代表所有網站都能存取;測試失敗時,也要釐清原因是測試目標、驗證、傳輸方式還是目前網路。

Today Widget:快速檢視與操作

功能說明與位置:Today Widget 提供系統小工具相關的快速檢視與操作。可先在 Settings 查看對應選項,再前往系統的小工具管理介面確認是否已加入。實際可用形式取決於裝置系統與 App 提供的小工具。

設定方式與注意事項:先在 Home 完成正常連線並選取伺服器,再設定小工具內容。小工具適合日常快速操作,不能取代完整的故障排查;顯示狀態可能有更新延遲。若顯示結果不符預期,請返回 App 檢查 Global Routing、目前的伺服器與系統連線狀態。

iCloud:設定同步

功能說明與位置:iCloud 相關選項用於跨裝置同步 App 支援的資料。可在 Settings 確認同步入口,同時檢查系統中此 App 的 iCloud 使用權限。同步範圍請以介面上的實際說明為準,不要假設所有本機狀態都會隨裝置移轉。

設定方式與注意事項:先備份重要設定,再啟用所需的同步項目,並等待另一部裝置完成讀取。請勿在兩部裝置上同時修改同一份設定,以便確認最後保留的內容。App 購買資格、訂閱來源更新與 iCloud 設定同步是不同機制;同步完成後,仍須檢查伺服器選取、設定套用狀態及本機系統授權。

Diagnostics:診斷資訊

功能說明與位置:Diagnostics 是收集及查看診斷資訊的入口,可在 Settings 的相關項目中檢查。它能協助縮小問題範圍,但不會自動修正伺服器參數,也無法保證連線一定成功。

使用方式與注意事項:先記下問題發生時的網路、Global Routing 模式與操作步驟,再重現一次,查看問題發生時間附近的資訊。分享資料前,請確認其中是否包含訂閱網址、伺服器位址或驗證內容,並適當遮蔽。排查完成後,請恢復日常記錄設定,避免長期保留不必要的詳細記錄。

07 / 操作順序

從設定到連線的確認順序

每次只變更一項條件,讓每次觀察都有明確的對應項目。

  1. 先確認連線資料。檢查現有訂閱是否已完成讀取,或手動新增的伺服器 Address、Port、驗證與傳輸參數是否與原始資料相符。名稱相同不代表參數相同。
  2. 再確認路由模式。日常規則分流請使用 Config,並確認目前套用的設定。若暫時切換至 Proxy 或 Direct,請記下測試目的,完成後恢復原設定。
  3. 重新發出請求。關閉舊頁面或舊連線後再試一次,並參考 Data 與診斷資訊進行檢查。不要只根據連線開關已開啟或單次測試讀數下結論。
  4. 最後設定自動行為。手動連線穩定後,再設定 On Demand、小工具與同步功能,並實際確認切換網路及另一部裝置上的結果。