Shadowrocket 功能介紹
與常用設定檢查
先確認流量經過哪條路徑，再調整連線條件與診斷選項。每次只修改一項，並以相同目標驗證結果。
本頁以 iPhone / iPad 操作為主。Shadowrocket 是 Apple 平台付費用戶端，唯一取得管道為 App Store。系統需求請以 App Store 頁面標示為準。
查看首次連線步驟 →Global Routing：設定、代理與直連
Global Routing 位於 Home，可決定連線依照設定檔處理，或統一採用某種路徑。三個選項為 Config、Proxy、Direct。它們是路由模式，不是伺服器協定，也不是網路品質等級。切換前，先確認 Home 中選取的伺服器，再核對 Config 目前使用的設定檔。
| 模式 | 處理方式 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config（設定） | 依照目前設定檔中的規則選擇策略。 | 需要依網域或目標位址進行分流。 | 目前設定檔、規則順序、最終策略。 |
| Proxy（代理） | 將通常由此模式控制的連線交由代理路徑處理。 | 暫時檢查所選伺服器能否承載目標連線。 | 伺服器可用性、目標連線與記錄。 |
| Direct（直連） | 讓連線透過本機網路直連。 | 比對本機網路是否能連線至相同目標。 | 本機網路狀態；不代表關閉系統 VPN 設定。 |
日常使用規則分流時，請選擇 Config。若無法連線至某個網站，可記下目前模式，暫時切換至 Proxy，再以相同網站重新測試；若 Proxy 正常但 Config 異常，接著檢查命中的規則與策略。若要判斷本機網路是否異常，可用 Direct 作為對照。測試後請恢復原模式，不要將一次性的測試當成長期設定。
切換模式不會補齊錯誤的伺服器欄位，也無法修復已過期的連線資訊。開關顯示已連線，只代表連線已建立至相應階段，不表示所有目標都能連線。驗證時請一併查看網頁、請求記錄與錯誤提示，不要只看開關顏色。
規則分流：比對條件與執行策略
規則分流會將「要連線的目標」與「採用的路徑」分開設定。進入 Config，確認目前選取的檔案，再查看或編輯其中的 [Rule]。Global Routing 使用 Config 時，這些規則才是排查分流行為的主要依據。修改前請先備份原始檔，避免將訂閱、伺服器與設定檔混為一談。
DOMAIN 用於比對完整網域；DOMAIN-SUFFIX 用於比對網域後綴及其子網域；DOMAIN-KEYWORD 依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍；GEOIP 使用 IP 位址歸屬資料。USER-AGENT 取決於是否能取得請求資訊，不宜假設它能涵蓋所有加密連線。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-SUFFIX,ads.example.net,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY以上是語法範例，並非適用於所有網路的完整設定。PROXY 代表交由代理處理，DIRECT 代表直連，REJECT 用於拒絕符合條件的連線。設定也可能引用自訂策略群組；此時還需確認群組名稱存在，以及群組內選取的項目。規則中的策略名稱與 Global Routing 選項屬於不同層級，不要只因名稱相似就視為相同設定。
規則通常依序比對，應將條件較明確的規則放在範圍較廣的規則之前，並將兜底規則 FINAL 放在最後。新增規則後，只測試對應目標並確認實際命中的項目。如果修改後許多網站都同時異常，請先還原備份，再檢查是否誤改兜底策略或引用名稱。查詢關鍵字可參閱概念速查。
訂閱與伺服器管理
Home 的 SERVER 清單可用來選取現有伺服器。單一伺服器項目會儲存協定與連線欄位；訂閱則用於批次匯入及更新伺服器資訊。訂閱更新成功只表示清單已取得並完成解析，不代表清單中的每個項目都通過連線測試，也不代表規則檔已正確選取。
Add Server 與匯入現有資訊
從 Home 的新增入口進入 Add Server，先選擇 Type，再依自己的伺服器資料填寫位址、連接埠與驗證欄位。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的欄位意義各不相同。若資料包含傳輸方式、TLS、伺服器名稱或路徑，請逐項保持一致，不要依照其他協定的經驗自行補填。
使用 Scan QR Code 或剪貼簿匯入後，仍需開啟項目檢查類型、位址與連接埠。QR Code 可能包含敏感驗證資訊，請勿將其截圖公開分享。匯入成功的判斷方式是清單中出現預期項目且欄位完整；能否連線至目標，仍須另外測試。
Subscribe 更新與清單整理
若已有訂閱，可在 Add Server 中選擇 Subscribe，並填入自己的訂閱網址。更新前請確認網址完整，尤其留意複製時帶入的空格、換行與失效參數。更新後檢查群組與項目是否符合預期，再選取要使用的伺服器。刪除訂閱群組前，請先確認是否已保留原網址及必要的手動新增項目。
伺服器測試結果有數值，不代表實際連線速度或所有目標都能連線。建議在相同網路下使用相同 Test Method 進行比較，再以實際連線驗證。訂閱網址通常具有存取權限，請勿貼在公開記錄或求助內容中。若訂閱失敗，先查看錯誤提示與本機網路，再檢查自己現有服務的網址狀態。
On Demand：按需連線
On Demand 可依設定的網路條件觸發 VPN 連線。它與 Global Routing 的用途不同：前者決定何時連線，後者決定連線啟用後如何處理流量。可在 Settings 中尋找 On Demand，先檢查總開關，再確認目前可用的網路條件與規則。
首次設定時，先關閉自動觸發並完成一次手動連線測試。確認伺服器與設定可用後，再啟用所需條件。若要依 Wi-Fi 網路區分行為，請確認網路名稱正確；若涉及行動網路，也應分別測試。可選條件依目前 App 介面而定，不要將某種網路下的測試結果直接套用到其他網路。
設定後先中斷連線，再切換至預期會觸發連線的網路，觀察 Home 狀態是否符合預期；接著切換至不應觸發的網路重新測試。若手動關閉後又自動連線，請先檢查 On Demand 與系統 VPN 設定中的按需連線行為，不要反覆刪除設定。按需連線只能執行既有條件，無法判斷伺服器資料是否仍有效。
Data：流量統計與觀察範圍
Data 用於查看用戶端記錄的流量情況。進入 Data 後，先確認頁面顯示的統計期間、上傳與下載方向，以及是否依伺服器或其他項目分類。不同統計項目的起算時間與計算方式可能不同，請依介面標示理解，不要直接將總量視為某次網頁瀏覽的流量。
若要觀察某項操作，先記下目前數值，再執行一項明確操作，例如開啟已知網頁，接著返回 Data 比較變化。背景同步、媒體預載與其他 App 的請求也可能同時產生流量。因此，數值變化可用來輔助判斷是否有持續傳輸，但不適合單獨用來確認某個 App 的精確用量。
若要清除或重設統計資料，請先記錄需要保留的資訊，並確認操作範圍。用戶端統計與自己現有服務的計費統計，可能因統計期間、傳輸額外負載及計算方式不同而有差異。服務用量請以自己現有服務的記錄為準。Data 也不是速度測試：累積流量較大，不代表目前連線速度較快。
Settings：DNS、測試與同步
Settings 集中管理 App 層級的選項，但並非所有網路參數都只在此處生效。部分參數由 Config 中的檔案控制。檢查時先確認設定來源，再判斷其作用範圍；切換設定檔後，也請重新核對相關參數，避免誤以為先前的修改仍然生效。
DNS：先檢查解析，再檢查連線路徑
DNS 會將網域名稱解析為目標位址。若伺服器測試正常但網頁無法開啟，可先檢查目前設定中的 DNS 相關項目，再確認 Settings 實際提供的 DNS 選項。重點在於 DNS 伺服器能否透過目前網路連線，以及是否同時有其他設定覆寫。不要為了單次測試一次替換所有 DNS 設定，否則難以判斷問題出在哪一項。
儲存原有設定後，選擇一個有問題的網域重新測試，並確認是否仍出現解析錯誤。DNS 正常不代表後續連線也正常；若已取得位址但連線逾時，應繼續檢查伺服器路徑與規則。涉及 IPv6 時，也應考量本機網路的支援情況，不要將所有網域問題都歸因於同一個開關。
Test Method：確認測試項目
在 Settings 中查看 Test Method，確認目前選用的測試方式及介面顯示的相關參數。不同方法測量的連線階段不同，因此同一台伺服器在不同方法下的結果不能直接排序比較。更換方法後，返回 Home 的 Connectivity Test 重新測試，並記錄當時的網路條件。
測試結果主要用於判斷連線問題發生在哪個階段。單次測試成功，不代表驗證、DNS、目標網站與持續傳輸都正常；單次逾時也可能與測試目標本身有關。若要比較多台伺服器，請保持測試方法與網路一致，再以實際連線補充驗證。
Today Widget：檢查顯示與可用入口
Today Widget 用於設定與系統小工具相關的資訊顯示或快速操作。先在 Settings 檢查 App 提供的選項，再到系統的小工具管理處確認是否能加入及顯示。可用形式取決於裝置系統與目前 App 的支援情況，請以實際介面為準。
若小工具狀態未即時更新，請先開啟 App 檢查 Home 的實際狀態，再檢查系統端的小工具設定。不要只依小工具上的文字判斷連線已建立，也不要將小工具未更新直接視為伺服器故障。
iCloud 同步：先確認同步範圍
在 Settings 查看 iCloud 相關選項，同時確認裝置已啟用相應的系統 iCloud 權限。啟用前請先備份本機設定，並逐項閱讀介面說明，確認哪些資料會參與同步。不要將同步開關理解為所有伺服器驗證資料、歷史統計與系統 VPN 授權都會自動移轉。
在另一台裝置上開啟 App 後，檢查實際出現的項目、目前選取的設定檔與伺服器，再進行一次手動連線。若資料不一致，請先停止在多台裝置上同時編輯，分別保留需要的內容，再判斷同步狀態。訂閱中的敏感網址與驗證欄位仍應視為私密資料妥善保管。
Diagnostics：記錄現象與重測結果
Diagnostics 用於檢查診斷資訊。進入 Settings 中的相應入口後，使用目前介面提供的工具查看或記錄故障。診斷應從可重現的問題開始，而非同時修改大量選項。先記下目前網路、Global Routing 模式、所選伺服器、目前設定檔，以及發生失敗的目標。
- 固定重現條件。維持相同網路與目標，記錄錯誤是解析失敗、連線逾時，還是連線後傳輸中斷。
- 縮小問題範圍。檢查 Connectivity Test，再查看解析與規則命中情況。若只有單一目標異常，優先檢查該目標對應的規則與路徑。
- 每次只修改一項。修改後重複原本的操作並比對結果；若未改善，請還原原值，再檢查下一項。
- 整理必要證據。記錄失敗時間、相關錯誤及修改前後的差異，不要提交包含驗證資訊的完整設定檔。
分享診斷文字前，請刪除訂閱網址中的存取參數、密碼、UUID、金鑰及其他可辨識的私密資訊。記錄中出現一次錯誤，不代表整體連線都無法使用，請配合錯誤發生時間與實際症狀判斷。問題可穩定重現後，可參閱故障排除手冊繼續檢查，不要反覆重新安裝或覆蓋所有設定。