iPhone / iPad
App Store 一次性購買 $2.99，兩種裝置共用購買項目；Mac、Windows、Android、Linux 版免費。系統需求以 App Store 頁面標示為準。先確認商店帳號地區與應用程式資訊，再購買安裝；已購買的裝置應先檢查已購項目。
Shadowrocket 使用說明
與全平台取得
全平台規則代理用戶端，用於匯入既有設定與規則分流；iPhone / iPad 在 App Store 一次性購買 $2.99，Mac、Windows、Android、Linux 版免費。
目前版本 以下載頁為準 · Mac、Windows、Android、Linux 版免費；iPhone / iPad 一次性購買 $2.99
Global RoutingConfigOn Demand
[Rule]
- DOMAIN-SUFFIX,example.com,PROXY
- DOMAIN-KEYWORD,example,PROXY
- IP-CIDR,192.168.0.0/16,DIRECT
- DOMAIN-SUFFIX,ads.example.com,REJECT
- FINAL,DIRECT
PROXY
DIRECT
REJECT
語法展示，並非可直接套用的完整設定。規則由上而下比對；具體網域規則應放在寬泛規則之前。
Shadowrocket 功能設定
先匯入既有伺服器資訊，再決定連線方式。以下以 iPhone / iPad 的介面用語說明操作位置，其他平台請以實際介面為準。
依序比對規則
規則分流用於決定特定請求要經過代理、直接連線或拒絕。在 Home 的 Global Routing 選擇 Config 後，用戶端會依目前設定中的 Rule 順序檢查目標。編輯前先備份，將具體網域放在寬泛條件之前，並將 FINAL 留作未命中時的收尾策略。DOMAIN-SUFFIX 檢查網域後綴，IP-CIDR 檢查 IP 位址範圍；兩者不是相同的比對條件。發生分流異常時，先找出實際命中的規則，再修改對應項目，不要一次取代整份設定。
查閱規則關鍵字 →[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT以 On Demand 觸發連線
On Demand 可依已設定的條件觸發連線，不負責選擇請求最終採用的分流策略。在 Settings 找到 On Demand，先確認一般手動連線能成功，再逐項調整觸發條件。修改後，分別在常用的 Wi-Fi 和行動網路下觀察連線狀態，避免將系統觸發行為誤認為伺服器故障。排查自動重新連線時，先記錄目前條件，再暫時關閉 On Demand 進行手動測試；確認問題來源後還原設定，不必同時修改協定、DNS 與規則檔案。
先完成手動連線驗證 →- Settings
- On Demand
- Home
- Global Routing
Type 須與伺服器端一致
多種協定支援用於讀取不同類型的伺服器設定，不能只憑名稱判斷某種協定是否更適合目前的網路。在 Add Server 的 Type 選擇伺服器端實際使用的協定，再核對 Host、Port 及該類型要求的驗證參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的欄位不能互相套用。若已有訂閱，請優先檢查匯入結果，不要為了測試任意更換 Type；TLS、傳輸方式或金鑰不一致時，即使位址和連接埠正確，也可能無法建立連線。
查閱協定與欄位說明 →ShadowsocksVMessVLESSTrojanHysteria2WireGuardHTTPSOCKS5
匯入既有訂閱
訂閱可用於批次匯入及更新伺服器項目，前提是使用者已有有效訂閱。在 Home 開啟 Add Server，依實際介面選擇 Subscribe 並填入既有連結，儲存後等待項目載入。完成匯入不代表已連線，還需要回到 Home 點選預設伺服器並開啟連線開關。更新失敗時，先檢查連結是否完整、是否包含複製時一併帶入的空格，以及伺服器端是否仍允許存取。訂閱可能包含驗證資訊，不應放進公開截圖或求助文字；更新前也應保留仍需使用的手動項目。
查看訂閱匯入步驟 →- Add Server開啟新增入口
- Subscribe填入既有訂閱連結並儲存
- Home點選伺服器，再驗證連線
區分伺服器與設定檔
伺服器項目提供連線參數，Config 中的設定檔則決定規則、DNS 等處理方式，兩者需要分開檢查。匯入新設定後，先確認目前選取的檔案，再查看 General、Rule 與 Hosts 等區段；不要將包含伺服器資訊的訂閱誤當成完整規則設定。修改前保留副本，只調整用途明確的項目。使用 iCloud 同步時，先確認系統帳號與同步狀態，再核對另一部裝置上的實際內容；同步不代表連線已驗證，也不能取代更新前的本機備份。
查看 Config 與連線的關係 →- General
- Rule
- Hosts
- URL Rewrite
- HTTPS Decryption
先驗證，再定位故障
Connectivity Test 用於檢查目前連線是否能完成測試請求，結果需要搭配所選伺服器、測試方法與本機網路狀況解讀。首次連線時，先確認 Home 中已選取伺服器，再開啟連線開關並執行測試；單次測試失敗不代表所有應用程式都無法存取。Data 可協助觀察流量變化，Settings 中的 Diagnostics 可進一步定位問題。求助前記錄錯誤發生的位置、Global Routing 狀態和重現步驟，移除訂閱連結及驗證資訊，再逐項比較直接連線與代理的表現。
前往連線故障問答 →- Connectivity Test
- Test Method
- Data
- Diagnostics
首次使用的檢查順序：既有訂閱或伺服器參數 → 匯入項目 → 在 Home 選取伺服器 → 確認 Global Routing → 開啟連線開關 → 執行 Connectivity Test。每次只變更一個條件，才能區分匯入、伺服器和分流問題。介面配置可能因平台而異，操作時保留英文設定項作為定位依據。
全平台下載入口
iPhone / iPad 在 App Store 一次性購買 $2.99；Mac、Windows、Android、Linux 版免費。電腦與 Android 安裝檔由本站下載頁提供，網址位於本站 /dl/shadowrocket/ 路徑。
Mac
免費，分別提供 Apple 晶片版與 Intel 版；iPhone / iPad 在 App Store 一次性購買 $2.99。先在「關於這台 Mac」查看晶片或處理器，再選擇對應安裝檔。遇到「無法驗證開發者」時，確認下載來源後，依下載頁的「隱私權與安全性」說明處理。
Windows
免費，提供 64 位元安裝程式；iPhone / iPad 在 App Store 一次性購買 $2.99。下載後依安裝精靈操作。若出現 SmartScreen 提示，先確認檔案來自本站，再查看「其他資訊」與「仍要執行」；受組織管理的電腦應遵循管理員政策。
Android
免費，提供 arm64 安裝檔；iPhone / iPad 在 App Store 一次性購買 $2.99。系統詢問安裝來源權限時，只需為實際用來開啟本站檔案的應用程式開啟「允許安裝未知應用程式」。安裝完成後可關閉此權限；首次連線還需閱讀系統的網路連線授權提示。
Linux
免費，依發行版選擇 deb、rpm 或 AppImage；iPhone / iPad 在 App Store 一次性購買 $2.99。deb 與 rpm 使用對應的套件管理器安裝，AppImage 首次執行前需要設定執行權限。下載頁提供命令說明，執行前請核對本機檔名和處理器架構。
確認應用程式，再選擇取得方式
Shadowrocket 是閉源商業應用程式。本頁為官網與官方手冊，依裝置區分取得方式；商店購買記錄與伺服器連線權限不可混為一談。
商店顯示與帳號地區
iPhone / iPad 應用程式是否顯示，取決於目前 App Store 帳號所屬商店，不由裝置顯示語言決定。搜尋不到時，先檢查商店帳號的國家或地區，再開啟本頁提供的產品資訊。中國大陸商店不提供此應用程式；其他地區的顯示情況與購買條件以實際商店資訊為準。不要為了反覆搜尋而任意變更系統地區，這與商店帳號地區是不同的設定。
需要確認地區時，可在系統 Settings 的帳號設定中進入 Media & Purchases，查看帳號的 Country/Region。變更前應閱讀帳號頁面列出的餘額、訂閱及付款方式要求；若目前帳號受到限制，應先處理帳號問題。詳細檢查路徑和常見錯誤原因請參閱正版指南，本站不提供任何帳號。
購買、重新安裝與換機
iPhone / iPad 在 App Store 一次性購買 $2.99，兩種裝置可共用同一購買帳號的記錄；Mac、Windows、Android、Linux 版免費，請從本站下載頁取得。商店以當地貨幣結帳時，金額以頁面顯示為準。購買前也應查看裝置相容性，iPhone / iPad 的系統需求以 App Store 頁面標示為準。
換機或重新安裝時，先確認 App Store 登入的是完成購買的帳號，再到已購項目中尋找 Shadowrocket。若出現重新標價，不要立即重複付款，應先確認帳號、商店地區及購買記錄。還原應用程式不代表原有訂閱和設定會自動還原；舊裝置仍可使用時，先保留自己的設定備份，再於新裝置驗證預設伺服器與規則檔案。
分別管理用戶端與線路
用戶端買斷 ≠ 線路方案。Shadowrocket 用於管理及使用使用者已有的伺服器資訊。本站不提供、不銷售、不推薦任何節點或訂閱。能安裝用戶端不代表已取得可用伺服器；匯入完成也不代表伺服器目前可連線。請從自己的設定來源確認位址、連接埠、驗證參數與有效狀態，不要將驗證資訊交給公開討論區。
伺服器訂閱與規則設定也需要分別理解：前者用於取得連線項目，後者決定請求如何比對及處理。遇到連線問題，先判斷是購買、安裝、匯入還是網路連線環節，再前往對應章節。商店購買記錄無法解決訂閱連結失效，更新規則也無法修正錯誤的驗證參數。
更新與保留設定
iPhone / iPad 的應用程式更新請在 App Store 檢查；Mac、Windows、Android、Linux 的新版安裝檔請從本站下載頁取得。更新前記錄目前選取的設定檔、Global Routing 狀態及常用伺服器，並保留必要備份。更新後先完成一次連線測試，再還原較複雜的規則和隨選連線條件，避免同時引入多項變動而難以判斷原因。
桌面與 Android 版本使用對應平台的取得方式，不需要套用 iPhone / iPad 的商店購買流程。安裝時遇到系統提示，應先確認檔案來自本站，再依下載頁中對應系統的安裝允許章節操作；組織管理裝置的限制應由管理員處理。不要只為了執行應用程式而關閉整套系統防護。
[Rule] / MATCH ORDER
Global Routing 與規則分流
先確認模式，再檢查規則。Global Routing 的 Config（設定）、Proxy（代理）、Direct（直連）決定請求採用哪種處理方式。修改 Rule 後沒有看到預期變化，可能是目前並未使用 Config，也可能是前面的規則已經命中。
在 Config 下，規則會依序比對。較具體的網域應放在寬泛條件之前，FINAL 則處理前面沒有符合的請求。首屏範例中的 DOMAIN-KEYWORD 會先於後面的廣告網域規則命中，因此僅供語法展示；以下將具體網域提前，展示順序對結果的影響。
PROXY 表示交由代理策略處理，DIRECT 表示直接連線，REJECT 表示拒絕請求。策略名稱不是連線品質指標，顏色也只用於辨識規則類型。排查時記錄目標、命中規則和最終策略，不能只因連線開關已開啟，就認定所有請求都經過代理。
查看模式選擇與連線驗證[Rule]
DOMAIN-SUFFIX,ads.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECTexample.com 是用於說明語法的範例網域，不代表服務推薦；完整設定還需要配合實際伺服器和策略。
連線異常時，依現象拆解
若所有請求都失敗，先檢查本機網路、伺服器選取狀態與驗證資訊；若只有部分網域異常，再檢查規則命中情況和 DNS。Proxy 與 Config 的測試結果不同時，通常應繼續比較設定檔中的策略，而不是立即更換所有伺服器參數。每次測試只調整一個選項，還原原值後再驗證下一項。
DNS 負責將網域解析為位址，規則負責決定請求如何處理，兩者彼此相關但不能互相取代。修改 DNS 前先記錄目前設定，區分解析失敗與連線失敗；若已取得位址但仍無法連線，應繼續檢查連接埠、協定與目標服務。詳細流程請參閱 Shadowrocket DNS 設定詳解。
安裝、首次連線與 DNS
依目前任務選擇文章：先完成裝置安裝和基本連線，再調整 DNS 等進階設定。遇到步驟失敗時，保留目前狀態並回到該步驟檢查，不必重新修改所有設定。
Shadowrocket Mac 與 Windows 版安裝：如何選擇 Apple 晶片與 Intel 版本，以及如何解除系統阻擋
先確認 Mac 晶片類型，再選擇對應安裝檔，並分步說明遇到「無法驗證開發者」與 SmartScreen 阻擋時的處理位置。適用於已從本站下載檔案、需要完成首次開啟的使用者；不要將系統安裝提示與伺服器連線失敗混為一談。
Shadowrocket 首次連線教學：選取預設伺服器、開啟連線開關並用 Connectivity Test 驗證
匯入節點後，在 Home 頁面點選伺服器，直到出現選取圓點，再開啟連線開關，並使用 Connectivity Test 確認連線狀況。文章依實際操作順序說明檢查重點，協助區分「已有項目」、「已選取伺服器」和「已驗證連線」三種不同狀態。
Shadowrocket DNS 設定詳解：如何選擇系統 DNS、自訂 DNS 與 DNS over HTTPS
說明系統 DNS、自訂 DNS 與 DNS over HTTPS 的差異、適用情境和設定位置，以及 DNS 設定如何搭配規則分流。調整前先保存原值，修改後比較同一目標的解析與連線結果，避免將暫時波動當成設定生效的依據。