iPhone
適合透過 Home 新增、選取及測試既有連線資訊。購買前請展開商店的相容性說明，確認目前系統符合需求。首次啟用連線時，系統會要求新增 VPN 設定；請確認 App 名稱並了解授權用途後再繼續。
安裝完成只表示用戶端已準備就緒。請先備妥自己的訂閱或伺服器資訊，確認位址、連接埠與驗證欄位完整，再依教學匯入；購買成功不代表連線已可使用。
前往查看 iPhone 取得說明 →Shadowrocket 使用說明 小火箭訂閱匯入與規則分流
適用於 iOS / iPadOS 的規則代理用戶端；確認 App Store 正版與一次買斷資訊後，匯入既有訂閱，再測試規則與連線。
Rules
On Demand
Config
Protocols參數參考 →
- Shadowsocks
- VMess
- VLESS
- Trojan
- Hysteria2
- WireGuard
App Store驗證 →
- Developer
- Shadow Launch Technology Limited
- App ID
- 932747118
Global Routing模式說明 →
- Config
- Proxy
- Direct
- Scenario
先了解 Config / Proxy / Direct 三種基本模式；Scenario 用來依情境整理選項，實際行為請在 App 內確認。
App Store / Devices
裝置相容性與商店入口
先確認裝置與購買帳號，再前往 App Store 產品頁。系統需求、相容性與通用購買資格，均以 App Store 頁面標示為準。
iPad
已購買者請先使用購買 App 時使用的 Apple ID 查看 App Store 的已購項目；兩種裝置是否適用通用購買，以商店頁面標示為準。橫向畫面中的清單與編輯區排列可能不同，操作時可依 Home、Config、Settings 等介面文字尋找功能。
購買紀錄與 App 設定是兩回事。在另一部裝置重新取得 App 後，仍須檢查該裝置上的伺服器清單、目前的 Config 與系統授權。即使使用 iCloud 同步，也應實際開啟設定檔確認內容，不要只憑檔名判斷是否一致。
前往查看 iPad 取得說明 →Mac / Apple TV 也可從同一個 App Store 取得，裝置相容性請以商店頁面標示為準。
商店是否顯示可購買、使用何種貨幣，以及已購紀錄是否可用，請至目前購買帳號所屬的商店確認。若搜尋結果與預期不符，請先使用下方產品頁入口，再核對開發者、圖示與 App ID。
Capabilities
規則設定與連線管理
依需求查找功能：Rules 決定連線路徑，Protocols 對應連線參數，Subscribe 管理匯入來源。On Demand 與 Diagnostics 分別用來處理自動觸發和結果檢查，兩者都不能取代伺服器參數。
Rules：依條件選擇策略
規則分流可區分哪些請求經由代理、哪些直接連線，以及哪些應予拒絕。在 Config 中檢查 Rule 區段，並在 Global Routing 選用 Config 時確認效果。規則通常由上而下比對，具體條件應排在較寬泛的條件之前，並將 FINAL 放在最後作為預設規則。DOMAIN-SUFFIX 用來比對網域後綴，IP-CIDR 用來比對目標位址網段；修改前請先保留原設定，再確認策略名稱與目前可用的選項一致。
- 確認規則順序與比對範圍
- 區分 PROXY、DIRECT、REJECT
- 以實際請求確認比對結果
On Demand：檢查自動觸發條件
On Demand 可依網路等條件觸發連線行為，不代表所有請求都採用相同路由。在 Settings 中進入 On Demand，先確認連線本身可用，再逐項設定所需條件。依 Wi-Fi、Cellular 或網域設定條件時，請一併考量適用範圍與順序，避免多個條件互相覆蓋。儲存後，請分別在目標網路與其他網路測試；若發生非預期的重新連線，先檢查自動觸發設定，再判斷是否為伺服器連線問題。
- 先手動連線，確認基本設定
- 分別測試 Wi-Fi 與 Cellular 條件
- 分開檢查觸發行為與路由策略
Protocols：依既有資訊選擇 Type
支援多種協定，表示可依伺服器設定選擇相應的 Type，不代表不同協定的欄位可以混用。在 Add Server 中先確認 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 或 Hysteria2 等類型，再填入 Host、Port 與相應的驗證資訊。涉及 TLS、傳輸方式或金鑰時，請逐項依照既有設定填寫。即使協定名稱相同，參數也可能不同；不要只切換 Type 就沿用原有欄位，請重新檢查整組連線資訊。
- Type 必須與伺服器端設定一致
- 確認驗證、TLS 與傳輸參數
- 勿以單次測試結果評比協定
Subscribe：匯入並管理既有訂閱
Subscribe 可集中匯入及更新伺服器項目，前提是使用者已有有效訂閱。在 Add Server 中依匯入方式填入完整連結，儲存後檢查來源群組與項目是否出現。更新失敗時，先區分連結無法存取、回傳內容不相容或項目參數不完整，再逐一排查。訂閱更新可能會調整伺服器清單，但不代表目前的 Config 也已變更。連結可能含有存取憑證，分享診斷資訊前請先隱藏相關內容，避免公開完整網址。
- 保留來源標記，方便分組管理
- 更新後確認新增與失效項目
- 分開管理 Subscribe 與 Config
Config：確認目前生效的檔案
Config 用來儲存規則及相關設定，編輯某個檔案不代表它已成為目前使用的設定檔。在 Config 頁面確認選取項目，再檢查 General、Rule、Hosts 等區段。若需使用 iCloud 同步，請在 Settings 檢查相關設定與系統 iCloud 狀態，並在另一部裝置確認實際內容。同步檔案不等於同步所有執行狀態；切換設定前請保留可用副本，修改後返回 Home 確認 Global Routing，再測試受影響的請求。
- 分辨編輯檔案與選取設定檔
- 變更前先儲存可還原的副本
- 同步後確認內容與本機選取項目
Diagnostics：依結果判斷故障範圍
連線開關、Connectivity Test 與實際請求反映不同層面的結果，應一併觀察。在 Home 先測試選取的伺服器，再到 Settings 的 Diagnostics 查看診斷資訊；透過 Data 觀察流量變化時，也要留意統計範圍與觀察時段。延遲測試成功不代表所有目標都能存取，流量計數也無法直接證明規則正確。先檢查本機網路與伺服器參數，再確認 DNS 和規則比對結果；每次只變更一類設定，並保留修改前後的結果以供比較。
- 區分測試可連線與實際請求成功
- 確認 Data 的統計範圍與時段
- 提供診斷資訊前先隱藏憑證
先確認輸入內容與條件。再測試連線與規則結果。
分別選擇 Global Routing 與協定類型
Config 依目前設定中的規則決定請求路徑；Proxy 讓請求透過代理連線；Direct 則直接連線。協定類型描述用戶端與伺服器的通訊方式。變更 Global Routing 無法修正錯誤的密碼、金鑰或連接埠，切換協定類型也不會自動補上缺少的規則。
分別確認統計、同步與自動連線
Data 用來查看統計資訊，iCloud 用來同步相關設定，On Demand 則依條件觸發連線，三者處理的問題各不相同。排查時先釐清是「沒有觸發連線」、「設定未同步」還是「請求未依預期路由」，再前往相應介面檢查，避免同時修改多項設定而無法判斷原因。
Home → Global Routing → Verify
首次連線的三個步驟
從 App Store 安裝 App，並備妥自己的訂閱或伺服器資訊後，再依照以下順序操作。先完成一組可供測試的基本設定，再新增更細緻的分流規則與自動觸發條件。
新增既有連線資訊
在 Home 開啟 Add Server。手動輸入時先選擇 Type，再確認 Host、Port 與驗證欄位；匯入訂閱時請使用自己的完整連結，儲存後確認 SERVER 群組中已出現項目。透過 Scan QR Code 匯入後，也請開啟項目檢查參數。
若儲存後清單仍是空的，先檢查匯入內容與連結是否完整，不要反覆建立同名項目。先保留一筆來源明確的連線進行測試；若協定包含 TLS 或其他傳輸欄位，請確認各項資訊與服務提供者所提供的內容一致，不要只憑欄位名稱猜測填寫。
選擇連線模式與目前設定
返回 Home 選擇要測試的伺服器，再確認 Global Routing。若要依規則分流，請使用 Config，並到 Config 頁面確認目前選取的設定檔；若要暫時區分規則問題與伺服器問題，再對照 Proxy、Direct 的用途。
設定檔存在不代表已選取，檔名相同也不代表內容相同。尤其在另一部裝置匯入或同步後，請檢查 Rule 區段與 FINAL 的策略。初次測試時盡量使用簡單且容易判讀的規則，確認結果後再逐步新增條件。
啟用連線並測試請求
開啟連線開關，並依系統提示授權 VPN 設定。接著執行 Connectivity Test，並連線至自己需要使用的目標，搭配請求紀錄與規則比對結果判斷連線狀況。系統顯示連線標示，只代表相關連線狀態，不能單獨作為目標請求成功的判斷依據。
若測試逾時，先確認本機網路正常，再檢查位址、連接埠、驗證資訊與系統時間；若只有部分目標異常，再檢查 DNS 與規則。每次修改後，都重新測試同一個目標並記錄結果差異。分享訂閱網址或診斷紀錄前，請先隱藏憑證。
Developer / Artwork / App ID
正版辨識與購買資訊
Shadowrocket 是閉源商業 App，僅可透過 App Store 取得。本網站為 Shadowrocket中文官網與官方手冊；購買、相容性及更新資訊請以 App Store 產品頁為準。
確認開發者、官方圖示與 App ID
從商店入口開啟產品頁後，先確認名稱為 Shadowrocket，再查看開發者是否為 Shadow Launch Technology Limited。接著比對本站展示的官方圖示，最後確認產品頁連結中的 App ID 是否為 932747118。名稱只能用來初步辨識，請一併核對以上三項資訊。
搜尋結果可能出現名稱或圖示相似的 App，因此不宜只看搜尋排序或名稱中的單一詞彙。若從搜尋結果開啟的頁面與上述資訊不符，請返回本站取得說明頁，重新開啟指定產品頁。確認購買前，請再次核對 App 名稱與帳號，避免資訊尚未確認就完成付款。
官方圖示可用來辨識產品，但不能取代商店頁上的開發者資訊與產品連結。完成辨識後，系統需求、相容裝置與購買適用性仍應以該產品頁目前顯示的內容為準。
查看三項資訊的辨識步驟 →價格、商店地區與購買範圍
Shadowrocket 採一次買斷，美國商店定價約 2.99 美元，實際金額以 App Store 頁面為準；其他商店則以當地貨幣標示。頁面語言、裝置語言與購買帳號所屬商店並非同一概念，請在目前帳號使用的商店確認價格、付款條件與可購買狀態。
一次買斷說明的是用戶端付費方式，不代表購買內容包含連線服務，也不能據此認定既有訂閱會永久有效。App 購買、伺服器驗證與訂閱效期各自獨立：App 由商店提供，既有連線資訊是否可用，則須匯入用戶端後實際測試。
同一個 Apple ID 在 iPhone 與 iPad 上使用已購項目時，是否適用通用購買，請以商店頁面標示為準。家人共享等購買相關條件也應查看產品頁及系統實際提示，不要只因另一部裝置已安裝，就認定目前帳號已有購買紀錄。
查看價格與買斷說明 →重新取得 App 與還原設定
換機或重新安裝時，請使用購買 App 時使用的 Apple ID，在 App Store 的已購項目中尋找 Shadowrocket。若顯示的購買狀態與預期不同，先確認帳號及商店地區，再查看購買紀錄，避免將重新取得 App 與再次購買混為一談。是否能在目前裝置取得，仍須確認相容性。
還原購買紀錄不會自動補齊所有連線參數。重新開啟 App 後，請分別確認伺服器清單、訂閱來源、目前的 Config 與 VPN 設定授權。若要使用 iCloud 同步，請檢查系統及 App 內的相關設定，並在本機確認檔案內容已完整同步。
刪除 App 前，請先確認重要設定已妥善保存。尤其是手動新增的伺服器資訊、使用者修改過的規則，以及尚未同步的本機檔案，都應另外確認還原方式；「已購項目可重新取得」不代表「本機設定一定能還原」。
查看已購項目還原說明 →透過 App Store 更新與檢查
App 透過 App Store 更新；若系統設定允許，可使用自動更新，或前往商店查看更新紀錄。系統需求與相容性可能變動，操作前請查看產品頁目前的標示；本頁不列出特定版本號或更新日期，以免將靜態說明誤認為即時資訊。
更新後若發現介面排列不同，可依 Home、Config、Settings 等介面文字尋找功能，再確認相關設定是否仍符合預期。若連線行為改變，請先檢查目前選取的伺服器與 Config，不要立刻刪除所有設定。原本可用的參數與測試結果可作為重新檢查的依據。
記錄問題時，可提供操作步驟、網路環境、所選協定與錯誤狀況，但請隱藏訂閱連結中的憑證、密碼與私鑰。提供的資訊若能清楚區分「連線失敗」與「規則結果異常」，後續排查就更容易維持單一變因。
查看匯入與連線問題排查 →購買與初次使用常見問題
已經購買，為什麼還要匯入連線資訊？
購買取得的是用戶端使用資格。請使用自己已有的訂閱或伺服器資訊，在 Add Server 完成匯入後再選取項目測試；App 購買與連線服務是兩回事。可依初次使用教學逐步檢查。
訂閱已更新，為什麼規則沒有跟著變更？
Subscribe 與 Config 管理的內容不同。先確認伺服器群組是否已更新，再檢查目前選取的 Config 與 Global Routing；伺服器項目有變化，不代表規則檔案已替換。請參閱訂閱更新檢查。
Connectivity Test 成功，就代表分流設定正確嗎？
測試成功只表示在所選測試方式下可連線，不足以證明每個目標都依預期策略處理。還須連線至實際目標，並搭配 DNS、規則比對結果與 Data 觀察狀況。請參閱DNS 設定檢查。
Technical Notes
設定細節與技術筆記
以下筆記各自聚焦於單一任務：先了解欄位或觸發條件的意義，再回到自己的設定逐項確認。涉及伺服器參數時，請以使用者已有的資訊為依據，不要只從協定名稱推測伺服器端設定。
Shadowrocket On Demand 自動連線規則：依 Wi-Fi、行動網路與網域觸發
介紹 On Demand 觸發條件的設定方式：依指定 Wi-Fi SSID、行動網路或存取網域自動連線與中斷，以及規則優先順序和常見設定錯誤。先測試手動連線，再逐項新增自動觸發條件。
閱讀筆記 →小火箭多個訂閱如何管理：分組、排序、刪除與重複節點整理
同時新增多個既有訂閱後，如何依來源分組、調整節點順序、刪除失效訂閱，並避免清單中重複出現相同節點。整理前先保留來源標記，並分清楚刪除單一項目與移除訂閱來源。
閱讀筆記 →Shadowrocket WireGuard 設定參數詳解：PrivateKey、PublicKey、Address 與 MTU
說明在 Shadowrocket 中新增 WireGuard 類型節點時，各欄位的用途與資料來源，以及 MTU、DNS、保活間隔對連線穩定性的影響。參數應與既有設定一致，不要在排查問題的截圖中公開私鑰。
閱讀筆記 →