iPhone
在 iPhone 上透過 App Store 開啟產品頁，核對購買時使用的 Apple ID 與裝置相容性。安裝後先匯入既有設定，再依系統提示允許新增 VPN 設定；完成授權不代表連線已驗證成功。
查看 iPhone 取得說明 →
官方手冊 · App Store 正版
Shadowrocket使用說明與規則設定
適用於 iPhone / iPad 的規則代理用戶端，支援規則分流與多種協定連線；應用程式在 App Store 一次性買斷，連線前須備妥自己已有的訂閱或伺服器資料。
- Shadowsocks
- Trojan
- Hysteria2
- Global Routing
APP STORE / APPLE DEVICES
裝置與 App Store 取得方式
先在商店核對官方圖示、開發者與應用程式 ID，再確認裝置相容性及購買狀態。Shadowrocket 僅能透過 App Store 取得，系統需求以 App Store 頁面標示為準。
在 App Store下載 ShadowrocketiPad
在 iPad 上使用購買時的 Apple ID 查看已購項目，再前往產品頁確認是否可取得。iPhone 與 iPad 是否適用通用購買，以 App Store 頁面標示為準；伺服器、訂閱與設定仍須在裝置上確認。
查看 iPad 取得說明 →Mac / Apple TV 也可從同一個 App Store 取得；相容性、系統需求及是否適用通用購買，均以 App Store 頁面標示為準。
CAPABILITY INDEX
從 Global Routing 到連線診斷
先區分伺服器參數、設定檔與全域路由模式，再調整個別功能。左側目錄說明操作位置，右側列出須核對的實際關鍵字與設定項目；語法片段僅供閱讀，並非可直接套用的完整設定。
在 Home 開啟 Global Routing，選擇 Config 後，請求會依目前設定的規則比對；選擇 Proxy 時使用代理模式，選擇 Direct 時則使用直連模式。若要依網域或位址分流，先在 Config 確認目前使用的設定，再檢查 Rule 的排列順序與策略名稱。規則通常由上而下比對，條件範圍過廣可能先行命中，讓後面的精確條件無法生效。先用已知網域驗證結果，再逐條新增規則，比一次修改多個條件更容易找出問題。
- DOMAIN-SUFFIX
- GEOIP
- FINAL
在 Settings 查看 On Demand，先確認既有伺服器可以手動連線，再設定需要觸發連線的條件。On Demand 控制符合條件時如何建立連線，不會取代 Global Routing 對請求流向的判斷。修改後應分別檢查目前網路、切換網路及手動中斷後的狀況；若中斷後又重新連線，先確認是否仍有條件符合。排查時可暫時停用 On Demand，改為手動連線；待基本連線與規則都驗證通過後，再逐項啟用所需條件。
- On Demand
- Settings
- Global Routing
在 Add Server 先選擇 Type，再依據自己已有的伺服器資料填寫位址、連接埠與驗證欄位。Shadowsocks、VMess、VLESS、Trojan、WireGuard 和 Hysteria2 的參數結構各不相同，不能只更換類型而保留其他內容。涉及 TLS 時，也須核對伺服器要求的名稱與憑證設定，不能把關閉驗證當成通用的修復方式。儲存前逐項對照原始資料；儲存後先測試單一伺服器，確認連線成功，再使用訂閱管理或規則分流，避免把協定設定錯誤誤判為規則問題。
- Shadowsocks
- Trojan / WireGuard
- Hysteria2
匯入前先確認手上的內容是伺服器訂閱、單一伺服器分享連結，還是設定檔網址，再使用相應的 Subscribe 或匯入入口。自己已有的訂閱通常包含多筆伺服器資料，更新後內容可能依來源而變動；設定檔則可能還包含規則與解析設定，不能只憑網址外觀區分。更新前記錄目前可用的伺服器與手動修改項目，更新後檢查群組、所選伺服器及連線結果。訂閱網址可能含有存取憑證，排查時應先遮蔽截圖與記錄中的完整網址及敏感參數。
- Subscribe
- Add Server
- Scan QR Code
在 Config 先確認目前選用的設定，再查看 General、Rule 與 Hosts 等區段。編輯規則前先保留可還原的副本，修改後確認檔案已儲存並且已選取；將檔案加入清單，不代表目前正在使用。若要在多部裝置間維護，可依照應用程式提供的 iCloud 同步選項確認同步範圍與狀態，但仍應在另一部裝置重新核對設定選擇與伺服器參數。同步不能取代備份，也不能假設所有敏感欄位都會以相同方式轉移；排查前先保留一份已驗證可用的設定較為穩妥。
- General / Rule
- Hosts
- iCloud
連線異常時，先在 Home 檢查開關與所選伺服器，再執行 Connectivity Test，並參考 Settings 中的 Diagnostics 尋找線索。Data 的流量記錄可用來觀察請求活動，但不能單獨證明目標網站可正常存取；測試成功也不代表所有網域、協定與規則路徑都已驗證。依序檢查基本網路、伺服器參數、Global Routing、DNS 與規則命中情形，每次只變更一個變數。回報問題前記錄觸發步驟與錯誤訊息，並遮蔽訂閱網址、密碼及金鑰，保留必要的時間與操作背景。
- Connectivity Test
- Data
- Diagnostics
條件、順序與策略
這條規則會將符合 example.com 及其子網域的請求交由 PROXY 處理。後者是策略參照，必須與目前設定中已有的名稱一致；它不是伺服器位址，單靠這一行也無法建立連線。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY範例用於說明語法結構。GEOIP 涉及位址歸屬判斷，FINAL 則處理前面未命中的請求；實際流向仍須配合解析結果、規則順序與所選策略確認。
閱讀 Global Routing 與規則說明 →先手動驗證，再啟用條件
從 Settings 的 On Demand 開始檢查。先維持手動連線，確認伺服器與設定可用，再啟用條件並觀察系統建立連線的時機。條件比對與規則分流屬於不同層次，應分開驗證。
Settings
On Demand
Home
Global Routing
Connectivity Test若出現重複連線，記錄當時的網路環境與開關操作，不要同時更換設定與伺服器。先縮小觸發條件的範圍，再判斷是否需要調整規則。
查看設定與日常維護章節 →Type 決定參數結構
選擇 Type 後，再核對相應欄位。位址和連接埠相同不代表協定相容；密碼、金鑰、傳輸設定及 TLS 條件都須符合伺服器資料，不能只憑協定名稱推測缺少的參數。
- Shadowsocks / VMess / VLESS
- Trojan / HTTP / SOCKS5
- WireGuard / Hysteria2
手動填寫方便逐項核對，QR Code 與分享連結則能減少輸入。無論採用哪種方式，匯入後都要檢查 Type 與重要欄位，再執行連線測試。
查看協定術語 →先辨認內容，再選擇入口
匯入訂閱後，應檢查項目是否完整、先前選用的項目是否仍在，以及更新後參數是否有變動。清單中出現伺服器不代表驗證完成；仍須選取一筆並測試實際請求。
Subscribe
Add Server
Scan QR Code
Import from Cloud JSON上述入口適用的內容格式各不相同。若無法辨識，先確認來源提供的格式及所用入口，再檢查複製時是否帶入空格或換行；請勿公開貼上含有憑證的完整網址。
依照教學匯入既有訂閱 →儲存、選取與還原
編輯設定後，須確認儲存結果與目前選用的設定。General 用於整體參數，Rule 用於請求比對，Hosts 用於指定名稱解析；不同區段的內容不可任意調換位置。
[General]
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Hosts]這是區段閱讀範例，並非完整連線設定。變更前保留副本，跨裝置同步後再核對檔案內容；若結果不如預期，先還原至已知可用的狀態，再逐項比對變更。
閱讀設定管理章節 →分開檢視測試結果與實際請求
先確認裝置的基本網路正常，再核對伺服器驗證資料與連線測試。若測試通過但目標請求失敗，接著檢查 Global Routing、DNS 與規則，不要直接判定為同一種故障。
Home → Connectivity Test
Data
Settings → DiagnosticsData 顯示流量只代表有請求活動。比較不同目標與網路時，應維持相同的設定與伺服器選擇，並記錄錯誤訊息；一次只變更一個變數，才能將結果對應到具體變化。
閱讀連線故障排查 →FIRST CONNECTION
首次連線的三個步驟
以下步驟以使用者已備妥自己的訂閱或伺服器資料為前提。將「匯入完成」、「系統授權」與「請求驗證」分開處理，可避免尚未具備連線條件就反覆調整規則。
-
新增伺服器或匯入既有訂閱
開啟 Home，依資料類型使用 Add Server、掃描 QR Code 或相應的訂閱入口。手動填寫時先選擇 Type，再逐項輸入參數；匯入時先確認來源與內容格式，完成後檢查伺服器清單及實際選取項目。請勿將設定檔網址當成伺服器位址填入，也不要在公開頁面分享訂閱中的驗證參數。若匯入失敗，回頭核對原始資料格式，比反覆更改連接埠更有效。
-
選擇 Global Routing 模式
需要依設定分流時，選擇 Config 並確認已在 Config 中選取所需檔案。Proxy 與 Direct 可用來理解不同請求路徑，但不能取代對設定本身的檢查；切換模式會改變流量去向，測試結束後應恢復日常使用的選項。首次驗證建議採用簡單易讀的規則，先了解命中條件，再逐步新增例外，避免同時變更多條規則而難以判斷原因。
-
開啟連線開關並驗證請求
開啟 Home 的連線開關；首次新增 VPN 設定時，請閱讀並確認系統授權提示。接著執行 Connectivity Test，再存取明確的測試目標，並搭配 Data 或診斷資訊查看結果。若發生異常，先記錄錯誤訊息，再依序排查基本網路、參數、模式與規則。系統顯示已連線只代表連線狀態，不能據此推斷所有目標或每條規則都正常運作。
PRODUCT VERIFICATION
正版核對、買斷與恢復購買
Shadowrocket 是閉源商業應用程式。本網站為 Shadowrocket蘋果版官網與官方手冊；購買及相容性資訊以 App Store 產品頁為準，操作說明則依據應用程式中的實際介面用語。
- 開發者Shadow Launch Technology Limited
- 應用程式 ID932747118
- 僅於 App Store 上架
在產品頁核對三個項目
開啟 App Store 產品頁，先比對本站使用的官方圖示，再確認開發者是否為 Shadow Launch Technology Limited，最後核對產品網址中的應用程式 ID 是否為 932747118。同名或相似名稱不能取代這些核對步驟；只看搜尋結果標題，容易忽略開發者與產品本身的差異。確認這三項後，再查看價格、相容性與購買按鈕狀態。
商店是否顯示某項產品，與目前 Apple ID 所屬店面及商店供應狀態有關。若搜尋結果與預期不同，應先檢查目前店面與產品頁，而非將搜尋不到視為裝置故障。系統需求、裝置相容性及是否適用通用購買，均以 App Store 頁面標示為準；本站不以固定的系統版本號取代商店說明。
分清應用程式購買與連線資料
買斷用戶端 ≠ 線路方案。美國商店價格約為 2.99 美元，一次付費；各店面以當地貨幣顯示，實際金額以購買確認頁為準。付款取得的是應用程式使用資格；伺服器位址、驗證參數與訂閱內容須由使用者自行備妥。本網站不提供、不販售也不推薦節點或訂閱，亦不代替使用者選擇服務來源。
買斷不代表任何伺服器都能連線，也不表示應用程式會自動產生有效設定。首次開啟前，應先備妥完整資料，再依照教學匯入。若連線失敗，請分別檢查應用程式購買狀態與伺服器可用狀態：前者影響能否取得應用程式，後者影響能否建立預期連線，兩類問題的處理方式不同。
從已購項目恢復應用程式
更換裝置或重新安裝時，在 App Store 使用購買時的 Apple ID 查看已購項目，再前往 Shadowrocket 產品頁確認取得狀態。iPhone 與 iPad 是否適用共用購買，以 App Store 頁面標示為準；若頁面仍顯示價格，先檢查帳戶、店面與購買記錄，不要只憑裝置上曾出現應用程式圖示，就認定已完成購買。
恢復應用程式與恢復設定是兩回事。重新取得應用程式後，還須檢查原有伺服器資料、設定檔與同步狀態；不要假設購買記錄也會一併恢復所有連線內容。若使用 iCloud 同步，請依實際啟用的同步範圍檢查；首次連線前再次確認所選設定與伺服器，必要時從自行保留的副本還原。
透過 App Store 管理更新
在 App Store 的應用程式更新頁面查看 Shadowrocket，依裝置上的自動更新設定或手動更新操作維護應用程式。閱讀產品頁提供的說明後，再核對更新後的重要設定。本頁不列出特定版本號或更新日期；排查時應以裝置目前的安裝狀態及商店可見資訊為準，避免依過期紀錄判斷功能是否存在。
建議分開進行日常維護：先保留可還原的設定，再更新應用程式，最後檢查既有訂閱內容的變動。應用程式更新、訂閱更新與規則編輯是不同操作；若同時進行，發生異常時便難以判斷原因。每次完成一項變更後，測試一個已知目標並記錄結果，方便後續診斷時清楚比對。
常見問題精選
先參考下列差異判斷問題所在，再前往對應教學或術語條目。
訂閱已匯入，為什麼還要檢查 Config？
伺服器訂閱主要提供連線項目，設定檔則可能還會定義請求規則。匯入伺服器不代表已選取正確設定；使用 Config 模式時，仍須檢查目前的檔案與策略參照。可先閱讀訂閱與設定術語。
Connectivity Test 成功，是否代表所有請求都正常？
測試結果只反映相應測試路徑。實際目標還可能受到網域解析、規則命中與協定差異影響，應搭配 Data 和 Diagnostics 繼續驗證。請參閱連線診斷說明。
Global Routing 與 On Demand 分別控制什麼？
Global Routing 控制請求採用的路由模式，On Demand 則控制符合條件時如何觸發連線。應先手動驗證連線，再設定自動觸發條件，避免混淆建立連線與選擇路徑。請參閱介面與開關術語。
重新取得應用程式後，原有伺服器會自動恢復嗎？
恢復購買不等於恢復設定。應依照原有備份與 iCloud 同步範圍確認，不能假設所有內容都會轉移；恢復後仍須核對驗證欄位並測試連線。請參閱已購項目恢復說明。
TECHNICAL NOTES
協定、DNS 與參數技術筆記
完成首次連線後，再依問題閱讀相關專題。先辨認協定與參數用途，再決定是否調整；技術筆記僅說明如何填寫及驗證自己已有的資料，不能取代來源提供的完整設定。
Shadowrocket DNS 設定怎麼選：系統 DNS、自訂 DNS 與 DNS over HTTPS
從網域解析異常著手，比較三種 DNS 設定方式，說明解析結果如何影響規則判斷，並依序檢查解析、連線與目標請求，避免一遇到存取失敗就更換伺服器。
小火箭支援哪些協定：Shadowsocks、VMess、VLESS、Trojan 到 Hysteria2
依傳輸與驗證特性辨識協定，說明為什麼在 Add Server 中要先選擇 Type。應依照自己已有的伺服器資料選擇類型，而不是把更換協定名稱當成修復連線的方式。
Shadowrocket WireGuard 設定詳解：私密金鑰、Peer 公開金鑰、Allowed IPs 與 MTU
逐項說明 Private Key、Public Key、Pre-shared Key、Allowed IPs 與 MTU 的作用，區分本機金鑰與 Peer 資訊，並說明參數不一致時應從哪些地方核對。