規則類型：辨識請求
DOMAIN 比對完整網域，DOMAIN-SUFFIX 比對網域本身及其子網域，DOMAIN-KEYWORD 則依網域中的關鍵字比對。位址相關條件可使用 IP-CIDR、IP-CIDR6 與 GEOIP；其中 GEOIP 的結果取決於 IP 位址歸屬資料。
USER-AGENT 需要取得相應的請求資訊，不適合用來辨識所有加密流量。FINAL 用於處理未命中前面規則的請求，請確認其策略符合預期。
官方手冊 · 功能與設定
Shadowrocket
Shadowrocket
功能與常用設定
先決定流量處理方式，再設定伺服器、規則與自動連線。每次只調整一個項目，並以相同的請求驗證結果。
本頁以 iPhone 與 iPad 為主，依序說明常用功能的用途、所在介面、設定方式及注意事項。實際入口與可用選項請以裝置上顯示的內容為準；系統需求以 App Store 頁面標示為準。
01 · 流量模式
Global Routing：Config / Proxy / Direct
Global Routing 是連線後處理流量的入口。在 Home 開啟 Global Routing，可選擇設定檔、代理或直連三種模式，介面名稱分別為 Config、Proxy、Direct。它決定整體處理方式，不等同於選擇某一台伺服器，也不代表已開啟連線。伺服器已選取、連線開關已開啟，以及流量依預期分流，是三件需要分別確認的事。
| 模式 | 處理方式 | 適用時機 | 注意事項 |
|---|---|---|---|
| 設定檔 · Config | 依目前設定檔中的規則決定處理策略。 | 日常使用時，依網域、位址等條件區分請求。 | 確認目前啟用的設定檔、規則順序及最後的 FINAL。 |
| 代理 · Proxy | 以代理模式處理流量，仍須留意適用的系統設定與連線例外。 | 短暫確認伺服器是否能處理目標請求。 | 確認選取的伺服器；測試後切回原本模式。 |
| 直連 · Direct | 以直接連線作為主要處理方式。 | 確認目前網路能否直接存取，或是否需要暫時使用直連。 | 在此模式下的存取結果，不能證明代理伺服器可用。 |
如何選擇：先用 Config，排查時再交叉測試
已有可用設定檔時，通常從 Config 開始。若特定目標無法正常存取，可先記下原設定，短暫切換至 Proxy，再測試相同請求；如果只有 Config 異常，優先檢查規則、策略與 DNS。若 Proxy 下也有異常，則繼續確認伺服器參數與網路狀況。Direct 適合用來對照直連結果，但不同模式的測試結果只能縮小排查範圍，無法單獨判定故障原因。
切換模式後，請重新發出請求。已建立的連線可能仍沿用原本的處理路徑，因此只觀察尚未重新整理的頁面，容易把舊連線的結果誤認為新設定的效果。
02 · 設定檔與策略
規則分流：比對條件與處理策略
規則分流將「請求的特徵」與「請求的處理方式」分開。規則類型描述比對條件，策略則決定命中後的動作。在 Config 中檢視、編輯並啟用設定檔，再將 Home 的 Global Routing 設為 Config，規則才會依此模式處理流量。只將檔案匯入清單但未啟用，不代表它已套用至目前連線。
策略：決定處理方式
PROXY 表示使用代理策略，DIRECT 表示直接連線，REJECT 表示拒絕請求。設定檔也可能引用自訂策略名稱，此時須進一步檢查該策略實際選用的伺服器或下層策略，不能只根據名稱判斷流量出口。
規則通常由上而下比對，最先符合的規則會決定結果。範圍較明確的規則應排在涵蓋範圍較大的規則之前；調整後請檢查是否有更前面的條件已先攔截請求。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,blocked.example.net,REJECT
FINAL,PROXY範例網域僅用於說明語法，並非可用的服務設定。第一條規則讓 api.example.com 優先命中 DIRECT，第二條則處理 example.com 其餘符合條件的請求。修改前請先保留原設定；完整段落結構與規則說明請見規則手冊。
03 · 連線資訊
訂閱與伺服器管理
伺服器記錄包含連線目的地與驗證參數；訂閱用於批次維護既有伺服器資訊；設定檔則主要負責全域參數與分流邏輯。三者用途不同：更新訂閱不代表更新目前的規則，切換設定檔也不一定會更改 Home 中已選取的伺服器。開始設定前，先確認手上的資料是單筆伺服器資訊、訂閱連結，還是設定檔網址。
設定位置與操作方式
在 Home 的伺服器清單與 Add Server 中管理連線資訊；若已有訂閱，請使用 App 提供的訂閱入口新增；需要設定檔時則前往 Config。手動新增時，先選擇正確的協定類型，再逐項確認伺服器位址、連接埠、驗證資訊及相關傳輸參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定使用的欄位各不相同，不能只更改協定名稱後沿用所有參數。
儲存後返回 Home，在 SERVER 清單選取要使用的記錄，並確認其已被選取。更新訂閱後，請再次確認預設伺服器仍存在、名稱相近的記錄是否對應相同位址，以及所選策略是否仍指向有效項目。首次匯入及批次更新後，都建議先執行 Connectivity Test，再實際測試存取。
使用範圍與注意事項
本手冊以使用者已有自己的訂閱或伺服器資訊為前提。一次買斷用戶端 ≠ 線路方案：購買 Shadowrocket 可取得用戶端使用權，連線所需資訊仍須自行準備。本網站不提供、不販售也不推薦節點或訂閱。訂閱網址可能包含存取憑證，分享排查紀錄時請遮蔽完整網址、驗證欄位與 QR Code。
Shadowrocket 是 Apple 平台的付費用戶端，唯一取得管道為 App Store。購買、安裝與正版確認步驟請見App Store 說明；本頁的伺服器操作不涉及購買 App 以外的服務交易。
04 · 自動連線
On Demand：依條件建立連線
On Demand 可依條件觸發或維持連線，適合希望減少手動開啟連線的情境。它控制的是連線時機，而非網域的分流方式；流量最終使用 PROXY、DIRECT 或 REJECT，仍取決於 Global Routing 與目前的設定檔。On Demand 並非伺服器故障時的自動修復功能。
設定入口與操作步驟
在 Settings 中尋找 On Demand，先查看目前裝置顯示的網路條件與相關選項。確認手動連線與存取都正常後，再啟用所需條件。若頁面提供 Wi-Fi、行動網路或特定網路條件，請依實際使用情境逐項設定，並記錄修改前的狀態。
設定後，請分別在目標網路下測試連線行為。切換網路時，等候系統完成切換，再查看 Home 的連線狀態；只看到狀態列圖示，並不代表每個目標都能如預期存取。
重新連線與電池用量
啟用後，手動中斷連線可能因符合條件而再次觸發連線。若要暫時停止自動連線，請先檢查 On Demand，再操作 Home 的連線開關，以免反覆開關卻未改變觸發條件。
耗電量也會受到請求頻率、網路品質及重新連線次數影響。比較時請使用相近的觀察時間，並查看系統的電池用量紀錄；不要只因開啟 On Demand，就推斷耗電一定增加或減少。
05 · 使用狀況
Data：流量統計與前後比較
Data 用於查看 App 記錄的流量活動。從底部導覽列進入 Data，先確認目前顯示的統計範圍、記錄區間及裝置上可用的分類。上傳與下載數值可協助判斷是否有資料傳輸，但不等同於頁面存取成功，也不能單憑數值證明流量命中了特定規則。
若要進行可重複檢查的測試，請先記錄目前數值與連線模式，關閉不相關的前景工作，再只送出一個明確請求，之後返回 Data 比較變化。背景同步、系統請求及其他 App 活動仍可能產生流量，因此統計變化只能作為輔助資訊；判斷分流結果時，還應一併查看可用的連線紀錄與規則命中資訊。
06 · 常用選項
Settings：DNS、測試、同步與診斷
Settings 集中管理 App 常用選項，但並非所有連線參數都只在此處生效。有些參數來自 Config 中的設定檔，另一些則隸屬於個別伺服器記錄。排查前請先確認目前啟用的設定檔，再檢查 Settings 中相關項目；選項名稱相似時，也要依說明確認適用範圍。
DNS：先確認解析流程
用途與位置：DNS 會將網域名稱解析為位址，可在 Settings 的 DNS 項目及目前 Config 的全域參數中檢查相關設定。解析結果會影響依位址比對的規則，也可能影響連線目標。
設定方式：先保留目前可正常使用的設定，確認目前設定檔是否指定 DNS 參數，再依實際網路環境調整解析方式。修改後，使用相同網域重新測試，並留意既有快取與連線是否影響觀察結果。
注意事項：排查時不要一次更改多個 DNS 選項。網域解析成功不代表伺服器驗證成功；反之，能連上伺服器也不代表目標網域一定能解析。請分別確認名稱解析、建立連線與目標回應。
Test Method：了解測試項目
用途與位置：Settings 中的 Test Method 會決定相關連線測試採用的方式。它影響伺服器可連線性的判斷方式，不會直接修改分流規則，也不是通用的連線加速設定。
設定方式：依照介面列出的方式及說明選擇測試方法；若需指定測試目標，請使用自己能確認回應狀況的位址。修改後，在 Home 執行 Connectivity Test，並以相同方法比較結果。
注意事項：測試失敗可能與測試目標、測試方式或網路限制有關，不能直接推論所有請求都會失敗。測試成功也只代表該次測試的連線路徑可用，仍須實際存取需要的目標驗證；不同測試方法的數值不可直接視為相同指標比較。
Today Widget：快速操作與狀態檢視
用途與位置：Today Widget 提供系統支援的快速資訊顯示與操作，相關選項可在 Settings 中查看；實際新增位置與顯示方式取決於裝置系統。
設定方式：先在 App 中完成有效設定並選取伺服器，再依系統提供的方式新增可用的小工具。需要切換連線時，先確認顯示的是預期項目；操作後返回 Home 確認連線狀態。
注意事項：小工具顯示內容可能有更新間隔，不能取代完整的連線診斷。如果目前系統沒有提供相應入口，請以裝置實際支援情況為準，不要因其他裝置的介面配置就認定本機也有相同功能。
iCloud：同步前先保留副本
用途與位置：iCloud 相關功能用於同步 App 支援範圍內的資料或執行雲端操作，可在 Settings 中檢查相關設定，並確認系統 iCloud 狀態是否符合使用條件。
設定方式：先確認裝置使用的是預期的 iCloud 帳號，並檢查系統是否允許 App 使用 iCloud，再查看 App 中的同步項目。跨裝置操作前，請保留目前可用的設定檔；同步完成後，核對檔案內容與伺服器記錄。
注意事項：同步不等於歷史備份，也不等於透過 App Store 還原已購項目。設定檔可能包含敏感連線資訊，請先了解同步範圍；不要假設所有暫存狀態、統計紀錄與系統 VPN 設定都會完整轉移。
Diagnostics：收集可供檢查的故障資訊
用途與位置：Diagnostics 提供診斷相關入口，可在 Settings 中查看可用項目。發生問題時可用來收集線索，不應在不了解作用的情況下長期啟用所有紀錄選項。
設定方式：記錄問題發生時的網路類型、Global Routing 模式、目前設定檔與無法存取的目標，再依介面說明執行所需診斷。每次只變更一個條件並保留前後結果，以便區分 DNS、伺服器連線、規則或目標回應問題。
注意事項：診斷輸出可能包含網域、位址與請求資訊，分享前請檢查並遮蔽驗證參數及個人資料。排查完成後，請還原暫時啟用的選項；遇到不明錯誤，可前往常見問題依問題類型繼續確認。
07 · 操作順序
每次只調整一項，保留驗證依據
- 確認基本資訊。在 Home 檢查已選取的伺服器；在 Config 確認已啟用的設定檔。伺服器資訊與設定檔都應來自使用者已有的資料。
- 確認流量模式。記錄 Global Routing 目前是 Config、Proxy 還是 Direct，再決定本次要驗證的行為。
- 建立可用基準。手動連線並執行 Connectivity Test，接著存取實際目標。基本連線尚未正常前，先不要加入自動連線條件。
- 一次調整一個變數。只修改一項規則、DNS 選項或伺服器參數，再次送出相同請求；必要時結束舊連線後重新檢查。
- 最後再設定自動化。確認手動操作正常後，再調整 On Demand、Today Widget 與同步選項。若出現異常，請還原原本設定，避免連續修改而無法判斷原因。
本頁協助理解各項功能的適用範圍；首次操作請依教學逐步完成，設定檔段落與規則語法請參照規則手冊。如此可分別確認「是否建立連線」、「規則是否生效」及「目標是否可用」。