官方手冊 · 設定參考
Shadowrocket 功能與設定
先確認請求的路由方式，再調整連線、解析與診斷選項。
本頁以 iPhone / iPad 操作為主。各節依序說明功能用途、入口位置、設定方式，以及哪些狀況不能只憑單一開關判斷。介面配置可能因裝置與 App 更新而有所不同，請以目前 App 顯示的選項為準。
配置、代理、直連：三種路由模式
啟用連線後，Global Routing 會決定請求採用哪種處理方式。它不是伺服器清單，也不會自動補上缺少的連線參數。
入口與設定：在 Home 開啟 Global Routing，選擇 Config、Proxy 或 Direct，接著返回確認目前的 SERVER 與連線開關。此處的「配置、代理、直連」分別指對應的英文選項；Config 模式與底部用來管理檔案的 Config 頁面相關，但並非同一個操作入口。
| 模式 | 處理方式 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config · 配置 | 依目前啟用的配置規則與策略處理請求。 | 日常依網站、網域或 IP 位址分流。 | 確認配置已啟用，且規則順序與最終策略正確。 |
| Proxy · 代理 | 將由用戶端接管的請求交由目前的代理策略處理。 | 暫時確認選取的伺服器能否完成目標請求。 | 確認伺服器可用；測試結果不代表所有 App 的連線狀況。 |
| Direct · 直連 | 以直連方式處理由用戶端接管的請求。 | 比對本地網路狀況，或暫時改走直連路徑。 | 選擇路由模式不代表已關閉系統 VPN 連線。 |
建議順序：已有可用配置時，先選擇 Config。若特定目標連線異常，可暫時切換至 Proxy 或 Direct，使用相同網路與目標進行比對。測試結束後切回原模式，避免將暫時的排查設定當成日常設定。
注意：Proxy 無法修復失效的認證資訊、錯誤的連接埠或無法連線的伺服器；Direct 也不代表用戶端已停止連線。若要停止連線，請檢查 Home 的連線開關與系統 VPN 狀態。切換模式後，既有的長連線可能仍沿用舊路徑；必要時，請重新建立目標 App 的連線再判斷。
規則分流：比對條件與策略
規則用來判斷「這項請求是否符合條件」，策略則決定「符合後如何處理」。了解這兩部分，才能判斷特定網站為何走 PROXY 或 DIRECT。
入口與設定：在 Config 找到目前使用的配置並先行備份，再透過配置的編輯入口檢查規則。返回 Home，將 Global Routing 設為 Config。將檔案匯入 Config 清單，不代表該檔案已生效；還要確認目前啟用的項目。
常用的 DOMAIN 比對完整網域，DOMAIN-SUFFIX 比對網域後綴，DOMAIN-KEYWORD 則檢查網域中的關鍵字。IP-CIDR 與 IP-CIDR6 用於比對 IP 位址網段；GEOIP 依 IP 位址所屬的地區資料庫進行比對。USER-AGENT 是否能比對，取決於請求中的相關資訊是否可見，不應視為適用於所有加密連線的 App 識別方式。
| 關鍵字 | 比對內容 | 設定注意事項 |
|---|---|---|
DOMAIN | 完整網域 | 適合只處理明確指定的主機名稱。 |
DOMAIN-SUFFIX | 網域後綴及其子網域 | 確認後綴涵蓋範圍，避免比對範圍過廣。 |
IP-CIDR | IPv4 位址網段 | 目標的解析結果與規則順序都會影響判斷。 |
FINAL | 未符合前面任何規則的請求 | 放在末尾，明確指定預設處理方式。 |
DIRECT 代表直連，PROXY 使用對應的代理策略，REJECT 則拒絕符合條件的請求。若使用自訂策略名稱，名稱必須與配置中實際定義的名稱一致。規則通常依序比對，條件明確的規則應放在範圍較廣的規則之前；移動規則的位置，有時比修改規則內容更能直接改變結果。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT以上僅為教學用的最小規則範例：example.com 及其子網域走 PROXY，其餘請求由 FINAL,DIRECT 處理。這不是完整配置，也不包含伺服器資訊。儲存修改後，使用目標網域重新發出請求，再搭配連線記錄確認比對結果；不要只看瀏覽器是否成功載入頁面。
需要進一步了解時，可參閱指定網站走 PROXY 的規則寫法。修改遠端配置前，也要留意更新策略：之後重新取得檔案時，可能會覆蓋本機編輯內容。
訂閱與伺服器管理
伺服器記錄保存連線所需的參數，Subscribe 用來更新一組既有記錄，Config 則管理規則與相關配置。三者用途不同，不應只因名稱相近就互相取代。
使用前提：使用者已備妥自己的訂閱或伺服器資訊。一次買斷用戶端 ≠ 線路方案。購買 Shadowrocket 取得的是用戶端使用權，仍須自行準備有效的連線參數；本手冊僅說明如何匯入、整理及使用現有資訊。
入口與設定：在 Home 點選新增入口，進入 Add Server。手動新增時，先依現有資訊選擇 Type，再填入 Address、Port 及協定要求的認證欄位。Shadowsocks、VMess、VLESS、Trojan 等類型所需欄位並不完全相同，不能只更換 Type，卻沿用所有舊值；傳輸方式、TLS 與伺服器名稱等其他設定也要逐項核對。
匯入訂閱時選擇 Subscribe，填入自己的完整訂閱網址並儲存。支援的分享內容也可透過 Scan QR Code 或剪貼簿匯入；匯入後仍須檢查 Type、位址與連接埠，不要把「辨識成功」當成「連線成功」。訂閱網址可能包含存取憑證，請勿貼在公開截圖或問題描述中。
多組訂閱可使用容易辨識的備註標示用途；更新後，請檢查記錄是否增減，以及目前選取的項目是否仍存在。訂閱中的記錄通常由遠端內容管理，直接修改欄位可能會在下次更新時被取代。若要保留個別調整，請先確認備份與另行儲存的方式，再進行編輯。
測試與整理：使用 Connectivity Test 前，先確認 Test Method，再測試候選伺服器。延遲結果只反映該測試方法與目標下的回應狀況，不代表傳輸速率，也不保證特定網站一定可用。選定 SERVER 後，重新發出實際請求；刪除舊記錄前，請確認目前配置或日常操作已不再使用該記錄。
掃描 QR Code、匯入分享內容、更新與備份的完整操作步驟，請參閱訂閱與伺服器管理手冊。若匯入後清單為空，先確認連結是否完整及現有訂閱狀態，不要連續建立多筆相同記錄。
隨選連線與網路切換
On Demand 是觸發連線的機制，不是決定網站採用哪條路徑的規則。連線建立後，個別請求仍由 Global Routing 與目前配置控制。
入口與設定：在 App 中找到 On Demand 相關設定，先查看目前的啟用狀態與既有條件，再依實際需求調整。不同裝置上的入口位置與可選條件，以 App 顯示為準。首次使用時，建議先在 Home 手動確認伺服器與配置運作正常，再啟用隨選連線。
如果目前介面支援依網路類型或 Wi-Fi 條件設定連線行為，請先從容易驗證的一項條件開始。儲存後，在預期使用的網路中觀察系統 VPN 狀態；再切換至另一個網路，確認連線是否依設定改變。一次新增多項條件，會讓觸發連線的條件變得難以判斷。
注意：啟用 On Demand 後，只在 Home 手動中斷連線，條件再次符合時仍可能自動重新連線。若要暫時停用，也請一併檢查隨選連線設定。On Demand 不一定能節省電量：網路品質、重新連線頻率與持續請求都會影響電池用量，請依一段時間的實際使用狀況判斷。
流量統計與觀察範圍
Data 用來查看用戶端記錄到的流量變化，可協助判斷連線活動，但不能作為網路帳戶的計費依據。
入口與設定：開啟 Data，先確認目前檢視畫面所統計的對象、流量方向與時間範圍。觀察上傳與下載變化前，先記下起始數值；若要清除統計，請先保存需要的記錄，再使用目前介面提供的重設入口。排查途中不要清除統計後，又直接比較新舊數值。
驗證時可先關閉無關的前景工作，使用同一個目標完成一次請求，再返回 Data 觀察變化。若目標 App 正在背景更新，或仍有媒體播放與同步工作，流量增加不一定是剛才開啟的頁面所造成。顯示有流量，只能表示有資料傳輸活動，不能單獨證明特定請求符合預期規則。
注意：用戶端、系統行動網路統計與現有服務的用量記錄，可能採用不同的統計範圍、週期與計算方式。資料傳輸路徑、協定額外負載，以及是否包含直連請求等因素，都可能造成數值差異。查詢剩餘用量時，請以對應帳戶的記錄為準；排查路由時，則應搭配 Data 與連線記錄一起判斷。
DNS、測試與同步設定
Settings 中的選項會影響不同層面。建議先保留一組可用的基準設定，不要因單一目標異常，就同時修改 DNS、測試方法與所有連線參數。
DNS：檢查網域解析方式
用途與入口：DNS 會將網域名稱轉換為連線所需的位址。相關選項可能位於 Settings 與目前的 Config，排查時應一併確認。先確認配置是否已定義解析方式，再判斷需要修改哪項實際生效的設定。
設定方式：記下目前的解析設定，依自己的網路與配置需求調整一項選項，重新建立連線，再使用相同網域測試。若 IP 位址可連線但網域無法連線，DNS 值得列入檢查，但不能因此直接認定只有 DNS 出錯；TLS、目標服務狀態與規則比對也可能影響結果。
注意：網域解析結果也可能影響位址類規則的比對。切換解析方式後，請檢查目標回傳的位址與比對策略，不要把「解析成功」等同於「請求一定依預期路由」。既有快取與長連線可能讓變更暫時不明顯，請使用新連線進行驗證。
Test Method：讓測試結果可供比較
用途與入口：Test Method 是 Connectivity Test 使用的測試方式，可在 Settings 中查看。不同方法可能檢查不同的目標與連線階段，因此同一台伺服器在不同方法下得到不同結果，並不矛盾。
設定方式：比較伺服器前，請固定測試方法；若目前選項允許指定測試目標，也應使用相同目標。在同一個網路環境中重複測試，並搭配實際網站請求判斷穩定性。單次逾時不代表所有連線都失敗，也不要只依據一次測得的最低數值長期固定選擇伺服器。
Today Widget：快速操作與狀態查看
用途與入口：Today Widget 用於系統提供的對應小工具區域，相關偏好設定可在 Settings 中查找。小工具能否新增及可顯示哪些操作，須視裝置系統與 App 的實際支援情況而定。新增後，先確認顯示內容是否符合預期。
設定方式與注意事項：若需要快速控制，請依系統的小工具管理方式新增，再返回 Home 核對狀態。小工具畫面與系統連線狀態可能有更新延遲，不能只憑單次顯示判斷連線已建立。若操作異常，先回到 App 確認，再處理小工具顯示問題。
iCloud：同步不等於備份確認
用途與入口：在支援的情況下，iCloud 相關同步選項可用來儲存或同步 App 資料。先確認系統 iCloud 可正常使用，並查看 App 內的相關選項，再確認目前介面標示的同步範圍；不要預設所有訂閱、配置、歷史記錄與認證資訊都會一併同步。
設定方式與注意事項：首次啟用或更換裝置前，請另行保留備份，並在另一台裝置逐項核對記錄。兩台裝置同時編輯相同內容時，請留意資料遭覆寫或發生衝突。訂閱與配置可能包含敏感連線資訊，備份、同步與匯出時都應確認儲存位置及存取權限。
診斷設定與故障排除順序
Diagnostics 用來蒐集排查線索。有效的診斷不是長時間開啟所有記錄，而是透過一次可重現的請求，找出具體的失敗環節。
入口與設定：在 Settings 中尋找 Diagnostics 或相關診斷入口，閱讀目前工具的說明，再啟用本次檢查所需的記錄。先記下網路環境、Global Routing、目前的 SERVER 與配置名稱，再重現一次問題，避免多次切換條件而混淆線索。
- 先檢查連線層。確認 Home 的連線開關與系統 VPN 狀態，並檢查目前網路能否完成基本請求。
- 接著檢查伺服器。核對目前選取的伺服器與現有認證資訊，使用固定的 Test Method 執行 Connectivity Test。
- 檢查解析與規則。針對同一個目標確認網域解析、比對條件與最終策略，必要時暫時切換模式進行比較。
- 最後返回目標 App。重新建立連線並再次測試，將 Data 的變化作為輔助線索，而非判定成功的依據。
注意：「測試有回應」、「系統顯示已連線」與「目標網頁成功開啟」分別代表不同層面的狀況，不能互相取代。若只有一個網站異常，先針對該網域與對應規則排查；若所有請求都異常，再檢查共通的伺服器、網路與配置因素。檢查完成後恢復原設定，並關閉不再需要的詳細診斷記錄。
分享排查資訊前，請遮蔽訂閱網址、密碼、認證欄位與不必要的存取記錄，只保留理解問題所需的錯誤狀況與操作步驟。更多情境說明請參閱常見問題；若要依序完成匯入到首次連線，請前往使用說明。