iPhone
在 App Store 核對 App 名稱、開發者與 App ID 後再購買或重新取得。首次連線時，系統會要求加入 VPN 設定；確認是目前由你主動進行的操作後，再授權。安裝完成不代表伺服器資訊已準備就緒，仍須匯入自己的設定並選擇伺服器。
查看 iPhone 說明 →
功能與設定
依設定任務查看功能
伺服器資訊決定如何建立連線，設定檔則決定要求的處理方式。先釐清這兩個層面，再調整對應設定。
依要求比對規則策略
在 Home 的 Global Routing 選擇 Config 後，要求會依目前設定檔中的規則順序比對。DOMAIN 比對完整網域，DOMAIN-SUFFIX 涵蓋網域及其子網域，IP-CIDR 比對 IP 位址範圍。符合規則後，再依 DIRECT、PROXY 或 REJECT 處理；FINAL 則接收先前未符合任何規則的要求。排查特定網站時，先確認目前使用的設定檔及實際符合的規則，再調整規則位置。右側僅為語法片段，example.com 是教學範例，並非可用伺服器。
查看功能詳解 →[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY檢查自動連線條件
On Demand 可依已設定的網路條件觸發連線，不會替使用者補齊伺服器參數，也無法修復失效的訂閱。請先在 Home 手動連線，確認網頁可正常瀏覽，再前往 Settings 檢查 On Demand 的適用條件。完成設定後，請在日常使用的不同網路環境中逐一驗證。若手動關閉連線後又自動啟動，請先查看此處的條件，以及系統中的相關 VPN 設定。排查期間可暫時關閉自動觸發，讓每次測試都從相同狀態開始；確認原因後，再恢復所需條件。
查看功能詳解 →- Settings
- On Demand
- Home
依 Type 填寫協定參數
Shadowrocket 支援多種協定，新增時應以現有伺服器資訊為準，並在 Add Server 選擇相應的 Type。Shadowsocks、VMess、VLESS、Trojan 等協定所需的驗證資訊與傳輸欄位各不相同；即使位址和連接埠相同，也不能因此互換類型。填入 Host、Port 後，請繼續核對憑證、TLS、伺服器名稱及傳輸路徑等適用欄位。建議保留完整匯入資訊，不要只憑名稱猜測參數。協定決定連線格式，實際能否連線仍取決於伺服器狀態與目前網路。
查看功能詳解 →ShadowsocksVMessVLESSTrojanHTTPSOCKS5WireGuardHysteria2
分清單筆匯入與訂閱更新
訂閱請向你的服務提供者取得。訂閱通常用於批次匯入並持續更新伺服器項目；單筆分享連結則主要描述一部伺服器。匯入前先確認收到的是哪一種內容，再選擇相應入口；不要把網頁網址或單筆分享連結當成訂閱網址。更新失敗時，依序檢查連結是否完整、目前網路能否存取，以及回傳內容是否仍為用戶端支援的格式。匯入成功只代表項目已讀取，仍須選擇伺服器並驗證連線。訂閱網址可能包含個人憑證，請勿放入截圖或公開紀錄。
查看功能詳解 →匯入前的檢查順序
- 確認是訂閱還是單筆分享連結
- 確認網址完整且具備存取權限
- 匯入後檢查項目與協定欄位
- 更新後重新驗證所選伺服器
分段閱讀設定檔
Config 中的設定檔會描述全域行為、規則及其他要求處理設定。[General] 包含 DNS 等全域選項，[Rule] 決定比對順序，[Host] 用於本機對應。修改前請先保留原始檔案，並確認編輯的是目前正在使用的設定檔；每次只調整一項，再以實際要求驗證。iCloud 同步可用於管理支援的設定資料，方便在不同裝置間使用，但不等同完整備份，也不代表另一部裝置已選用相同伺服器。系統 VPN 授權仍須在各裝置上分別確認。
查看功能詳解 →[General]
bypass-system = true
dns-server = system
ipv6 = false
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY依症狀蒐集診斷資訊
Connectivity Test 適合檢查所選伺服器在目前測試方式下的回應，但單靠此測試無法證明網頁、DNS 與所有傳輸都正常。連線後仍應開啟目標網頁，並搭配 Data 中的流量記錄及 Settings 中的 Diagnostics 進行分析。若只有部分網域無法使用，先檢查規則與名稱解析；若所有要求都失敗，再檢查系統網路、連線授權及伺服器參數。記錄觸發條件與錯誤訊息，每次只變更一個項目。分享診斷內容前，請先移除訂閱網址、憑證及可辨識個人身分的資訊。
查看功能詳解 →- Connectivity Test
- Data
- Diagnostics
裝置與商店入口
iPhone 與 iPad 取得說明
Shadowrocket 僅透過 App Store 發行。首次購買前請核對產品資訊；已購買的使用者應先確認目前的商店帳戶與已購項目紀錄，再決定下一步。
iPad
使用購買時的同一個 Apple ID 查看已購項目；購買適用性以 App Store 頁面標示為準。較大的螢幕方便對照設定，但目前使用的伺服器、Global Routing 與系統授權仍須逐項確認，不要只因另一部裝置可以連線就略過驗證。
查看 iPad 說明 →Mac / Apple TV 也可透過同一個 App Store 取得；系統需求與相容性以 App Store 頁面標示為準。
若商店頁面無法顯示，或價格與預期不同，請先確認目前的商店店面與登入帳戶。商店可見性、當地貨幣、相容裝置及購買適用性，均應以產品頁的實際資訊為準，請勿以搜尋結果摘要取代商店說明。
查看取得步驟 →
快速入門預覽
匯入、選擇模式、驗證連線
以下流程以已備妥自己的訂閱或伺服器資訊為前提。首次設定時，先建立可重複操作的手動連線流程；確認運作正常後，再考慮使用 On Demand 或進一步調整規則。
-
Add Server：新增現有伺服器或訂閱
訂閱請向你的服務提供者取得。先確認收到的是訂閱網址、單筆分享連結，還是需要手動填寫的參數。使用相應的匯入入口後，返回 Home 檢查伺服器項目是否出現；手動填寫時，逐項核對 Type、Host、Port 及協定所需的憑證。匯入後若清單仍是空的，應先檢查來源內容與格式，而不是反覆切換連線開關。
Scan QR Code 適合讀取現有 QR Code；從剪貼簿匯入前，則須確認複製內容完整。QR Code 和連結都可能包含存取憑證，請比照密碼妥善處理。保留原始資訊以便核對，但不要將實際內容貼到公開討論區。
-
Global Routing：確認 Config / Proxy / Direct
Config 模式依目前設定檔分流；Proxy 模式將要求交由所選的代理路徑處理；Direct 模式則使用直連路徑。首次驗證時，記下目前選項與伺服器名稱，避免在不同狀態間反覆切換，導致無法判斷結果。若要驗證分流規則，請使用 Config，並確認 Config 中實際啟用的檔案。
規則中的 PROXY 是策略關鍵字，與介面中的 Proxy 模式屬於不同層級。前者是單一規則的處理結果，後者則是 Global Routing 的整體選擇。若要求的處理方式不如預期，先檢查模式，再檢查規則順序，最後才修改個別項目。
-
Home：開啟連線並驗證實際要求
選擇伺服器後開啟連線開關，依系統提示確認 VPN 設定授權，再執行 Connectivity Test 並實際瀏覽網頁。系統顯示已連線，只代表相應的連線流程已啟動，不能取代應用程式層級的驗證。請測試一般網頁及日常需要存取的網站，觀察是否只有部分網域無法使用。
若測試有回應但網頁仍無法開啟，請繼續檢查 DNS、規則比對結果及目標服務本身；若所有要求都逾時，優先確認基本網路與伺服器參數。切換網路後重新驗證，並記錄前後結果。完整流程會依「現象、檢查項目、下一步」逐一展開，發生問題時方便回到明確的步驟。
App Store 正版核對
核對產品資訊，再確認購買紀錄
本站是 Shadowrocket 官網與官方手冊。Shadowrocket（小火箭）是閉源商業應用程式；請依據 App Store 頁面上的開發者、官方 App 圖示與 App ID 核對產品身分，並透過 App Store 購買及更新。
開發者 Shadow Launch Technology Limited
App ID
932747118
一次性買斷
開發者、圖示與 App ID
開啟商店產品頁後，確認開發者是 Shadow Launch Technology Limited，並對照本頁顯示的官方 App 圖示。產品頁網址中的 id932747118 即為 App ID。不要只憑名稱相似或圖示顏色接近就判定是正確產品；請一併核對這三項資訊。
從站內的取得說明前往 App Store 後，請再確認實際開啟的產品頁。搜尋結果可能包含名稱相近的項目，App ID 有助於確認具體產品。系統相容性與購買條件以該頁標示為準。
查看核對位置 →一次性買斷的範圍
買斷用戶端 ≠ 線路方案。美國商店參考價格為 2.99 美元，一次性付費；各商店以當地貨幣標價，實際金額以購買確認頁為準。購買內容是用戶端的使用資格，連線所需的訂閱或伺服器資訊須另行準備。
本站不提供、不銷售，也不推薦節點或訂閱。訂閱請向你的服務提供者取得。App 購買紀錄與訂閱有效期限是兩回事：恢復 App 購買不會延長現有訂閱的有效期限，也不會補上缺少的伺服器憑證。
查看價格與購買說明 →兩種裝置與已購項目恢復
iPhone 與 iPad 可使用同一個購買帳戶查看已購狀態；通用購買的適用性以 App Store 頁面標示為準。更換裝置或重新安裝前，請先確認購買時使用的 Apple ID，再到 App Store 的已購項目中尋找 Shadowrocket。
恢復 App 與恢復設定須分別處理。重新取得 App 後，仍應核對現有伺服器、目前使用的設定檔及連線授權。若使用 iCloud 同步，請確認實際同步的內容與目前選用的項目；不要把同步完成提示當成連線已驗證成功。
查看已購項目恢復說明 →商店店面、相容性與更新
商店是否顯示 App，以及結帳貨幣為何，取決於帳戶所屬的商店店面。若搜尋不到 App 或無法完成購買，請先查看 App Store 目前顯示的資訊與帳戶狀態；裝置系統需求一律以 App Store 頁面標示為準。
App 更新透過 App Store 進行。調整設定或更新 App 前，請保留可用的設定檔及必要的伺服器資訊；更新後依照原有步驟驗證。若發生異常，記錄發生條件、Global Routing 選項與錯誤提示，再依疑難排解流程逐項檢查，避免同時變更多項設定。
查看疑難排解 →
使用心得
查看所有文章 →
訂閱匯入與設定檔閱讀
首次連線完成後，可依遇到的問題繼續閱讀。以下三篇分別說明解析失敗、匯入入口選擇及分享連結辨識，補足從「已匯入」到「可正常使用」之間的檢查步驟。
Shadowrocket DNS 解析失敗：測試有回應，網頁卻無法開啟
先區分名稱解析失敗、規則處理方向錯誤與目標連線失敗，再檢查 dns-server、系統 DNS 與設定檔之間的關係。使用相同網域與相同網路逐項驗證，避免以單次測試結果取代完整判斷。
閱讀 DNS 疑難排解步驟 →Shadowrocket 新增訂閱：四種匯入方式與檢查項目
對照 Subscribe、Add Server、掃描 QR Code 與從剪貼簿匯入各自適用的內容。先辨識現有資訊的類型，再選擇入口；匯入完成後，檢查項目、更新結果及目前使用的伺服器，避免將格式問題誤判為連線問題。
閱讀匯入方式說明 →單筆分享連結與訂閱連結的差異
說明 ss://、vmess://、vless://、trojan:// 的辨識方式，以及單筆參數與可更新訂閱在管理上的差異。閱讀範例時請留意欄位結構，不要將教學網址當成可連線資源，也不要公開含有個人憑證的實際連結。
閱讀連結格式說明 →