官方手冊 · 取得與設定

Shadowrocket 使用說明
訂閱匯入與規則分流

全平台規則代理用戶端。從既有訂閱開始,確認 Global Routing,再用 Config 規則分流檢查請求去向。

目前版本 · iPhone / iPad App Store 一次性付費 $2.99;Mac、Windows、Android、Linux 版免費

首次設定:查看使用教學 →
VLESS On Demand Config

設定檢查流程

從連線設定到請求去向

連線開關、伺服器資訊與分流規則屬於不同層次。先確認設定能否建立連線,再檢查是哪條規則決定請求去向;每次只變更一個變數,保留可供比較的結果。

查看設定說明

規則分流:先看比對順序

規則分流決定某個請求使用哪種策略,而不是替伺服器補齊連線參數。在 Home 確認 Global Routing 設為 Config 後,再進入目前選取的 Config 閱讀 Rule。規則通常依照由上而下的順序比對,較精確的網域規則應放在範圍較廣的規則之前,FINAL 用來接收前面未符合的請求。若某個網站的去向不如預期,先記錄網域與實際符合的項目,再檢查規則順序及策略名稱;不要直接將所有請求改成 PROXY 來掩蓋問題。右側僅為規則語法範例,並非適用於所有網路的完整設定。

Rule · 範例
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
策略說明

DIRECT 直接連線;PROXY 使用代理策略;REJECT 拒絕符合的請求。符合規則不代表目標服務一定可用。

On Demand:檢查自動觸發條件

On Demand 可依照既定條件觸發連線,適合在手動連線已確認可用後設定。先在 Settings 找到 On Demand,逐項閱讀目前條件,釐清哪些網路變化應觸發、哪些應略過。若連線關閉後又自動開啟,應先檢查此處,而不是反覆刪除伺服器。排查連線不穩定時,可以暫時關閉自動觸發,只保留手動操作作為對照;確認問題來源後再還原原有條件。系統背景排程與網路切換都會影響觸發時機,因此自動觸發不代表連線始終可用。

設定路徑

Settings → On Demand

先確認手動連線,再新增自動觸發條件。

排查順序

暫時關閉 On Demand → 手動連線 → 切換網路測試 → 還原已確認的觸發條件。

多種協定:依既有資訊選擇 Type

新增伺服器時,Type 必須符合使用者既有伺服器實際提供的協定。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的欄位各不相同,不能只改協定名稱就完成轉換。在 Add Server 中先選擇 Type,再逐項檢查 Host、Port 以及對應的驗證和傳輸參數。透過連結或 QR Code 匯入後也應再次檢查欄位,特別留意複製時遺失的結尾參數。協定名稱只描述通訊方式,不代表速度或可用性;伺服器是否連線、參數是否相符及目前網路條件都需要分別確認。

協定參考
ShadowsocksVMessVLESSTrojanHysteria2WireGuard
Add Server

Type → Host → Port → 對應驗證參數。欄位說明請參閱術語表。

訂閱匯入:區分連結與設定內容

訂閱用來集中取得及更新使用者既有的伺服器項目。匯入前先向自己的服務商取得完整連結,確認沒有多餘空格、換行或截斷,再於 Add Server 選擇 Subscribe 並填入連結。儲存後返回 Home 檢查項目,必要時手動更新。若更新後清單為空,應區分連結無法存取、回傳內容不是訂閱格式,以及伺服器項目解析失敗等情況。更新訂閱不等於更新 Config 中的分流規則,也不表示目前選取的伺服器會自動變成可用。訂閱連結可能包含存取憑證,分享問題截圖時應遮蔽完整連結。

匯入檢查

Add Server → Subscribe

依序確認完整連結、儲存結果、手動更新及伺服器選取狀態。

管理範圍

訂閱管理伺服器清單;Config 管理規則與相關設定。兩者應分別檢查,避免更新清單後誤以為規則也已更新。

Config:確認目前使用的檔案

儲存設定檔與實際啟用它是兩回事。進入 Config 後,先確認目前選取的檔案,再閱讀 General、Rule、Hosts 等區段;修改前保留一份可還原的副本。遠端設定更新後,應再次確認本機修改是否仍存在,避免將同步或覆寫誤判為規則失效。使用 iCloud 同步時,也要檢查目標裝置是否已收到內容,並在目標裝置重新確認選取項目。同步設定不等於同步目前網路狀態,也不能取代伺服器憑證檢查。建議每次調整一項設定,並記錄調整前後的存取結果。

