Settings · Official Manual
Shadowrocket 功能與常用設定
先確認 Global Routing，再檢查規則與伺服器，最後調整 Settings。本篇依「是什麼、在哪裡、如何設定、有哪些注意事項」說明常用功能，適合在 iPhone 與 iPad 上操作時參考。
Shadowrocket 是 Apple 平台的付費用戶端，唯一取得管道是 App Store。用戶端一次性購買 ≠ 線路方案；以下內容以使用者已有自己的訂閱或伺服器資料為前提，本網站不提供、不販售也不推薦節點或訂閱。系統需求請以 App Store 頁面標示為準。
- 先選擇 Global Routing
- 接著確認 Config
- 最後驗證 實際請求
Global Routing
三種模式：設定、代理、直連
Global Routing 決定請求以何種方式選擇路徑，不會補齊伺服器資料。在 Home 開啟 Global Routing，可確認 Config、Proxy、Direct 三種模式。需要依網域或位址分流時選擇 Config；需要暫時檢查代理路徑時選擇 Proxy；需要觀察直連狀況時選擇 Direct。變更前先記下原本的選項，排查完畢後再恢復日常使用模式。
| 介面選項 | 運作方式 | 適用情境 | 優先檢查項目 |
|---|---|---|---|
| Config（設定） | 依目前設定中的規則決定策略。 | 日常規則分流、指定網站走代理、區域網路直連。 | 是否已選取設定檔、規則順序，以及最後的預設策略。 |
| Proxy（代理） | 讓由用戶端處理的請求使用代理路徑。 | 暫時判斷異常是否與規則選擇有關。 | 目前伺服器是否有效，以及是否能建立代理連線。 |
| Direct（直連） | 讓由用戶端處理的請求採用直連路徑。 | 比對本地網路狀況，確認問題是否出在代理路徑。 | 目前網路是否能與目標直接通訊。 |
Config 只是模式選擇，還需要在 Config 頁面確認實際使用的設定檔。成功匯入、檔案存在與已選取設定檔是三種不同狀態。修改規則後若沒有變化，先確認目前使用的設定檔，再檢查 Global Routing；不要立刻同時變更所有 DNS、測試方式與伺服器參數。
Config · Rule
規則分流：先比對，再套用策略
規則描述「要比對哪些請求」，策略描述「命中後如何處理」。在 Config 中查看、匯入或編輯設定；使用設定分流時，回到 Home 將 Global Routing 設為 Config。規則通常依照由上而下的順序判斷，由最先命中的規則決定處理結果，因此範圍較窄的規則應放在可能涵蓋它的廣泛規則之前。
常見規則類型包括精確比對網域的 DOMAIN、比對網域及其子網域的 DOMAIN-SUFFIX、依網域關鍵字比對的 DOMAIN-KEYWORD，以及適用於 IPv4、IPv6 位址範圍的 IP-CIDR 與 IP-CIDR6。GEOIP 依據 IP 的地理歸屬進行判斷，不代表網站內容使用的語言或使用者所在位置。位址規則是否命中，也與請求資訊及解析流程有關。
PROXY 表示使用代理路徑，DIRECT 表示直連，REJECT 表示拒絕請求。這些是策略，不是比對類型。FINAL 用來處理未命中前置規則的請求，應放在清單末尾；若放在前面，後續規則可能就沒有比對機會。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT這段範例表示「example.com 及其子網域走 PROXY、指定區域網路位址範圍走 DIRECT，其餘走 DIRECT」，並非可直接使用的完整連線資料。修改前請保留原設定；修改後以明確的目標重新發出請求，並比對連線記錄，確認命中的規則與策略。僅憑網頁能開啟，無法確認實際使用哪一條路徑。
Subscribe · Add Server
既有訂閱與伺服器管理
訂閱用來管理一組伺服器資料，單一伺服器則儲存某個連線的參數。已有訂閱時，在 Home 的新增入口選擇 Subscribe 類型，填入連結並儲存；已有單一伺服器資料時，使用 Add Server，依實際協定填寫位址、連接埠、驗證資訊及相關選項。支援的匯入方式請以目前 App 顯示的入口為準，不要把不同類型的資料勉強填入同一欄位。
Shadowsocks、VMess、VLESS、Trojan 等協定所需欄位不盡相同。伺服器位址不能取代訂閱連結，訂閱名稱也不是驗證資訊。手動填寫時，請依現有資料逐項確認協定、連接埠、密碼或身分識別碼，以及 TLS 等附加參數；名稱主要用來辨識，不會自動修正連線參數。
儲存訂閱後執行更新，確認是否出現預期的伺服器清單，再選擇要使用的項目並執行 Connectivity Test。訂閱更新確認的是「資料是否已更新」，連線測試確認的是「測試目標在目前條件下是否可連線」，兩者驗證的內容不同。若更新失敗，先確認連結是否完整、服務資料是否仍有效，以及目前網路能否連線至訂閱位址。
手動調整由訂閱產生的伺服器時，請留意後續更新可能會覆蓋變更。需要長期保留的自訂資料，應與自動更新的內容明確區分。刪除訂閱前請確認影響範圍，尤其留意是否會一併移除相關伺服器。訂閱位址可能包含個人憑證，分享截圖、記錄或設定前應遮蔽相關內容，也不要將完整連結貼到公開頁面。
On Demand
按需連線：讓連線行為符合網路條件
On Demand 可依照設定條件觸發或調整 VPN 連線行為，不能取代網域分流規則。在 Settings 中找到 On Demand，先閱讀目前頁面提供的條件與動作，再決定是否啟用。不同系統與 App 狀態下顯示的選項可能有所不同，請以裝置上的實際說明為準。
設定前，先確認伺服器與 Config 在手動連線狀態下運作正常。接著只新增一項明確條件，儲存後切換至符合條件的網路，觀察系統 VPN 狀態與實際請求結果。例如，若希望特定網路環境採用不同的連線行為，應在 On Demand 中設定網路條件；若希望特定網站走 DIRECT，則應修改 Config 中的規則，而非嘗試以連線條件取代網站規則。
啟用後，手動中斷連線與條件觸發可能造成看似矛盾的狀況：剛關閉連線，符合條件時卻又顯示已連線。此時先檢查 On Demand 條件，不要反覆刪除伺服器或重設所有設定。排查期間可暫時停用 On Demand，在單一網路下測試；確認基本連線正常後，再逐項恢復條件。
按需連線仍仰賴系統權限、目前網路與可用的伺服器資料，並不保證一定連線成功。測試時至少確認一次進入條件及一次離開條件的過程，並留意從 Wi-Fi 切換至行動網路後，連線行為是否符合預期。
Data
流量統計：區分速率、累計量與計費量
Data 用於查看用戶端記錄的流量，不能直接取代服務端的計費記錄。進入 Data 後，先確認目前頁面的統計範圍、方向與單位，再判斷數字代表上傳、下載、累計傳輸量，還是某個時間點的速率。速率表示單位時間內的傳輸狀況；累計量則是統計期間內的資料總和，兩者不能直接比較。
驗證統計資料時，可先記下目前數值，再執行一次容易辨識的連線操作，接著回到 Data 觀察變化。若介面提供重設選項，請先保存需要的記錄；重設本機統計不會重設服務端額度。也不要將 App 顯示的傳輸量直接視為裝置的全部網路用量，系統統計與用戶端統計的範圍可能不同。
本機記錄與服務端記錄不一致時，請確認統計期間、單位、是否包含多部裝置，以及連線協定造成的額外傳輸量。直連與代理路徑是否分別統計、目前頁面顯示哪些項目，都應依實際介面判斷。不能只因 Data 數值增加，就推斷某條規則已正確命中；驗證路徑仍須搭配連線記錄與請求目標。
持續排查時，建議一併記錄時間、使用的網路、伺服器名稱與 Global Routing 模式。即使累計數值有所變化，也能將變化與具體操作對照，而不是只保留一張缺乏背景資訊的總量截圖。
DNS
DNS：先確認生效位置，再調整解析設定
DNS 負責將網域解析為位址，解析成功不代表後續連線一定成功。檢查時，請一併查看 Settings 中的 DNS 相關選項，以及目前 Config 檔案中是否有 [General] 區段與 dns-server 參數。不要只根據某個設定頁面上的單一值，就認定所有請求都採用相同的解析路徑。
若目前網路運作正常，且沒有明確需求，請先保留原有的解析方式。確實需要調整時，先備份設定，記下原值，再依 App 接受的格式填寫。採用 dns-server = system 的設定會使用系統提供的解析設定，但最終行為仍須配合目前設定與相關 DNS 選項判斷。不同來源的設定應逐項比對，不要整段覆寫。
若遇到「位址可連線但網域無法開啟」，可優先檢查解析；若「網域已有解析結果但連線逾時」，則繼續檢查策略、伺服器與目標服務。不要將所有連線失敗都歸因於 DNS。調整後重新建立連線並發出請求，必要時使用 App 提供的相關診斷入口檢查結果，避免沿用舊連線而得出錯誤結論。
同時調整多個解析選項會增加問題定位的難度。每次只變更一個項目，記錄同一目標在變更前後的結果；若沒有改善，先恢復原值，再檢查下一項。公共網路可能需要先完成網路登入流程，也應在測試前排除此因素。
Settings
測試方式、Widget 與 iCloud 同步
Settings 中的選項各自服務不同環節，不宜一概理解為「提升連線速度」。先確認要變更的是測試方式、系統顯示還是資料同步，再進入相應項目。選項位置與適用範圍請以目前 App 介面為準；本頁不為不同裝置指定統一預設值。
Test Method：統一測試條件
Test Method 決定連線測試採用的方式。在 Settings 中找到 Test Method，依目前介面提供的選項進行選擇，再回到 Home 執行 Connectivity Test。若同時顯示測試目標或逾時等參數，也應一併記錄。比較同一批伺服器時，請盡量保持測試方式、目標、網路環境與測試時段一致。
測試結果只反映所選方式下的一次測試，不能等同於持續傳輸速度。某種測試失敗，不代表所有實際請求都會失敗；反過來說，測試成功也無法證明每個網站都能連線。選擇伺服器後，仍應實際連線至目標，並一併確認規則命中情況。
Today Widget：確認 App 與系統兩側設定
Today Widget 可在系統支援的位置提供快速資訊或操作。在 Settings 中檢查相關選項，再前往系統的 Widget 編輯入口，確認是否已加入對應 Widget。可用的 Widget 類型、顯示內容與互動方式會受到系統支援情況影響，不要將 App 內啟用選項與已在系統中加入 Widget 混為一談。
若沒有顯示 Widget，先回到 App 確認設定，再檢查系統的 Widget 清單；若顯示資訊與剛完成的操作不一致，請開啟 App 確認目前狀態。分享畫面前，留意 Widget 是否顯示伺服器名稱等個人資訊；不要只依據 Widget 上的單一狀態判斷規則路徑。
iCloud：確認同步範圍，再處理衝突
iCloud 同步可在條件允許時同步應用程式資料，不代表所有執行狀態都會還原。先在系統設定中確認目前 Apple 帳號與 iCloud 可正常使用，再到 Shadowrocket 的 Settings 查看同步選項及其說明。實際同步哪些資料、何時同步，請以目前介面為準；不要假設所有設定、統計資料與連線狀態都會同步。
首次啟用或多部裝置的資料不一致時，請先保留各裝置的重要設定，再觀察同步結果。避免在兩部裝置上同時修改同一份資料後，立即反覆開啟或關閉同步。同步也不能取代購買記錄：更換裝置後要還原 App，請在 App Store 使用原購買帳號查找，購買與還原步驟請參閱已購項目還原說明。
Diagnostics · Log
診斷與記錄：針對單次失敗請求定位
Diagnostics 與記錄可提供問題線索，不應將單一提示直接視為最終原因。在 Settings 中尋找 Diagnostics 或相關 Log 入口，先確認目前介面提供哪些檢查與記錄功能。需要收集資料時再啟用相關選項，記錄一次問題重現過程，完成後恢復原設定。
- 固定目前網路，記下 Global Routing、目前使用的 Config 與所選伺服器，暫時避免自動切換條件造成干擾。
- 執行 Connectivity Test，再連線至明確指定的目標，記下失敗時間與狀況。
- 查看同一時段的記錄，依序檢查網域解析、規則命中、策略選擇與連線建立等環節。
- 只調整與現有證據相符的一項設定，再對同一目標重複測試；若沒有改善，請恢復原值。
記錄可能包含瀏覽網域、伺服器位址、訂閱資料或驗證資訊。保存或分享前，請檢查並遮蔽敏感內容，只保留定位所需的時間、錯誤描述與必要背景資訊。不要為了方便而長期記錄所有活動，也不要以反覆匯入新設定掩蓋原本的問題。
本頁旨在說明功能與操作範圍。若要逐項確認 Settings，可繼續閱讀設定指南；遇到特定狀況，可前往常見問題，或依照連線開關已開啟但無法連線的排查步驟繼續檢查。