官方手冊 / 功能介紹
Shadowrocket
功能與常用設定
先確認流量處理方式，再檢查伺服器、規則與連線條件。每次只調整一類設定，方便判斷變更原因。
本頁以 iPhone 與 iPad 上的 App 內操作入口為主。實際選項請以目前介面為準；系統需求請以 App Store 頁面標示為準。
01 / 流量處理方式
Global Routing：Config、Proxy、Direct
Global Routing 決定進入 App 處理範圍的流量要採用哪種路徑。這與伺服器是否可用、系統連線開關是否開啟，是三個不同的問題。
功能說明：Config 是設定檔模式，依目前啟用的設定檔規則選擇策略；Proxy 是代理模式，將 App 處理的流量交由代理策略處理；Direct 是直連模式，採用直連策略。此處的「全部」是指進入 App 處理範圍的流量，不代表裝置上的所有系統通訊都一定會經過 App。
介面位置：在 Home 找到 Global Routing，進入後選擇所需模式。開始排查前，先記下目前選項，並確認 Home 中選取的伺服器。切換至 Proxy 不會自動補齊伺服器參數，也無法證明該伺服器可以連線。
| 介面選項 | 處理方式 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config / 設定檔 | 依目前 Config 的規則與策略處理。 | 已有明確的分流需求，平時依規則使用。 | 目前使用的設定檔、規則順序與策略指向。 |
| Proxy / 代理 | 使用代理策略，不依日常規則逐項分流。 | 暫時測試代理連線，縮小規則問題的範圍。 | 選取的伺服器、驗證欄位及實際連線結果。 |
| Direct / 直連 | 使用直連策略。 | 暫時確認目前網路的直連狀況。 | 本地網路是否可用，以及測試後是否恢復原模式。 |
設定方式：已有可用設定檔時，選擇 Config，再開啟符合預期規則的目標進行測試。若 Config 模式失敗，可暫時切換至 Proxy，在相同網路、使用相同伺服器連線至同一目標。若 Proxy 成功而 Config 失敗，接著檢查命中的規則；若兩者皆失敗，應優先檢查伺服器資訊與網路條件，而非繼續新增規則。
注意事項：Direct 不等於關閉系統 VPN 連線，應分別檢查介面中的模式選項與連線開關。排查完成後，請恢復平時使用的模式，以免忘記暫時變更的設定。若要了解完整連線步驟，請參閱使用教學；本頁主要說明各項功能之間的關係。
02 / Config 與策略
規則分流：先比對，再選擇策略
規則用來判斷「這次連線符合哪些條件」，策略則決定「符合條件後如何處理」。只看懂規則關鍵字，還不足以確認實際連線路徑。
功能說明：規則通常會依序檢查，命中後便使用該規則指定的策略。常見策略包括 DIRECT、PROXY 與 REJECT，分別用於直連、代理與拒絕。設定檔也可以引用策略群組，因此看到 PROXY 或群組名稱後，還要確認其最終指向哪一台伺服器。
介面位置：進入 Config，先確認目前啟用的設定檔，再查看或編輯其中的規則。儲存另一個檔案不代表已切換至該檔案；也必須確認 Global Routing 設為 Config，才能依預期測試設定檔中的分流邏輯。
設定方式：先備份目前的設定檔，再新增適用範圍明確的規則。將特定目標放在較廣泛的比對條件之前，並檢查最後的 FINAL。測試時記下連線目標、命中的規則及使用的策略，不要只憑頁面是否開啟來推斷分流結果。
| 關鍵字 | 比對依據 | 設定時的判斷 |
|---|---|---|
| DOMAIN | 完整網域名稱。 | 只指定單一網域時使用，不代表包含其所有子網域。 |
| DOMAIN-SUFFIX | 網域後綴。 | 涵蓋對應網域及其子網域，請留意影響範圍。 |
| DOMAIN-KEYWORD | 網域中的關鍵字。 | 比對範圍較廣，避免使用過短的關鍵字，以免意外命中。 |
| IP-CIDR / IP-CIDR6 | IPv4 / IPv6 位址範圍。 | 確認位址類型與前綴長度；網域請求也可能涉及 DNS 解析。 |
| GEOIP | IP 地理位置資料。 | 判斷依據是 IP 位址與資料庫，不會按頁面語言分流。 |
| FINAL | 前面的規則都未命中時的預設處理方式。 | 確認預設策略，避免未命中的連線採取非預期的路徑。 |
注意事項：同一個頁面可能會連線至多個網域，主頁載入成功不代表附屬資源都使用相同策略。規則命中也會受到 DNS 結果、設定檔內容及連線重用等因素影響。不要把單一範例加到任意位置就視為設定完成；請檢查是否有更前面的規則已先命中。關鍵字說明請參閱術語手冊。
03 / Home 與匯入
訂閱與伺服器管理
以下操作以已備妥訂閱或伺服器資訊為前提。App 一次性買斷 ≠ 連線方案；訂閱連結請向你的服務提供者取得。
功能說明：單一伺服器會儲存連線所需的協定、位址、連接埠及驗證參數；Subscribe 用來匯入及更新一組伺服器資訊。Config 則負責規則與相關設定，兩者用途不同。更新訂閱通常只會更新該訂閱的內容，不應視為修復所有設定問題的通用方法。
介面位置：在 Home 點選新增入口，進入 Add Server 並選擇相應類型。已有訂閱連結時使用 Subscribe；已有單一伺服器參數時，選擇對應協定並填寫欄位。可用 Scan QR Code 掃描 QR Code；剪貼簿匯入則適用於目前 App 支援的分享內容。
設定方式：先確認匯入資料是訂閱連結、單一伺服器分享連結，還是設定檔，再選擇相應入口。手動填寫時，Address、Port 與協定必須符合服務提供者提供的資訊；Password、UUID、TLS、SNI 等欄位則依該協定的實際要求填寫，不可混用不同協定的參數。匯入後，為伺服器或訂閱設定容易辨認的名稱，再選取伺服器進行測試。
使用多組訂閱時，先依來源與用途整理名稱，更新前確認操作的是哪一組。單一伺服器失效不一定需要刪除整組內容；請先確認訂閱更新結果及服務提供者端的有效狀態。刪除前先儲存必要資訊，尤其是手動修改過且可能在更新時被覆蓋的欄位。
注意事項：訂閱連結可能包含存取憑證，請勿貼到公開記錄、截圖或回報內容中。QR Code 能成功讀取只代表內容可辨識，不代表伺服器可以連線。延遲測試也不等同完整的網頁連線測試。更新、排序、刪除與備份方式請參閱訂閱與伺服器管理手冊。
04 / 連線條件
On Demand：依條件建立連線
On Demand 用來管理何時建立連線，不會取代 Global Routing，也不負責判斷訂閱是否有效。
功能說明：On Demand 運用系統的隨選連線機制，依設定的網路條件處理連線。適合需要在特定網路環境下自動連線的情境；App 中顯示的條件及其組合方式，請以目前介面為準。
介面位置：進入 Settings，找到 On Demand 相關選項，查看目前的開關狀態與既有條件。若之前已設定隨選連線，請先記下條件，再判斷是否需要新增或修改，以免重複條件互相影響。
設定方式：先在手動連線狀態下確認伺服器與 Config 可正常使用，再設定隨選連線。每次只調整一項網路條件，儲存後在相應網路環境中觀察系統 VPN 狀態，並實際連線至已知目標。切換 Wi-Fi 與行動網路後，也應分別測試，不要只在同一個網路中反覆開關。
注意事項：設定 On Demand 後，即使手動中斷連線，條件符合時仍可能自動重新連線。若要暫時停止自動連線，應檢查 On Demand 條件，而不是只重複點選 Home 開關。隨選連線成功不代表分流設定正確；連線建立後，流量路徑仍由 Global Routing 與目前設定檔決定。
05 / 使用記錄
Data：查看流量，不等同帳單
Data 可用來觀察 App 記錄的流量變化，適合確認「是否有資料傳輸」，但無法單獨證明速度、連線品質或計費結果。
功能說明：Data 顯示 App 可取得範圍內的流量統計。上傳與下載代表不同方向的資料傳輸；實際統計維度與記錄範圍請以頁面顯示為準。App 統計、裝置系統統計及服務提供者的計量方式可能不同，因此數值不一定完全一致。
介面位置：開啟 Data，先確認統計對象與時間範圍。若目前頁面提供伺服器或連線分類，請確認正在查看的對象，再比較前後數值；不要把某個分類的數值當成整部裝置的總流量。
設定與查看方式：選擇明確的測試流程，例如只連線至一個目標，再比較操作前後的流量變化。若介面提供重設功能，請先儲存需要的記錄，再決定是否重設；重設 App 統計不會重設服務提供者端的用量。長時間觀察時，盡量維持相同的統計範圍。
注意事項：出現少量流量不代表目標內容已成功載入，連線交涉、重試與背景請求也可能產生傳輸。Data 無法直接推算剩餘可用量，也不能取代服務提供者的帳單。若要判斷連線失敗的原因，請搭配查看 Data 與 Diagnostics 中的連線資訊。
06 / 常用選項
Settings：DNS、測試、快速入口與同步
先保留目前可用的設定，再依具體問題進行調整。即使設定名稱相同，也不代表能解決所有連線問題。
DNS：區分解析失敗與連線失敗
功能與位置：DNS 負責將網域名稱解析為位址。檢查 Settings 中的 DNS 相關項目時，也應查看目前 Config 是否包含 DNS 設定，避免只修改一個入口，卻忽略正在使用的設定檔內容。
設定方式：先記下目前的 DNS 設定，再依明確需求調整，並使用同一個網域重新測試。若只有部分目標連線失敗，先判斷是 DNS 沒有回傳結果，還是取得位址後連線失敗。若需指定解析方式，請確認位址格式、可連線性與目前網路條件，不要只因某個位址常見就直接更換。
注意事項：解析結果可能會被快取，修改後觀察到的結果不一定立即更新。調整 DNS 也無法修正錯誤的伺服器密碼、連接埠或 TLS 參數。涉及設定覆寫與優先順序時，應以目前設定檔及實際診斷結果為準，不要把更換 DNS 當成固定的第一步。
Test Method：統一測試條件
功能與位置：Test Method 是 Settings 中與連線測試方式相關的選項。Home 中的 Connectivity Test 結果須搭配所選方法解讀；不同方法可能測試不同階段，因此結果不可直接混為一談。
設定方式：選擇目前介面支援且符合本次排查目的的方法，再對同一組伺服器進行測試。比較前後結果時，請維持網路、測試方法及目標一致。若測試方式還包含目標位址或逾時設定，也應一併記錄。
注意事項：測試成功通常只代表測試條件成立，不表示所有實際連線都會成功；測試失敗也可能與目標或逾時設定有關。排序時不要只看單一延遲結果，最後仍需透過實際連線確認目前伺服器是否可用。
Today Widget：快速入口與系統支援
功能與位置：Today Widget 是與系統快速存取相關的設定項目。先在 Settings 查看目前提供的選項，再到系統相應的元件管理介面確認能否加入。可用入口與顯示方式請以目前系統及 App 介面為準。
設定方式：依照系統實際提供的方式加入後，確認顯示的連線狀態與操作目標。首次使用時，請返回 Home 檢查一次，確認快速操作影響的是預期連線；不要只依元件上的文字判斷切換已成功。
注意事項：元件提供快速操作入口，不會更改伺服器參數或規則內容。若入口未顯示，請先確認系統支援情況與元件設定，不要為了顯示元件而同時修改 DNS、訂閱及 Config。
iCloud：同步與獨立備份分開處理
功能與位置：在系統帳號與雲端服務可用的情況下，iCloud 相關選項可用於同步 App 支援的內容。在 Settings 查看相關開關時，也請確認系統中的 iCloud 權限與可用空間。實際同步範圍請以 App 內說明為準。
設定方式：更換裝置前，先在舊裝置確認同步狀態，並另外儲存重要的 Config 與現有訂閱資訊。在新裝置從 App Store 下載並還原 App 後，再確認同步內容是否完整，逐項測試伺服器、設定檔與規則；不要只因列表中出現項目就刪除舊裝置資料。
注意事項：同步不是獨立的歷史快照，任何一端的修改或刪除都可能影響其他裝置。購買記錄、系統 VPN 設定授權與 App 內設定也屬於不同類型的資料；完成同步後，新裝置仍可能需要確認系統授權。
07 / 診斷與重新測試
Diagnostics：依據記錄縮小問題範圍
先重現一次問題，再查看對應時間的記錄。分別檢查連線、解析、規則與伺服器參數，比同時修改多項設定更容易找出原因。
功能與位置：Diagnostics 是用來檢查連線狀態與相關記錄的診斷入口，可在 Settings 中尋找。實際可用的記錄與工具請以目前介面為準。診斷記錄僅供參考，解讀時還須一併考量問題發生時的網路、Global Routing 與目前設定檔。
使用方式：先記下失敗的目標、發生時間與錯誤提示，再以最精簡的操作重現一次。查看相應記錄，判斷問題發生在 DNS、建立連線、驗證或後續請求階段。若只有 Config 模式失敗，請優先檢查規則與策略；若相同伺服器在 Proxy 模式下也失敗，則先確認伺服器欄位與測試條件。
注意事項：記錄中可能包含訂閱網址、伺服器位址、連線網域與驗證資訊。提供記錄給他人前，請先移除存取憑證及個人資料，只保留排查所需的時間、錯誤類型與已檢查項目。一般連線錯誤不應以隨意降低 TLS 驗證要求的方式排查。