依網域比對
DOMAIN 比對指定網域，DOMAIN-SUFFIX 比對網域後綴，DOMAIN-KEYWORD 依網域中的關鍵字比對。若只想調整單一目標，建議使用範圍明確的條件；關鍵字設定過於寬泛，可能影響其他目標。
官方手冊 · 功能與設定
Shadowrocket 功能介紹
從 Global Routing 到 Settings，依序確認「是什麼、在哪裡、如何設定、注意事項」。
主要說明 iPhone / iPad 操作。請先備妥自己已有的訂閱或伺服器資訊，再設定請求的處理方式；功能開關無法取代有效的連線參數。
- Config / Proxy / Direct
- 分別檢查規則與策略
- 一次只調整一項設定
Global Routing：三種請求處理模式
連線開關決定是否啟動連線；Global Routing 則決定連線啟動後如何處理請求。兩者是不同設定。
在 Home 找到 Global Routing，進入後選擇 Config、Proxy 或 Direct。此處以中文「設定、代理、直連」說明用途，實際操作時仍請依英文介面名稱查找。選擇模式前，先確認已選取可用伺服器；若要使用規則分流，也應在 Config 中確認目前使用的設定檔。
| 介面選項 | 處理方式 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config · 設定 | 依目前設定中的規則與策略處理請求。 | 需要讓不同網域或位址套用不同策略時。 | 確認設定是否生效、規則順序、策略名稱及策略目標。 |
| Proxy · 代理 | 以代理方式處理請求，不依 Config 的一般規則逐項分流。 | 暫時確認所選伺服器是否能連線至目標。 | 伺服器參數、目前選取項目、目標網站及底層網路。 |
| Direct · 直連 | 以直連方式處理請求。 | 比對本地網路的連線狀況，縮小問題範圍。 | 本地網路與 DNS；不要將其視為系統連線開關。 |
日常分流選擇 Config，暫時比對時再切換模式
若已有設定檔，先選擇 Config，分別造訪預期直連與預期代理的目標，再查看對應的請求記錄。若遇到「測試有回應，但網頁無法開啟」，可暫時切換至 Proxy，重新測試同一個目標。若 Proxy 可以連線而 Config 不行，優先檢查規則、策略及解析結果；若兩者都不行，再檢查伺服器與本地網路。這種比對只能縮小範圍，不能單憑一次成功或失敗判定原因。
測試完成後，請恢復原本的 Global Routing 選項。Direct 不等於停用系統 VPN 設定；若要完全停止用戶端連線，請使用 Home 的連線開關，並檢查 On Demand 是否可能再次觸發連線。
閱讀完整手冊中的 Global Routing 說明 →規則分流：比對條件與執行策略
規則決定「哪些請求符合條件」，策略決定「符合後如何處理」。先檢查比對條件，再檢查連線出口。
規則通常在 Config 中隨設定檔管理。開啟目前使用的設定檔，檢查規則內容與順序；修改前先保留副本。一般規則會依排列順序比對，較具體的條件應排在較寬泛的條件之前，FINAL 通常放在末尾，處理未符合前面規則的請求。只新增規則卻未選用該設定檔，或 Global Routing 未設為 Config，都會使實際結果與預期不同。
依位址及其他條件比對
IP-CIDR 和 IP-CIDR6 用於比對位址範圍，GEOIP 依位址歸屬資料比對。USER-AGENT 是否適用，取決於能否取得對應的請求資訊；不能因此假設所有 App 流量都能依名稱辨識。
先看懂規則片段，再依需求調整
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY這段語法範例表示：符合 example.com 網域後綴的請求使用 PROXY，符合指定區域網路位址範圍的請求使用 DIRECT，其餘請求交由 FINAL 指定的 PROXY 處理。範例僅說明規則結構，並非適用所有網路的完整設定。PROXY、DIRECT、REJECT 分別代表代理、直連與拒絕處理；若規則引用自訂策略名稱，名稱必須與設定檔中的定義完全一致。
設定後，請重新發出目標請求，再檢查命中的規則與處理策略。某條規則顯示命中，不代表策略指向的伺服器一定可用；同樣地，伺服器可用也不代表每個目標都會依預期命中。網域解析、快取及既有連線都可能影響重測結果，驗證時應盡量維持目標與測試條件一致。
訂閱與伺服器管理
伺服器項目用來儲存連線參數，Subscribe 用於管理一組項目；Config 主要管理規則與相關設定，三者用途不同。
Add Server：逐項填寫現有伺服器參數
在 Home 點選 Add Server 新增項目。先選擇與服務商提供資訊相符的協定，再核對位址、連接埠、驗證欄位及傳輸設定。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的欄位各不相同，不能將某一種協定的參數直接套用到另一種。特別是 UUID、密碼、加密方式、TLS、SNI、Host 和路徑，請逐項依現有資料填寫，不要自行從名稱推測。
若使用 Scan QR Code，請先確認 QR Code 來自自己已有的服務資訊。匯入完成後，開啟項目檢查協定與重要欄位，再選取該項目進行測試。項目出現在清單中，只代表已建立匯入記錄，不代表伺服器在線，也不代表驗證與傳輸參數都正確。
Subscribe：匯入與更新現有訂閱
在新增入口選擇 Subscribe，輸入自己已有的訂閱網址並儲存，再執行更新。更新後檢查群組、項目名稱及數量變化，並確認目前選取的伺服器仍在清單中。更新訂閱主要是刷新該訂閱提供的伺服器資訊，不等於取代目前 Config 的所有規則。服務端調整後，項目名稱、位址或參數可能變更，原先選取的項目也可能遭到移除。
更新失敗時，先檢查網址是否完整、訂閱是否仍有效，再確認目前網路能否連線至該網址。保留原有設定的前提下，可以切換網路重新測試，但不要反覆刪除整個訂閱來代替疑難排解。訂閱網址通常包含存取憑證，截圖、診斷檔案及公開求助內容都應隱藏完整網址。
Config：保留可復原的設定副本
調整規則或 DNS 前，先備份目前的設定檔，並清楚標註副本用途。匯入其他設定檔後，請確認實際選用的是哪一份檔案，並檢查其中的策略引用是否對應到目前的伺服器或策略群組。備份檔可能包含伺服器位址與驗證資訊，請存放在自己可控的位置；只還原 App 本身，不一定能還原所有本機設定。
依照入門指南完成首次匯入與連線 →On Demand：依網路條件觸發連線
On Demand 處理「何時連線」，Global Routing 處理「連線後如何處理請求」。啟用其中一項，不能取代另一項。
在 Settings 中找到 On Demand，依實際需求檢查 Wi-Fi、Cellular 等條件。實際可見的選項以目前 App 介面與裝置的網路功能為準。先在 Home 手動完成一次連線與目標存取測試，確認所選伺服器及設定可用後，再啟用隨選條件。如此可避免將伺服器參數錯誤誤認為觸發條件錯誤。
先用單一條件測試，再擴大使用範圍
先選擇一種需要自動連線的網路條件，儲存後切換至該網路，觀察連線狀態與實際存取結果。若同時啟用多項條件，就很難判斷是哪一項觸發連線。使用 iPad 時，請以裝置實際具備的網路功能為準；僅支援 Wi-Fi 的裝置不適用於行動網路情境的疑難排解。
若手動關閉連線後又自動連線，先檢查 On Demand 條件，不要反覆刪除系統中的 VPN 設定。需要進行直連比對測試時，可先暫時停用 On Demand，再關閉 Home 的連線開關；測試完成後恢復原本設定。隨選連線也無法保證伺服器始終可用，網路切換、驗證失敗與系統狀態都可能影響實際連線，請以存取測試結果為準。
閱讀完整手冊中的 On Demand 說明 →Data：了解上傳、下載與統計範圍
Data 用於查看用戶端記錄的流量，並非連線成功的證明，也不等同於服務商的計費帳單。
開啟 Data，先確認目前的統計檢視、記錄範圍及是否曾清除資料，再查看上傳與下載數值。若介面提供依伺服器或 App 等維度檢視，請先確認目前的分組方式。不同檢視可能依不同條件分類，不能直接將某處的數值視為特定 App 的所有網路活動；無法辨識來源的記錄，也不適合用來作精確判斷。
透過單次操作觀察變化
維持相同伺服器與 Global Routing 設定，記下測試前的數值，接著進行一次明確的存取操作，再返回 Data 查看變化。這有助於確認是否產生流量，但背景同步、重試請求及其他 App 活動仍可能同時計入。若數值沒有明顯變化，也應檢查連線狀態、是否確實發出目標請求，以及目前檢視是否涵蓋這次存取。
用戶端與服務商後台的統計可能因記錄週期、上下載計算方式、協定額外負載、計費方式及多裝置使用而有所差異。不要只憑數值差距判定異常，也不要將 Data 累計值視為訂閱剩餘量。疑難排解時，請保留相同時間範圍內的數值與測試條件；如需確認服務額度，仍應查看自己現有服務的帳戶記錄。
閱讀 Data 流量統計方式說明 →Settings：六項常用設定
設定入口與設定檔都可能影響結果。先記錄目前值，再一次調整一項；選單位置與可用選項以目前 App 介面為準。
DNS：網域解析方式
是什麼、在哪裡：DNS 會將網域解析為網路位址。可在 Settings 的 DNS 相關選項及目前 Config 中檢查；也要確認目前設定是否包含解析設定，不能只看單一介面的數值。
如何設定、注意事項：先檢查現有解析方式與設定檔中的 DNS 項目，確認實際使用的路徑，再依需求調整。修改後，重新請求同一個網域並查看記錄。若伺服器測試有回應但網頁無法開啟，應區分解析失敗、連線失敗與目標回應失敗。不要一次加入多組不同的解析設定，否則難以判斷哪一項生效，也不利於復原。
Test Method：測試方式
是什麼、在哪裡：在 Settings 中查看 Test Method，選擇可用性測試採用的方式。Connectivity Test 的結果會受測試方式、目標及目前網路影響，並非固定的伺服器效能指標。
如何設定、注意事項：選擇符合疑難排解目的的方式後，在相同網路下重新測試同一個項目；比較結果前，先確認測試條件一致。某種方式有回應，只能表示對應的測試路徑收到回應，不能證明所有網頁、所有傳輸方式或持續傳輸都正常；顯示失敗時也應搭配實際存取結果判斷，不要只依單一數值刪除項目。
Today Widget：快速入口
是什麼、在哪裡：在 Settings 中檢查 Today Widget 相關設定，並在系統支援的小工具位置加入對應入口。實際顯示內容與支援方式會受系統版本及 App 目前功能影響，是否能在裝置上使用請以實際介面為準。
如何設定、注意事項：先在 App 中選好伺服器並完成首次 VPN 設定授權，再確認小工具中的操作是否符合預期。若小工具狀態與主畫面不一致，先開啟 App 檢查連線並更新狀態。快速入口只能簡化操作，無法取代伺服器參數、Config 選擇或系統授權，也不應只憑小工具圖示判斷請求最後套用哪條規則。
iCloud：設定同步
是什麼、在哪裡：在 Settings 中檢查 iCloud 相關選項，同時確認系統帳戶與 iCloud 權限。同步功能可在支援範圍內儲存或傳送設定資料；實際同步內容以 App 目前說明為準，不要假設所有連線狀態與本機記錄都會同步。
如何設定、注意事項：先備份目前的設定檔，再啟用同步，並在另一台裝置確認檔案與內容是否完整。若發生設定衝突，應先決定要保留哪一份，不要在兩台裝置上連續覆寫。App Store 購買記錄與 iCloud 資料同步是兩回事；重新取得 App 後，仍須分別檢查設定、伺服器資訊與連線權限。
Diagnostics：診斷資訊
是什麼、在哪裡：在 Settings 中尋找 Diagnostics，收集或查看疑難排解所需資訊。診斷資料應搭配問題重現步驟使用，單獨一份記錄通常無法呈現問題發生時的所有設定。
如何設定、注意事項：先記下網路類型、所選伺服器、Global Routing 與故障目標，再重現一次問題，接著查看相關記錄。提供資料前，請移除訂閱網址、驗證欄位、個人位址及其他敏感資訊。只保留與問題相關的片段，並說明已嘗試過哪些調整；完成診斷後，將暫時變更的記錄選項恢復為日常設定。
連線與權限：先確認系統狀態
是什麼、在哪裡：首次連線時，VPN 設定要求由系統發出，用於允許用戶端建立相應的網路連線。App 中的連線開關與系統儲存的 VPN 設定有關，但它們不是 Config 規則檔。
如何設定、注意事項：閱讀系統提示後，依需求允許，再回到 Home 檢查連線狀態。若先前拒絕或移除了系統設定，請重新觸發連線並確認提示，不要在 Config 中反覆更換規則。系統顯示已連線後，仍須驗證目標存取；授權成功只代表允許建立連線，無法修正訂閱或伺服器中的錯誤參數。
設定檢查順序
依序檢查連線參數、處理模式、規則與解析、以及自動觸發，避免同時變更多項條件。
- 先確認現有伺服器資訊。核對協定、位址、連接埠、驗證與傳輸參數，選取對應項目並手動連線一次。匯入成功與實際可用，必須分開確認。
- 接著確認 Global Routing。日常規則分流使用 Config，並確認已選用預期的設定檔；Proxy 和 Direct 用於有明確目標的暫時比對，結束後請恢復原設定。
- 依請求記錄檢查規則與 DNS。先確認是否解析成功，再檢查命中條件與最終策略。伺服器測試、網域解析及目標回應是不同環節，不要用單一結果代替所有判斷。
- 最後啟用 On Demand 與便利設定。手動存取測試通過後，再設定自動觸發、Today Widget 與 iCloud，並保留可復原的副本。每次調整後只重新測試同一個目標，並記錄結果變化。