Config 區段
GeneralRuleHostsURL Rewrite
iCloud

先確認檔案已同步,再確認目前選取項目。修改前保留副本,發生異常時還原至上一份可用設定。

診斷工具:將故障範圍縮小至單一層次

Connectivity Test、Diagnostics 與 Data 分別提供連線檢查、診斷線索及流量觀察入口。先關閉連線並確認基本網路,再開啟連線測試同一目標,比較兩次結果。單次測試逾時不能證明所有請求都失敗,測試目標、DNS 解析與伺服器狀態都可能影響結果。Data 中的流量變化可協助判斷是否產生請求,但不能單獨說明請求已成功。記錄問題時,註明網路類型、Global Routing、目前 Config 與重現步驟;對外分享前遮蔽伺服器驗證資訊、訂閱連結與個人存取紀錄。

檢查工具
Connectivity TestDiagnosticsData
症狀索引

開關異常、伺服器逾時、DNS 問題與更新後異常,應沿不同路徑檢查。請參閱排查手冊。

GLOBAL ROUTING

三種模式分別要檢查什麼

介面中的 Config / Proxy / Direct 分別對應設定、代理、直連。模式選擇決定如何處理請求,不會修改伺服器本身的驗證參數。

Config:依目前設定分流

日常需要依網域、IP 或其他條件區分請求時,先選擇 Config,再確認 Config 頁面目前選取的檔案。某個請求出現非預期去向時,檢查該請求符合的第一條規則,以及規則引用的策略是否存在。在不同規則檔案中,相同伺服器可能得到不同結果,因此排查時應固定伺服器,只比較規則變化。若規則範例引用 PROXY,也要確認應用程式中能找到該策略可用的伺服器。不要直接以尚未理解的完整設定覆寫目前檔案。

依裝置取得

Shadowrocket 全平台取得方式

iPhone / iPad 在 App Store 一次性付費 $2.99;Mac、Windows、Android、Linux 版免費。安裝檔透過本站 /dl/shadowrocket/ 取得,首頁入口統一導向下載指南,再依裝置選擇。

iPhone / iPad

App Store 一次性付費 $2.99;Mac、Windows、Android、Linux 版免費。

使用自己的購買帳號確認商品頁,再完成取得。兩種裝置共用同一筆購買紀錄;系統需求以 App Store 頁面標示為準。首次使用前請準備好自己的訂閱或伺服器資訊,安裝完成不會自動建立連線設定。

Mac

免費 · Apple 晶片 / Intel

先在「關於這台 Mac」查看晶片資訊,下載頁分別提供 Apple 晶片與 Intel 安裝選項。首次開啟若遇到「無法驗證開發者」,先確認下載來源,再依下載指南前往「隱私權與安全性」處理,不要反覆更換來源不明的檔案。

Windows

免費

下載頁提供 Windows 64 位元安裝檔。首次執行若出現 SmartScreen 提示,先確認檔案來自本站,再查看「更多資訊」中的「仍要執行」。安裝提示的處理方式與連線故障排查不同,連線參數應在應用程式正常開啟後另行檢查。

Android

免費

使用下載頁提供的 arm64 安裝選項。系統詢問安裝權限時,僅依需求允許目前使用的下載應用程式「安裝未知應用程式」,完成後可還原原設定。若無法在微信內繼續下載,請改用系統瀏覽器開啟本站下載頁,再依頁面提示操作。

Linux

免費 · deb / rpm / AppImage

依發行版的套件管理方式選擇 deb 或 rpm;使用 AppImage 時,需先授予檔案執行權限。下載指南提供相應安裝步驟。出現相依性或啟動提示時,請保留完整錯誤訊息,先解決應用程式啟動問題,再匯入既有設定。

查看全部平台 →

首次設定

新增設定、選擇模式、驗證連線

以下以 iPhone / iPad 介面為例。先完成一次可重現的手動連線,再設定自動觸發與更細的分流條件。

步驟 01 · Add Server

匯入既有伺服器或訂閱

在 Home 開啟 Add Server,依既有資訊選擇協定,或使用 Subscribe 匯入完整訂閱連結。儲存後檢查 SERVER 清單,確認項目確實出現,再選取準備使用的伺服器。透過 QR Code 匯入也要確認協定與重要欄位,不應只憑項目名稱判斷設定正確。

步驟 02 · Global Routing

