iPhone
透過 App Store 完成購買與安裝。首次建立連線時，請確認系統要求加入的 VPN 設定，再依提示授權；顯示連線狀態後，還要檢查目標網站是否可存取，以及實際分流結果。
查看 iPhone 取得說明 →取得與首次開啟
先確認 App Store，再匯入既有設定
Shadowrocket 僅於 App Store 發售。進入產品頁後，先確認開發者、官方圖示與 App ID，再查看目前商店的價格及裝置相容性。已購買的使用者，請先查看自己的已購項目，再決定下一步操作。
iPad
使用同一個 Apple ID 查看已購項目，並可在適用的 iPad 上取得 App。App 購買記錄與本機設定是兩回事；安裝後仍須確認伺服器、目前的 Config 與授權狀態。購買適用範圍請以 App Store 頁面標示為準。
查看 iPad 取得說明 →Mac / Apple TV 也可透過同一個 App Store 取得；系統需求與購買適用範圍請以 App Store 頁面標示為準。
設定項目與使用範圍
規則、連線與設定檔管理
先區分伺服器參數、設定檔與路由選擇：伺服器決定如何建立連線，Config 儲存規則等設定，Global Routing 則決定目前連線的處理方式。遇到問題時分別檢查，避免將單次失敗歸因於所有設定。
Rule 分流
在 Home 的 Global Routing 選擇 Config 後，連線會依目前啟用設定檔中的 Rule 處理。網域、網域後綴與 IP 網段使用不同關鍵字，規則順序也會影響比對結果。先設定範圍明確的比對，再檢查 FINAL 的收尾處理。PROXY、DIRECT、REJECT 分別代表不同處理方式，並非伺服器名稱。驗證時請查看實際要求的命中記錄；只看到連線開關已開啟，不能證明某條規則已生效。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXYOn Demand
On Demand 用於依設定條件要求建立連線，入口位於 Settings。請先確認手動連線正常，再檢查觸發條件是否符合目前網路狀況。它無法修正錯誤的伺服器參數，也不代表所有要求都會經由 PROXY。需要暫時停止連線時，也要留意相關觸發設定，避免之後再次自動連線。排查時可先暫停 On Demand，在同一個網路環境下進行手動測試；確認基本連線穩定後，再逐一恢復需要的條件。
Settings
On Demand
Global Routing: Config多種協定
透過 Add Server 的 Type 選擇與既有伺服器相同的協定，再填入對應欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的參數結構各不相同，不能只替換 Host，沿用其他設定。請依服務商提供的資料逐一確認連接埠、認證、傳輸與 TLS 資訊。WireGuard 還須區分本機私鑰與對端公鑰。成功匯入只代表資料可被辨識，能否連線仍取決於參數是否完整及伺服器目前狀態。
Add Server
Type
Host
Port透過 Subscribe 匯入
匯入前提是使用者已有自己的訂閱或伺服器資訊。先確認連結內容是伺服器清單還是設定檔，再使用對應的 Subscribe 或匯入入口；Config 中的設定檔網址與伺服器訂閱並非同一種資料。更新後請確認項目數量、分組及目前選取項目是否有變化，不要反覆匯入相同連結來取代更新。訂閱網址可能含有個人存取憑證，提交問題或分享螢幕畫面前，請遮蔽完整網址。本手冊僅說明匯入與檢查方法。
Subscribe
Add Server
Scan QR Code設定檔
Config 用於儲存及選取設定檔，Rule、Hosts 等內容應在目前啟用的檔案中檢查。編輯前先保留可還原的副本，並記下原本的路由選擇；修改後重新驗證實際要求。若使用 iCloud 同步，請確認兩部裝置登入同一個帳戶、同步設定已開啟，且目標檔案已出現；同步不能取代完整備份。伺服器可連線但分流異常時，優先確認目前使用的 Config，避免持續修改未啟用的檔案。
[General]
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT診斷工具
先使用 Connectivity Test 檢查基本連線，再搭配 Settings 中的 Diagnostics 與連線記錄縮小問題範圍。Data 的流量讀數可協助判斷是否有實際傳輸，但不能單獨證明某個網站已依預期分流。測試前記下所選伺服器、Global Routing 與目前網路，每次只變更一個條件。若測試可連線但目標網站仍無法存取，請繼續檢查 DNS、規則命中及遠端服務狀態；分享記錄時，請隱藏網址中的憑證與認證資訊。
Connectivity Test
Settings → Diagnostics
Data首次連線流程
匯入、選擇模式、驗證
以下三個步驟適用於已備妥訂閱或伺服器資訊的使用者。先完成一條可重複驗證的連線，再新增規則、同步或自動觸發設定。每個步驟都保留檢查結果，發生異常時即可回到前一個已確認正常的狀態。
- 01 · 新增既有伺服器或訂閱
依資料類型選擇 Add Server、Subscribe 或 Scan QR Code。儲存後先確認 Type、Host 與 Port，確保內容與原始資料相符。 - 02 · 選擇 Global Routing
日常規則分流請選 Config，並確認已啟用的設定檔。Proxy 與 Direct 代表不同處理方式，測試後請恢復至預期選項。 - 03 · 開啟開關並驗證連線
確認 VPN 設定已授權，執行 Connectivity Test，再瀏覽目標網站並檢查規則記錄。開關狀態、連線結果與規則命中須分別判斷。
Config 依規則決定處理方式；Proxy 讓需要代理的連線經由代理路徑；Direct 則採直連路徑。這些選項說明的是「如何處理連線」，並不代表伺服器是否有效。所謂 Shadowrocket 全域模式，通常指 Global Routing 的選擇；操作前請先確認要驗證的是伺服器還是規則。
首次測試失敗時，不要同時更換伺服器、修改 DNS 又重寫 Rule。先確認裝置本身的網路正常，再檢查伺服器參數與認證資訊，最後依據命中記錄處理規則問題。系統的 VPN 標示只反映設定的連線狀態，不代表所有目標都已連線；某項測試成功，也不代表其他網域會採用相同路徑。
正版確認與購買須知
開發者、圖示與 App ID
Shadowrocket訂閱教學是 Shadowrocket（小火箭）官方網站與手冊。購買與安裝請以 App Store 產品頁為入口，介面操作則以 App 內實際顯示為準。確認產品身分時，應同時核對三項資訊，不能只憑搜尋結果中的名稱判斷。
- Shadow Launch Technology Limited
- App ID 932747118
- App Store 官方圖示
在產品頁確認身分
開啟產品頁後，確認開發者是否為 Shadow Launch Technology Limited，並與本站頁首的官方圖示比對。接著檢查產品連結中的 App ID 是否為 932747118。名稱相似的搜尋結果不能取代這三項確認；若有任何一項不符，請返回確認入口，不要只憑圖示顏色或名稱判斷。
Shadowrocket 是閉源商業應用程式。產品身分、購買與相容性等資訊應以 App Store 頁面為準；本站的規則片段僅用於說明設定語法，不能取代完整且可用的個人設定。
商店地區與搜尋結果
App Store 搜尋結果會依目前 Apple ID 使用的商店而異；裝置所在地與介面語言不等於帳戶所屬的商店地區。搜尋不到時，請先確認目前使用的商店，再透過產品頁入口查看具體提示。地區顯示、帳戶狀態與裝置相容性應分開檢查；搜尋沒有結果，本身不能代表應用程式身分有所變更。
若產品頁提示裝置不相容，請先查看相容性欄中的要求，再確認裝置系統。系統需求一律以 App Store 頁面標示為準。商店與帳戶的確認流程，請參閱正版指南。
一次性買斷與多部裝置
美國商店價格為 2.99 美元，採一次性付費；各地商店以當地貨幣顯示，實際結帳金額請以 App Store 頁面標示為準。iPhone 與 iPad 可透過同一個 Apple ID 的購買記錄取得 App；裝置相容性與購買適用範圍請以 App Store 頁面標示為準。要確認是否已購買，請查看已購項目，不要只憑裝置上是否有圖示判斷。
同一筆購買記錄不代表兩部裝置的本機設定會自動完全一致。安裝後仍須確認伺服器資料、選取的 Config 與連線授權。若使用同步，請先確認目標裝置已收到所需檔案，再開始連線測試。
更換裝置後復原與後續更新
更換裝置或重新安裝時，先登入原本購買時使用的 Apple ID，再到 App Store 的已購項目中尋找 Shadowrocket。若畫面顯示需要付款，請先核對帳戶、購買記錄與商店提示，避免重複操作。App 復原與設定復原應分開處理：已購項目用於重新取得 App，伺服器資料與個人規則則應從自己保存的可信記錄還原。
App 更新透過 App Store 進行，可在商店查看更新說明與自動更新設定。若涉及家人共享，是否適用及使用條件請以 App Store 頁面標示為準；不能直接將另一位家庭成員的購買視為本帳戶已購。
依問題來源分別處理，會更清楚：購買與復原問題先檢查 App Store 帳戶及購買記錄；訂閱更新失敗先確認既有連結與服務狀態；已能建立連線但分流不符，則檢查 Global Routing 與目前的 Rule。變更前記下原本設定，變更後以相同目標重新測試，才能判斷是哪個步驟造成影響。
常見問題
匯入 Subscribe 後，為什麼還要檢查 Config？
伺服器清單與設定檔的用途不同。訂閱會更新伺服器資料，目前的 Config 則決定規則等設定；兩者都成功儲存後，仍須確認目前選取的伺服器與 Global Routing。可在術語表中查閱 Subscribe、Config 與 Rule 的意思，再依教學逐項檢查。
Connectivity Test 成功，是否代表規則已正確生效？
不能直接這樣判斷。測試結果只代表特定測試條件下的連線狀況。請再瀏覽要驗證的目標，檢查實際命中的規則與處理方式，同時確認 Data 是否有相應流量。若結果不符，先確認啟用的設定檔與規則順序，不要直接重寫所有伺服器資訊。
關閉連線開關後又重新連線，該檢查哪些設定？
先檢查 Settings 中的 On Demand 及其觸發條件，再查看系統的 VPN 狀態。為了找出原因，可暫時停用自動觸發，改用手動連線測試；確認基本連線正常後，再恢復需要的條件。介面用語的對應說明，請參閱術語表說明。
提供排查資料時，哪些資訊應予保留？
保留錯誤提示、使用的協定類型、Global Routing、測試目標與操作順序，通常比只描述「無法連線」更有助於排查。分享前請遮蔽完整訂閱網址、認證參數與金鑰；只保留判斷問題所需的欄位名稱及錯誤狀況，不要公開個人連線憑證。
專題文章
流量讀數、訂閱管理與協定參數
完成首次連線後，再依實際問題閱讀相關專題。流量統計用於觀察傳輸，多筆訂閱管理用於整理來源，協定參數說明則協助確認欄位；每篇文章只處理一類問題，避免將彼此獨立的設定混在一起調整。
Shadowrocket 流量統計查看方式：Data 頁面依伺服器與 App 顯示的讀數說明
說明兩種檢視方式的讀數、統計週期與清除方式。搭配連線記錄了解流量變化，區分「有資料傳輸」與「依預期規則處理」這兩項判斷，避免只看總量就推測分流結果。
閱讀說明 →Shadowrocket 多筆訂閱如何管理：分組排序、刪除舊訂閱與移除重複節點
本文以使用者已儲存多筆訂閱為前提，說明如何辨別來源、整理分組，以及刪除前應保留哪些資料。先判斷項目是重複匯入還是更新結果，再選擇合適的整理方式。
閱讀說明 →Shadowrocket WireGuard 設定參數詳解：私鑰、對端公鑰、位址、DNS 與 MTU 怎麼填
逐項說明參數用途與資料來源，解釋本機私鑰和對端公鑰的差異，以及如何依既有資料確認位址、DNS、MTU。遇到錯誤時請逐欄檢查，不要盲目替換整份設定。
閱讀說明 →Rule 閱讀範例
依序比對，再看 FINAL
這段語法只用來說明規則結構，並非完整的連線設定。DOMAIN-SUFFIX 比對網域後綴，IP-CIDR 比對 IP 網段，FINAL 則處理前面未命中的連線。實際使用前，請依自己的伺服器選擇與存取需求確認處理方式。
兩條規則可能涵蓋同一個目標，順序會影響結果。先確認範圍較明確的項目，再檢查最後的處理方式；修改後透過實際要求記錄重新測試。規則中的 example.com 僅為示範網域，並非伺服器或訂閱入口。
繼續閱讀規則與驗證步驟 →[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY