iPhone
初次開啟後，先匯入自己的連線資訊，再依系統提示新增 VPN 配置。此授權用於建立本機網路連線，並不代表伺服器參數已通過驗證。
前往說明 →官方手冊 · App Store 正版
Shadowrocket 使用手冊訂閱匯入與規則設定
適用於 iPhone / iPad 客戶端，從核對 一次性買斷開始，依序完成既有訂閱匯入、連線驗證與規則分流設定。
- Subscribe 訂閱
- VLESS
- WireGuard
取得與初次開啟
先核對 App Store，再設定連線
Shadowrocket 是付費應用程式，採一次性買斷，只在 App Store 發售。購買前先核對開發者、官方圖示與 App ID；系統需求與裝置相容性以 App Store 頁面標示為準。
已有訂閱或伺服器資訊的使用者，可在安裝後繼續閱讀匯入步驟。客戶端買斷 ≠ 線路方案；本站不提供任何節點或訂閱，訂閱連結請向你的服務商取得。
設定項目與使用順序
Shadowrocket 核心功能說明
先區分伺服器、訂閱與配置檔，再決定如何處理流量。以下依常用入口說明用途；範例僅供閱讀格式，不可用於實際連線。
Subscribe 訂閱匯入
訂閱可集中取得及更新伺服器項目，連結請向你的服務商取得。在 Add Server 新增伺服器入口選擇 Subscribe 訂閱類型，填入完整網址後儲存並更新。匯入前檢查連結是否被換行、是否缺少查詢參數；匯入後核對群組與項目，不要只看是否出現名稱。更新失敗時先保留既有可用資訊，確認連結狀態後再重試。訂閱網址可能包含存取憑證，排查時請勿公開完整連結。
前往訂閱手冊 →https://example.com/sub?token=xxxx範例中的 token 是假值，不是連線憑證。
Global Routing 全域路由
Global Routing 全域路由決定連線採用哪種處理方式。Config 配置模式依目前配置中的規則分流；Proxy 代理模式將一般請求交由所選代理處理；Direct 直連模式則用於直接存取。初次驗證時，先記下目前選項，再依排查目標切換，不要同時修改多項設定。模式變更不代表伺服器參數有所改變，也無法修正錯誤的位址或密碼。需要規則生效時，還要確認 Config 配置頁中實際選取了預期檔案。
查看路由設定步驟 →Config → 依目前配置分流
Proxy → 使用代理模式
Direct → 使用直連模式On Demand 隨需連線
On Demand 隨需連線會依設定條件觸發系統連線行為，入口位於 Settings 設定頁。建議先在手動連線時確認伺服器與路由可用，再逐項啟用所需條件；它不能取代訂閱匯入，也不會修正失效參數。排查「關閉後又自動連線」時，應先檢查這裡的條件，並觀察切換網路後的實際狀態。測試時暫時關閉相關條件，可減少自動連線對結果的干擾，確認原因後再恢復原設定。
閱讀隨需連線說明 →Settings
On Demand
先驗證手動連線
再設定觸發條件
最後測試網路切換Rule 規則比對
Rule 規則會依配置中的順序判斷請求，比對成功後交由指定策略處理。DOMAIN-SUFFIX 用於網域後綴，IP-CIDR 用於位址範圍，FINAL 則為未被前面規則處理的請求提供預設處理方式。編輯前先備份目前配置，再檢查目標規則的位置與策略名稱；新增一條規則，不代表它一定會優先比對。PROXY、DIRECT 與 REJECT 代表不同處理結果，測試時應配合實際請求紀錄判斷，不能只根據網頁外觀推測比對結果。
閱讀規則比對與限制 →[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT多協定與欄位核對
Shadowrocket 可用於管理 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等協定的連線資訊。進入 Add Server 新增伺服器時，先依既有資訊選擇 Type 類型，再核對位址、連接埠與驗證欄位。不同協定所需欄位各異，傳輸方式與 TLS 參數也須與伺服器端一致。匯入分享連結後仍應複核解析結果；不要因連接埠相同就套用另一筆記錄的參數，也不要只憑協定名稱判斷實際連線表現。
查看手動填寫欄位說明 →Type → 與既有協定一致
Address → example.com
Port → 443
UUID → your-uuid
以上僅為欄位說明，不構成可用配置。Config 配置管理
Config 配置頁管理規則與其他配置內容，職責不同於 Home 首頁中的伺服器列表。伺服器決定連線到哪裡，配置決定如何處理請求；使用 Config 配置模式時，兩者須搭配使用。修改前先保留原始檔案，編輯後確認選取的是新檔案，再以相同測試目標比較結果。若涉及 iCloud 同步，還要檢查系統帳號與同步狀態；同步不能取代獨立備份，也不能視為訂閱更新成功或另一部裝置已完成連線授權的證明。
閱讀配置與備份說明 →[General]
bypass-system = true
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT正版、購買與連線驗證
購買客戶端前後，必須釐清的事項
Shadowrocket（小火箭）是閉源商業應用程式。本站是官網與官方手冊，取得、購買與相容性資訊以 App Store 產品頁為依據；具體操作請以裝置目前顯示的介面為準。
- 開發者 Shadow Launch Technology Limited
- App ID 932747118
- 一次性買斷
正版核對：名稱只是第一步
進入 App Store 後，先確認產品名稱為 Shadowrocket，再查看開發者是否為 Shadow Launch Technology Limited。對照本站頁首的官方圖示，並檢查產品頁連結中的 App ID 是否為 932747118。三項資訊都應核對，不要只憑搜尋結果中的名稱、排名或相似圖案判斷。可將瀏覽器開啟的產品頁與裝置商店內的內容交互比對；最後購買前，仍應在付款畫面確認應用程式名稱與金額。
官方圖示可用來辨認應用程式，不代表目前裝置已購買或安裝。若商店頁面顯示的開發者或 App ID 不符，請返回核對入口，不要繼續輸入付款資訊。正版核對說明頁會逐一說明這三處資訊，適合初次購買時逐項比對。
商店顯示與帳號地區
App Store 顯示的應用程式、貨幣與可購買狀態會受目前帳號的店面影響。頁面無法開啟、搜尋不到與應用程式連線失敗是不同問題：前兩者發生於取得階段，尚未涉及伺服器配置。先檢查 App Store 目前登入的帳號、網路狀態與頁面提示，再確認產品頁能否正常顯示。不要將手冊中的美國店面金額直接換算為所有地區的實際售價，也不要因網頁能開啟就認定裝置一定符合相容性要求。
系統需求、裝置相容性及是否適用通用購買，一律以 App Store 頁面標示為準。購買前查看相容性欄，比安裝後再判斷更直接；遇到帳號或付款狀態問題，應依商店顯示的資訊處理，不要試圖修改訂閱連結來解決。
一次性買斷與線路服務分開管理
美國店面定價約為 2.99 美元，一次性買斷；各店面會以當地貨幣顯示，實際金額以 App Store 頁面為準。買斷指的是客戶端本身的購買方式，不代表已購買可供連線的伺服器。客戶端買斷 ≠ 線路方案。使用者仍須備有自己的訂閱或伺服器資訊，訂閱連結請向你的服務商取得；本站不提供、不銷售、不推薦節點或訂閱。
因此，付款成功後 Home 首頁列表為空，不代表購買失敗；列表是否出現項目，取決於後續是否完成匯入。反過來說，訂閱中有項目也不能證明該服務仍有效。應用程式購買紀錄、訂閱有效狀態與伺服器可連線性各屬不同環節，排查時應分別確認。
兩部裝置的購買與還原
在 iPhone 與 iPad 之間使用時，先用購買時的 Apple ID 核對 App Store 已購項目；通用購買的適用範圍以 App Store 頁面標示為準。更換裝置或重新安裝時，請從已購項目尋找相應應用程式，並核對開發者與 App ID。若頁面仍顯示購買金額，先確認使用的是原購買帳號及相應店面，不要把再次付款當成還原購買紀錄的第一步。
還原應用程式不代表訂閱、配置與本機授權都已還原。安裝完成後，應重新檢查 Home 首頁的項目、Config 配置頁的檔案選擇及系統連線提示。若要透過 iCloud 同步，先確認系統相關開關與同步結果，再逐項驗證；不要在多部裝置上同時覆寫尚未備份的配置。
初次授權與初次連線並非同一結果
初次啟用連線時，系統可能會要求允許新增 VPN 配置。這是建立本機網路連線所需的系統授權；完成授權後，仍須確認伺服器位址、驗證資訊、傳輸方式與路由設定彼此相符。建議先用一筆已核對的記錄測試，暫時不要變更其他設定。若取消授權，應先處理系統提示，再繼續判斷連線狀態，避免將本機尚未取得授權誤認為伺服器故障。
返回 Home 首頁後，先核對所選項目，再查看連線開關與 Global Routing 全域路由。連線狀態只是判斷依據之一，也應開啟特定目標頁面進行驗證。若連線失敗，記錄當時的網路環境與錯誤提示，再依序檢查參數、路由與解析，逐步縮小範圍。
Data 流量統計與延遲測試的判讀方式
Data 流量統計用於觀察裝置上由客戶端記錄的流量狀況，不應直接視為服務商端的計費帳單。比較數據前，先確認統計範圍與口徑，再配合實際使用時間判斷。Connectivity Test 連線測試則用於輔助觀察項目的回應情況，不等同於完整的網頁存取測試；不同的測試方法、目標與網路環境都可能影響結果。
遇到「延遲正常但網頁打不開」時，不要只根據數字反覆排序。先用相同目標重新測試，再檢查 Global Routing 全域路由、目前配置與 DNS 解析狀況。只有在測試條件一致時，前後結果才有比較意義。伺服器可連線、網域可解析與目標可存取，是彼此相關但不同的判斷。
分別處理訂閱更新與配置備份
訂閱更新可能變更伺服器列表，編輯配置則可能改變請求的路由結果。更新前先記下目前使用的群組與項目，編輯規則前先備份配置；排查時不要同時更換訂閱、伺服器與規則檔案。若列表突然變空，優先核對連結完整性與回傳內容，不要立即清除原有資料。連結中的查詢參數可能用於驗證，複製時請保留完整格式。
備份內容也可能包含伺服器憑證，應儲存在自己能掌控的位置。向他人說明故障時，可以提供協定類型、錯誤提示與已進行的測試，但應隱藏訂閱網址、密碼等敏感欄位。手冊中的 example.com 與範例驗證值僅用於展示結構，並非實際服務。
應用程式更新與設定變更的順序
應用程式更新由 App Store 管理，更新紀錄也可在對應產品頁查看。需要更新時，先保留目前配置並記錄可重現的問題；更新完成後，以原本的測試目標確認運作情況，再決定是否調整設定。不要把應用程式更新、訂閱更新與規則檔案更新視為同一件事，它們分別影響客戶端、伺服器列表與分流邏輯。
本手冊不固定列出特定版本號或最低系統版本，避免把可能變動的資訊當作長期前提。介面位置不同時，可依裝置上的英文入口名稱尋找，再參照目前的 App Store 說明核對。操作時一次只變更一項，較容易還原設定並判斷原因。
常見問題精選
購買後 Home 首頁沒有伺服器，應先做什麼？
先匯入自己已有的訂閱或伺服器資訊。訂閱連結請向你的服務商取得；應用程式購買與伺服器列表分別管理。儲存後執行更新，再核對項目是否完整。詳細步驟請參閱訂閱手冊。
Global Routing 應選 Config、Proxy 還是 Direct？
需要依規則分流時，選擇 Config 配置模式並確認目前配置；驗證代理路徑時，可依測試目標使用 Proxy 代理模式；需要直連時則使用 Direct 直連模式。切換前先記下原本的選項，完整說明請參閱入門指南。
延遲測試有結果，為什麼特定頁面仍然打不開？
延遲測試與完整存取測試的目標及過程不同。應繼續檢查目前伺服器、路由模式、規則比對結果與 DNS 解析，不要只憑一次測試就判斷連線正常。可依常見問題中的分類逐項排查。
手動關閉連線後又自動連線，應檢查哪裡？
先查看 Settings 設定頁中的 On Demand 隨需連線條件。測試期間暫時停用相關條件，觀察系統連線狀態，再決定要恢復哪些設定。不要同時刪除訂閱與配置，以免失去原始排查條件。更多說明請參閱常見問題。
協定與故障排查
繼續閱讀：欄位與連線問題
完成初次連線後，可針對遇到的問題深入閱讀。協定說明有助於了解設計與參數，不代表對實際網路表現的承諾；排查文章則協助保持測試條件一致，逐步縮小故障範圍。
協定科普
Hysteria2 是什麼協定：基於 QUIC 的設計與適用情境
了解 Hysteria2 的傳輸與壅塞控制設計，區分弱網環境下的設計目標與實際效果，了解 UDP 受限時為何可能無法連線，以及新增記錄前應核對哪些既有參數。
協定科普VMess 和 VLESS 有什麼差異：手動填寫時應看懂的欄位
說明 UUID、alterId、加密方式與 TLS 參數的差異。依照 Add Server 新增伺服器時的核對順序閱讀，避免將一種協定的填寫方式直接套用到另一種協定。
故障排查訂閱更新失敗或列表為空：五步自我檢查清單
依序檢查連結格式、複製是否完整、服務商端狀態、更新時機與網路環境。保留既有資訊後再測試，區分網址失效、回應異常與解析失敗，避免盲目重複匯入。