確認模式與 Config

需要規則分流時選擇 Config,並確認 Config 頁面目前選取的檔案;暫時使用 Proxy 對照時,請記住原始狀態。伺服器清單負責連線目標,Config 負責規則,兩者都要確認。首次設定不宜同時加入多份來源不明的規則,否則很難判斷是哪項變更影響結果。

步驟 03 · Connectivity Test

開啟連線並比較結果

依系統提示允許新增 VPN 設定,再開啟連線開關。先存取明確的測試目標,再使用 Connectivity Test 輔助檢查。開關顯示已連線,只代表連線狀態發生變化,不代表所有目標都能存取。失敗時記錄模式、伺服器與錯誤訊息,再依排查手冊逐項縮小範圍。

查看完整教學 →

正版核對與取得資訊

確認商品資訊,再處理購買與還原

Shadowrocket(小火箭)是閉源商業應用程式。本網站為官方網站與手冊;取得、設定及排查屬於不同環節,應分別確認。

開發者 Shadow Launch Technology Limited 應用程式 ID 932747118 2 種取得方式 · App Store 與本站安裝檔

開發者、圖示、應用程式 ID

取得 iPhone / iPad 版本前,請核對商品名稱 Shadowrocket、開發者 Shadow Launch Technology Limited 與應用程式 ID 932747118,並比對頁面上的官方圖示。僅憑搜尋結果中的同名文字不足以確認商品。可以從下載指南前往指定產品頁,再逐項查看商品資訊;遇到名稱相近的其他項目,不要將其價格或功能說明套用到 Shadowrocket。

官方圖示採用白底藍紫描邊圖案,頁首使用的也是該圖示。判斷時應以完整商品資訊為準,而非只看顏色、搜尋排序或某張介紹圖片。

商店顯示與帳號地區

中國大陸 App Store 目前未提供此應用程式,若搜尋不到,請先查看自己的 Apple ID 商店地區,而非更換關鍵字反覆搜尋。商店地區會影響商品顯示、當地貨幣價格與付款選項;若要變更地區,應先閱讀帳號中的地區變更條件,處理現有餘額、訂閱等限制,再依 Apple 的帳號設定流程操作。

iPhone / iPad 系統需求以 App Store 頁面標示為準。若頁面提示裝置不相容,請先確認系統與商品頁需求,不能將帳號地區問題和系統相容性問題視為同一種故障。

兩種價格與購買紀錄

iPhone / iPad 在 App Store 一次性付費 $2.99,各商店頁面依當地貨幣顯示;Mac、Windows、Android、Linux 版免費。iPhone 與 iPad 可使用同一購買帳號的紀錄重新取得;更換裝置或重新安裝時,先前往已購項目檢查,不要在確認帳號前重複購買。

重新下載應用程式與還原本機設定並非同一回事。先前儲存的訂閱、伺服器欄位及 Config 檔案,應從自己保留的設定或可用的同步內容還原,並在新裝置上重新確認目前選取項目。

用戶端買斷 ≠ 連線服務方案

用戶端費用僅用於取得應用程式,不包含伺服器存取權限。匯入教學一律以使用者已擁有自己的訂閱或伺服器資訊為前提。本網站不提供、不銷售、不推薦伺服器或訂閱,僅說明如何填寫、更新與排查既有資訊;安裝完成後清單為空,不代表應用程式取得失敗。

伺服器到期、驗證資訊變更或訂閱連結失效,應向原有服務商確認。這類問題無法透過重新購買用戶端解決,也不應反覆覆寫 Config 嘗試修復。

更新應用程式後,保留可供比較的設定

iPhone / iPad 透過 App Store 管理應用程式更新;其他平台在本站下載指南取得相應的新安裝檔,Mac 仍須區分 Apple 晶片與 Intel。安裝檔僅透過本站 /dl/shadowrocket/ 路徑取得。更新前保留既有伺服器資訊與可用的 Config,更新後先使用原有設定驗證,再逐項調整。若出現新問題,記錄應用程式中的實際提示、裝置系統、網路類型與操作順序;不要同時更換伺服器、訂閱、規則與 DNS,以免失去前後對照。

查看正版核對與已購項目還原說明 →

文章選讀

安裝格式與 App Store 操作說明

依目前遇到的問題閱讀:Linux 套件格式、商店商品核對,以及桌面版首次開啟提示。安裝完成後,再回到使用教學匯入既有設定。

查看所有文章 →