iPhone / iPad
App Store $2.99 一次性付費;其他平台免費。兩種裝置共用購買資格,系統需求以 App Store 頁面標示為準。先核對產品名稱、開發者與 App ID,再使用自己的 Apple ID 取得。已購買的使用者應先查看已購項目,不必直接重新購買。
Shadowrocket 官方手冊
全平台規則代理用戶端,用於匯入既有訂閱與規則分流;iPhone / iPad 在 App Store $2.99 一次性付費,Mac、Windows、Android、Linux 版免費。
目前版本 讀取中 · iPhone / iPad $2.99 一次性付費,Mac、Windows、Android、Linux 版免費
依裝置取得
先確認系統與晶片,再閱讀對應的取得與初次開啟說明。iPhone / iPad 在 App Store $2.99 一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費,安裝檔由本站下載頁提供。
App Store $2.99 一次性付費;其他平台免費。兩種裝置共用購買資格,系統需求以 App Store 頁面標示為準。先核對產品名稱、開發者與 App ID,再使用自己的 Apple ID 取得。已購買的使用者應先查看已購項目,不必直接重新購買。
免費 · Apple 晶片 / Intel;iPhone / iPad $2.99 一次性付費。在「關於這台 Mac」查看晶片或處理器名稱,選擇對應的 dmg。初次開啟若出現「無法驗證開發者」,核對下載來源後前往「隱私權與安全性」查看「仍要打開」;其他提示請依下載頁逐項處理。
免費;iPhone / iPad $2.99 一次性付費。下載頁提供 64 位元 exe 安裝程式。安裝前儲存正在編輯的設定;遇到 SmartScreen 時,先確認檔案來自本站下載頁,再選擇「更多資訊 → 仍要執行」繼續。由組織管理的裝置應遵循管理員的安裝政策。
免費;iPhone / iPad $2.99 一次性付費。使用 arm64 apk,並為實際執行安裝的瀏覽器或檔案管理器開啟「允許安裝未知的應用程式」。完成後可撤回此權限。在微信內無法下載時,改用系統瀏覽器開啟本站下載頁,再依頁面說明繼續。
免費 · deb / rpm / AppImage;iPhone / iPad $2.99 一次性付費。依發行版的套件管理方式選擇格式,不要只憑副檔名猜測相容性。AppImage 初次執行前需要執行權限;deb 與 rpm 的安裝方式、權限提示及相關命令集中列於下載頁。
設定項目與用途
先了解設定的作用,再調整參數。伺服器資訊決定連線方式,Global Routing 決定採用哪種轉送方式,Config 中的規則決定哪些請求使用哪項策略;三者應分開核對。
Global Routing 中的配置、代理、直連分別對應 Config、Proxy、Direct。需要依目標分別處理請求時,選擇 Config,並確認 Config 中啟用的檔案。規則通常依序比對,較具體的條件應排在較寬泛的條件之前。PROXY、DIRECT、REJECT 代表不同處理策略;範例中的 example.com 僅用於說明語法,不代表可用伺服器。排查時應先確認目前模式,再檢查命中的規則。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXYOn Demand 可依設定條件觸發連線行為,入口位於 Settings。它與 Config 內的請求分流並非同一層設定:前者決定何時建立連線,後者決定啟用連線後如何處理請求。可依需求檢查 Wi-Fi SSID、Cellular 與 Domain 等條件,先用一個明確情境驗證,再增加其他條件。手動中斷後又重新連線時,應先檢查此處,而非反覆刪除伺服器或重新安裝應用程式。
On Demand
Wi-Fi SSID
Cellular
DomainShadowrocket 支援多種協定,新增時應在 Add Server 的 Type 中選擇與既有伺服器相同的類型。協定名稱相似不代表欄位可以互換,Host、Port、Password 以及傳輸和 TLS 相關參數都需要逐項核對。匯入後仍應檢查重要欄位是否完整,不能只憑備註名稱判斷設定正確。具體選項與欄位以目前應用程式內顯示為準,伺服器端變更參數後也應同步更新用戶端記錄。
ShadowsocksVMessVLESSTrojanHysteria2WireGuard
已有自己的訂閱連結時,可透過 Subscribe 相關入口儲存並更新伺服器清單;單筆伺服器資訊則可使用 Add Server、Scan QR Code 或從剪貼簿匯入。更新訂閱是重新取得該訂閱中的項目,不等於連線測試,也不等於下載規則設定。管理多筆訂閱時,先區分群組與來源,再處理重複項目。訂閱網址可能包含存取憑證,向他人展示問題時應遮蔽完整連結與 QR Code。
Subscribe
Add Server
Scan QR Code
Import from Cloud JSONConfig 用於管理設定檔,其中 General、Rule、Hosts 等部分各有不同用途。伺服器清單與規則檔案應分別理解,匯入其中一項不代表另一項也已準備完成。編輯前先儲存副本,並記錄目前啟用的檔案;遇到異常時即可還原至變更前的狀態。使用 iCloud 同步或換機還原後,仍需檢查檔案是否已送達新裝置、目前選取是否正確,以及伺服器憑證是否完整。
[General]
[Rule]
[Hosts]
Config · iCloudConnectivity Test 可協助初步了解目前網路與伺服器的連線狀況,Settings 中的 Diagnostics 則用於進一步收集排查資訊。Data 提供流量統計資訊,但統計數值不能直接視為線路剩餘額度,也不能只憑一次測試認定所有應用程式都能正常存取。建議先驗證一般網頁,再重現目標應用程式的問題,同時記錄網路類型、Global Routing、所選伺服器與具體錯誤,以縮小檢查範圍。
Connectivity Test
Diagnostics
Data
Global Routing初次連線順序
以下以已有自己的訂閱或伺服器資訊為前提。先完成最小可用設定,再新增自動連線與複雜規則;不要同時變更伺服器、DNS 與分流設定,否則難以判斷是哪一項影響結果。
在 Home 使用 Add Server 新增既有伺服器,依原始資訊選擇 Type 並填寫欄位;已有訂閱時,依教學前往 Subscribe 相關入口儲存連結。掃描 QR Code 前確認其內容來自自己的伺服器資訊,從剪貼簿匯入前確認內容完整。儲存後返回 SERVER 群組,檢查項目是否出現、備註是否易於辨認,再選擇此次準備使用的伺服器。
若清單為空,應先判斷是訂閱未能取得,還是已取得但沒有可解析的項目。重複點選匯入可能會產生重複記錄,並不會自動修正錯誤網址。先檢查連結是否遭截斷、是否多出空格,再核對存取憑證與有效狀態;不要將含有憑證的完整連結放入公開截圖。
需要規則分流時選擇 Config,並進入 Config 確認目前啟用的檔案。Proxy 與 Direct 可協助區分問題發生在代理連線或本機直連,但它們不代表更換了伺服器。手動新增的伺服器記錄也不會自動產生適用於所有情境的規則。先了解既有設定的用途,再決定是否編輯。
設定中的 PROXY 是策略關鍵字,不是伺服器網址;DIRECT 表示透過本機網路直接連線至目標。規則順序、DNS 設定及區域網路相關項目會共同影響存取結果。初次操作只確認必要項目,保留原設定副本,暫時不要將不同來源的規則片段混合在同一個檔案中。
開啟 Home 頂端的連線開關,初次使用時閱讀系統顯示的 VPN 設定授權提示,確認後再繼續。接著執行 Connectivity Test,再開啟熟悉的網頁驗證實際存取狀況。開關開啟只表示連線狀態有所變化,不代表伺服器、規則、DNS 與目標服務都已驗證通過。
若連線失敗,依序檢查本機網路、伺服器欄位、目前伺服器、Global Routing、Config,每次只修改一項並重新測試。只有某個應用程式異常時,記錄該應用程式的錯誤與發生條件;Wi-Fi 正常而行動網路異常時,應分別重現問題。完成手動驗證後,再考慮 On Demand,避免自動觸發干擾排查。
查看完整教學 → 或閱讀 訂閱與伺服器管理手冊 →
正版與取得資訊
小火箭文件站是 Shadowrocket 官網與官方手冊。核對商店身分、區分用戶端與線路服務、儲存自己的設定,是取得與移轉前應完成的三項檢查。
進入 App Store 產品頁後,應同時核對名稱 Shadowrocket、開發者 Shadow Launch Technology Limited,以及連結中的 App ID 932747118。官方圖示為白底藍紫描邊火箭,本站頁首使用相同的官方圖示。名稱相近或圖形相似都不能取代身分核對,搜尋結果的排序也不能作為依據。系統需求以 App Store 頁面標示為準,購買前應在目前裝置查看相容性說明。
電腦與 Android 使用者應從本站下載頁選擇符合系統與晶片的安裝檔,檔案網址由本站 /dl/shadowrocket/ 路徑提供。不要修改其他平台檔案的副檔名後嘗試執行。系統出現阻擋提示時,應先確認檔案來源與類型,再閱讀下載頁的對應處理步驟;不應為了執行單一檔案而長期關閉系統層級的防護設定。
中國大陸 App Store 目前沒有此應用程式。搜尋不到時,先確認自己的 Apple ID 商店地區與產品頁顯示狀態,而不是反覆輸入不同別稱。帳號地區、付款方式和商店可購買範圍彼此相關,但並非同一件事;需要調整地區時,請使用 Apple ID 設定中的官方流程,並先閱讀帳號餘額、現有訂閱與家人共享等條件提示。
開啟產品頁後,還應查看按鈕顯示的是價格還是重新下載標記。裝置登入的帳號與完成原始購買的帳號可能不同,家中另一台裝置可以下載,也不代表目前帳號已擁有相同購買記錄。有疑問時先核對記錄,再決定下一步,避免將帳號問題誤認為應用程式安裝故障。
iPhone / iPad 版在 App Store 美國商店定價為 $2.99 一次性付費,其他商店依當地貨幣顯示,請以購買頁面為準;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。iPhone 與 iPad 兩種裝置共用購買資格,還原時需要使用完成購買的 Apple ID。這裡的兩種取得方式適用於用戶端本身,不應與網路服務費用混為一談。
Shadowrocket 是閉源商業應用程式。行動裝置上的商店購買記錄用於確認用戶端取得資格,桌面與 Android 使用者則依本站下載頁取得對應版本。協定選擇、規則檔案與伺服器參數仍須由使用者依自己的使用環境設定;應用程式能否成功發起連線,也取決於既有伺服器資訊與目前網路狀況。
用戶端買斷 ≠ 線路方案。取得 Shadowrocket 不會自動產生伺服器網址、訂閱連結或可用線路。本站不提供、不銷售、不推薦節點或訂閱,只說明如何管理使用者已有的資訊。教學中的 example.com 是語法範例,不能作為實際連線目標;個人密碼、訂閱連結與 QR Code 也不應提交至公開討論區。
了解這一點後,排查順序會更明確:尚未準備自己的伺服器資訊時,先整理既有資料;可以匯入但無法連線時,檢查協定欄位與網路;連線成功但部分請求異常時,再檢查規則與 DNS。用戶端購買記錄、訂閱有效狀態和設定檔是否正確,需要分別核對,不能用其中一項推斷其他項目都正常。
iPhone / iPad 重新安裝或換機後,先在 App Store 的已購項目中尋找 Shadowrocket,使用原購買帳號重新下載。Mac、Windows、Android、Linux 版可重新前往本站下載頁選擇安裝檔。還原應用程式與還原資料並非同一件事:程式重新安裝完成,不代表伺服器清單、規則檔案與目前選項也已完整還原。
移轉前應匯出必要設定並妥善保存,使用 iCloud 同步時確認同步已完成。新裝置還原後,逐項核對 SERVER 群組、目前伺服器、Config 檔案、Global Routing 與 On Demand。先在新裝置完成實際連線驗證,再清除舊裝置中的記錄;刪除前尤其要確認是否會影響正在同步的資料。
iPhone / iPad 可透過 App Store 查看應用程式更新;其他平台可從本站下載頁重新取得目前安裝檔。頁面版本資訊由下載清單動態讀取,不以文章發布時間代替版本判斷。更新前儲存正在編輯的設定,記錄目前啟用的檔案與伺服器,更新後先重新測試原本可用的情境,再逐步調整新設定。
遇到安裝或初次開啟遭阻擋時,可直接閱讀安裝允許說明。帳號與已購項目相關問題,請查看購買還原步驟;訂閱更新、重複項目與備份相關問題,請查看伺服器管理手冊。依問題所屬層面查閱,比同時重設所有選項更容易保留有效設定。
技術筆記
依具體操作情境補充細節。先完成基本連線,再閱讀對應專題;文中的設定操作均以已有自己的訂閱或伺服器資訊為前提,不涉及訂閱來源。
區分自動連線條件與請求分流,依 Wi-Fi SSID、Cellular 和 Domain 檢查觸發情境。設定前先驗證手動連線,遇到中斷後又重新連線時,依條件逐項定位,避免同時變更規則與伺服器。
閱讀 On Demand 說明 →說明從本站下載頁選擇 arm64 apk 的步驟、如何授予執行安裝的應用程式「安裝未知應用程式」權限,以及在微信內無法下載時如何改用系統瀏覽器。完成後再檢查初次連線所需的系統授權。
閱讀 Android 版安裝說明 →在「關於這台 Mac」辨認 Apple 晶片與 Intel,依裝置選擇對應檔案。初次開啟遇到 macOS 或 SmartScreen 提示時,先確認本站下載來源,再依系統提供的入口處理,並保留現有設定副本。
閱讀桌面版安裝說明 →