官方手冊 · 功能與設定
Shadowrocket 功能與常用設定
先確認流量的處理方式，再檢查伺服器、連線條件與診斷結果。各項設定負責不同環節，不必一次變更所有選項。
本頁主要說明 iPhone 與 iPad 上的操作。介面配置與可用選項以 App 內顯示為準；系統需求以 App Store 頁面標示為準。
決定依規則、代理或直連方式處理。
依規則順序選擇流量策略。
根據實際連線情況找出問題環節。
Home → Global Routing
Global Routing 三種模式
日常依規則使用時選擇 Config；Proxy 與 Direct 適合在確認目標後暫時檢查。
Global Routing 會決定用戶端接管範圍內的流量如何處理。在 Home 開啟 Global Routing，選擇 Config、Proxy 或 Direct，再返回確認目前選取的模式。中文所說的設定、代理、直連，分別對應這三個英文介面詞；它們不是三組伺服器資訊，也不會自動補齊連線參數。
| 模式 | 處理方式 | 適用時機 | 檢查重點 |
|---|---|---|---|
| Config · 設定 | 依目前啟用的設定檔規則選擇策略。 | 需要讓不同目標分別使用 PROXY、DIRECT 或 REJECT。 | 已啟用的設定檔、規則順序與最終比對策略。 |
| Proxy · 代理 | 在此模式的處理範圍內使用代理路徑。 | 暫時確認伺服器能否連線至指定目標。 | 目前的伺服器、認證參數與實際連線結果。 |
| Direct · 直連 | 在此模式的處理範圍內直接連線至目標。 | 判斷問題是否也發生在目前的本機網路。 | 本機網路、網域名稱解析及目標的可連線性。 |
切換模式後的驗證方式
先記下原本的模式與目前使用的伺服器，再以同一個目標進行對照測試。若 Proxy 可以連線，但 Config 不行，接著檢查設定檔與規則；若兩者都失敗，優先確認伺服器資訊與基本網路狀態。在 Direct 模式下能連線，也不代表代理參數正確，只表示該目標在這次直連條件下可以連線。
Global Routing 不保證所有系統流量都會得到相同結果。系統網路行為、設定檔中的相關選項與既有連線都會影響測試結果。切換模式後，重新發出目標請求，避免將舊連線的表現誤認為新模式的效果；測試結束後，請恢復原本的日常模式。
Config → 規則
規則類型與策略動作
規則負責比對請求，策略負責決定動作。先檢查順序，再確認單條規則的語法。
在 Global Routing 選擇 Config 時，規則分流才會生效。進入 Config，確認目前啟用的設定檔，再檢視或編輯其中的規則。規則依設定檔中的實際順序由上而下檢查；比對到第一條符合的規則後，就會執行對應策略。FINAL 應放在最後，處理先前未比對到的請求。
依目標特徵選擇規則類型
DOMAIN 用於精確比對網域名稱；DOMAIN-SUFFIX 用於比對指定網域後綴及相關子網域；DOMAIN-KEYWORD 依網域中的關鍵字比對，涵蓋範圍通常較廣。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址網段；GEOIP 則依據 IP 位址歸屬資料判斷。不同類型使用的資訊不同，網域規則與 IP 位址規則不能直接互換。
USER-AGENT 會比對請求中的相關資訊，但並非所有連線都會提供可用於判斷的資訊。請勿將它當成通用的 App 識別方式。編輯前，請確認目前 App 支援的規則語法，以及該規則類型是否適用於目標流量。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ad,REJECT
FINAL,PROXY以上僅為規則順序的教學範例，不建議直接取代現有設定檔。example.com 是範例網域。
區分 PROXY、DIRECT 與 REJECT
PROXY 表示使用代理策略，DIRECT 表示直接連線，REJECT 表示拒絕符合條件的請求。若策略填入可用的策略群組名稱，還需確認該群組最後選取的結果。請注意，介面模式 Proxy 與規則動作 PROXY 的大小寫不同，也不要誤以為 Config 模式下所有請求都必須使用代理。
遠端設定檔更新可能會取代本機修改。若要長期保留調整，請先確認目前檔案的來源與更新方式，並保留可供還原的副本。更多逐步操作說明請參閱使用指南。
Home · Subscribe · Add Server
訂閱與伺服器管理
以下操作以已有的訂閱或伺服器資訊為前提；匯入完成後，仍須確認選取項目與連線參數。
訂閱可集中更新伺服器項目；手動新增則適合管理一組明確的連線參數。訂閱連結請向你的服務供應商取得，並在對應的 Subscribe 入口填入；若要個別新增，請從 Home 進入 Add Server，依據已有資料選擇協定類型並填寫參數。實際入口位置以目前 App 介面為準。
先選擇協定，再填寫連線欄位
Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等協定。不同協定所需的認證與傳輸欄位各不相同，不能只複製位址與連接埠就認定設定完整。請逐項確認伺服器位址、連接埠、密碼或其他認證資訊，並依據現有資料填寫 TLS、傳輸方式等相關選項。
需要掃描 QR Code 時，請使用 Scan QR Code；若要從剪貼簿匯入，先確認剪貼簿內容確實是預期的分享資料。QR Code 與分享連結都可能包含認證資料，不宜上傳至公開頁面。訂閱 URL 也應妥善保管，範例 https://example.com/sub?token=xxxx 僅用於說明欄位格式，不能作為實際連線資訊。
分別處理更新、選取與刪除
透過 Subscribe 更新時，App 會依來源提供的內容更新項目；這不等於更新用戶端，也不保證目前選取的伺服器仍可使用。更新後請檢查項目名稱、數量變化與目前選取的伺服器，再執行 Connectivity Test，並以實際網頁或服務驗證。手動修改訂閱中的項目可能在後續更新時遭到覆蓋，重要參數請另外妥善記錄。
管理多份訂閱時，可使用清楚的備註區分用途與來源。刪除前，請確認操作對象是單一伺服器還是整份訂閱。從清單刪除項目，不代表已取消你與服務供應商之間的服務，也不等於撤銷遠端憑證。
Settings → On Demand
On Demand 按需連線
它決定何時觸發連線，不會取代 Global Routing 對請求路徑的設定。
On Demand 會依據設定的網路條件觸發連線，適合在網路變更時減少重複手動操作。進入 Settings 中的 On Demand，先查看可用條件，再依實際需求設定。若涉及 SSID，請填入所使用 Wi-Fi 的正確名稱，並確認該條件對應的是連線、略過或其他可選動作。
先確認手動連線正常，再新增條件
先停用可能造成干擾的按需觸發，確認目前的伺服器可以手動連線，且 Global Routing 符合預期，再設定一條明確條件。儲存後，分別在符合與不符合條件的網路下測試，觀察連線狀態與實際連線結果。若同時修改伺服器、規則和網路條件，發生問題時就難以判斷是哪項變更造成影響。
On Demand 不是在固定時間啟動的排程工作，也不代表網路切換時所有既有連線都能維持。系統排程、網路可用性與 VPN 設定狀態都會影響觸發。若未觸發，請先檢查條件與系統授權；若連線反覆恢復，也要確認是否仍有按需條件生效，而非不斷重複操作主開關。
何時建立連線與請求如何分流是兩種不同設定：即使 On Demand 已觸發連線，Config 下的 DIRECT 規則仍會讓符合條件的流量直連。出門或更換網路前，建議簡短記下條件設定，避免忘記舊的 SSID 條件。
Data
Data 流量統計
用來查看用戶端記錄的流量變化，不能取代服務供應商的計費紀錄。
Data 提供用戶端端的流量統計。開啟 Data 後，先查看目前介面顯示的統計範圍、時間範圍與分類，再確認上傳、下載或累計值的意義。不同範圍的數值不能直接相減比較；重設前也要先確認會影響哪些紀錄。
以統計資料輔助排查，不要只看總量下結論
排查時，先記錄目前數值，完成一次明確的連線操作，再返回查看變化。若有上傳流量但幾乎沒有下載，可能是請求已送出卻未收到預期回應，但仍須搭配診斷結果與目標狀態判斷。背景活動、其他進行中的請求與連線重試都可能影響統計，測試條件應盡量保持簡單。
用戶端統計與服務供應商帳單可能因統計週期、協定額外開銷或計算方式不同而有差異。Data 顯示的總量不等於剩餘服務額度，也不能據此判斷訂閱是否到期。涉及服務期限或額度時，請以你現有服務的實際紀錄為準。
流量增加不一定代表分流設定錯誤。請先確認是哪類請求造成變化，再檢查 Global Routing 與規則比對結果。若需保留排查紀錄，只要記下測試時間與操作即可；分享前請遮蔽伺服器、網域名稱或其他敏感資訊。
Settings
DNS、測試、同步與診斷
一次只變更一個項目，保留原始設定，再使用同一個目標驗證。
DNS：先確認目前由哪一處管理
DNS 負責將網域名稱解析為 IP 位址。排查時可查看 Settings 中可用的 DNS 相關設定，以及目前啟用的 Config 檔案中的 DNS 區段；修改前，先確認目前的解析行為由哪個層級控制，再調整對應項目。不要一遇到網頁無法開啟，就同時修改多處 DNS；也不要混淆伺服器位址解析與目標網站解析。
延遲測試通過但網頁無法開啟時，請依序確認網域能否解析、規則最終採用哪種策略，以及實際請求是否成功。設定檔中的解析路徑可能與代理請求路徑不同，單一測試結果不足以證明整條連線流程正常。請保留原始設定，修改後重新發出請求，並比較還原設定後的結果。
Test Method 與 Connectivity Test：在相同條件下測量
Test Method 用於選擇可用的測試方式，通常可在 Settings 的測試相關設定中調整；Connectivity Test 則用來啟動連線測試。不同方法測量的環節不同，請在相同網路、相同方法及相近時間條件下比較排序結果。不要只因一次測得的數值較低，就認定所有網站都會更快。
測試失敗時，先確認所選方法的要求，再檢查伺服器參數與網路環境。測試通過後仍須連線至實際目標，確認名稱解析、連線與內容載入都已完成。若更換 Test Method 後結果明顯不同，請記下方法名稱，避免直接比較不同條件下的結果。
Today Widget：作為快速入口使用
Today Widget 提供系統允許的快速查看或操作入口。先在 Settings 確認相關選項，再前往系統的小工具管理介面，查看是否能加入對應項目。可用形式取決於裝置系統與目前 App 實際提供的功能，不應認定所有裝置都必須顯示某種舊版版面。
小工具可能不會即時更新。操作後若狀態與預期不同，請返回 Home 確認實際連線狀態，再檢查系統是否允許相關功能。小工具不是獨立的伺服器設定，也不能取代 App 內的 VPN 授權。
iCloud 同步：區分同步與備份
在 Settings 檢查 iCloud 相關選項，並確認系統是否允許 Shadowrocket 使用 iCloud。開啟前，先了解目前選項說明涵蓋哪些內容；未經確認，不應假設伺服器項目、設定檔、選取狀態與其他設定都會同步。首次使用時，建議先保留本機副本，再到另一部裝置逐項確認。
同步可讓支援的資料在裝置間保持一致，但不保證保留每次修改的歷史紀錄。刪除或錯誤編輯的內容也可能同步到其他裝置，因此同步不能取代獨立備份。同步資料可能包含訂閱 URL 或認證資訊，請妥善保護裝置與 iCloud 帳戶；排查問題時不要公開整份同步資料。
Diagnostics：針對一次失敗請求收集資訊
從 Settings 中的 Diagnostics 或目前介面提供的診斷入口開始，先記錄網路類型、Global Routing、目前使用的設定檔與伺服器，再重現一次失敗請求。依序檢查基本網路、伺服器位址解析、連線建立、規則處理與目標連線，比反覆切換所有設定更容易縮小問題範圍。
診斷紀錄可能包含目標網域、伺服器位址與請求細節。分享前請移除訂閱 URL、認證欄位及其他私人資訊，並優先保留足以說明狀況的最少內容。排查完成後，請還原暫時變更的選項，並停止不再需要的詳細記錄，避免後續操作與舊測試混在一起。