iPhone / iPad
App Store 一次性付費 $2.99
兩種裝置共用購買項目;Mac、Windows、Android、Linux 版免費。系統需求以 App Store 頁面標示為準。開啟產品頁後,先核對開發者與 App ID,再確認目前帳戶所在區域是否可取得。更換裝置或重新安裝時,應先檢查已購項目,不要只根據搜尋結果判斷購買記錄是否仍在。
全平台規則代理用戶端:依裝置取得、匯入既有訂閱,再設定 Global Routing 與規則分流。
目前版本 v2.2.92 · iPhone / iPad 一次性付費 $2.99,Mac、Windows、Android、Linux 版免費
CAPABILITY REFERENCE
伺服器能否建立連線、流量要交給哪個策略、網域如何解析,是三個不同問題。依下列主題查閱對應介面,再修改特定欄位;一次只調整一個變數,方便確認變化的原因。
RULES / GLOBAL ROUTING
在 Home 的 Global Routing 中,Config 依目前設定分流,Proxy 會將適用流量交給所選代理,Direct 則使用直連。要讓規則生效,先選擇 Config,再檢查規則順序:由上往下比對,符合後即停止;DOMAIN-SUFFIX 比對網域後綴,IP-CIDR 比對 IP 位址範圍,FINAL 放在最後作為備援。PROXY、DIRECT、REJECT 分別表示代理、直連與拒絕。下方僅為語法片段,並非完整設定;修改前先保留原始檔案,並確認策略名稱存在。
查看規則順序與 FINAL 範例 →RULE ORDER
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
ON DEMAND
On Demand 用於依設定條件要求建立或中斷連線,不會取代伺服器參數,也無法修復失效的訂閱。先在 Home 完成一次手動連線並瀏覽網頁,再進入 Settings 查看 On Demand 條件。設定前先釐清希望在哪類網路下連線,避免多個條件彼此覆蓋;排查意外重新連線時,先暫時關閉自動觸發,回到手動狀態重現問題。條件是否適用,以目前系統和實際介面為準;切換 Wi-Fi 與行動網路後應分別驗證。
查看 On Demand 設定依據 →CONNECTION CONDITIONS
Settings
On Demand
Home
Global Routing
Connectivity TestPROTOCOLS
Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定。新增前,請向服務提供者取得既有伺服器資訊,在 Add Server 中先選擇 Type,再填寫該類型要求的欄位。不同協定的身分憑證、傳輸設定和 TLS 參數都不同,不應只因連接埠相同就複製整組設定。匯入後仍須核對 Host、Port 與相關選項;WireGuard 的金鑰、位址和路由欄位,應依既有設定解讀,不要根據其他協定的欄位推測。
區分協定與傳輸設定術語 →PROTOCOL TYPES
Shadowsocks / VMess
VLESS / Trojan
Hysteria2 / WireGuard
HTTP / SOCKS5SUBSCRIBE
訂閱網址用於取得並更新一組伺服器資訊,單筆節點連結通常只描述一筆連線項目。向服務提供者取得連結後,先確認用途,再選擇 Subscribe、Add Server、掃描 QR Code 或剪貼簿入口。不要把網站帳戶網址當作訂閱網址,也不要把一般設定檔誤認為節點清單。更新後檢查項目是否出現、分組是否正確,再選擇伺服器測試;訂閱更新可能會覆蓋由遠端管理的欄位,需長期保留的修改應存入獨立的本機設定。
查看四種匯入入口的差異 →IMPORT ENTRIES
Subscribe
Add Server
Scan QR Code
Import from Cloud JSONCONFIG / SYNC
Config 管理設定檔及其中的 General、Rule、Hosts 等內容。開始修改前先複製一份,並記錄目前使用的檔案,避免編輯未啟用的設定,卻誤以為規則失效。遠端設定更新與伺服器訂閱更新並非同一操作,更新前應先了解可能被取代的內容。使用 iCloud 同步時,先確認裝置使用相應帳戶且同步功能可用,再檢查檔案是否確實到達;檔案同步不等於連線狀態同步,也不能取代訂閱有效性與本機權限檢查。
查看 Settings 與設定管理參考 →CONFIG SECTIONS
General
Rule
Hosts
URL Rewrite
HTTPS DecryptionDIAGNOSTICS / DATA
Connectivity Test 和 Ping 可協助檢查連線狀態,Data 用於觀察流量,Log 與 Diagnostics 則提供排查線索。延遲測試成功不代表所有網頁都能瀏覽:目標網域解析、規則比對結果和伺服器狀態仍可能影響結果。先確認一般網路可用,再檢查所選伺服器參數和系統時間,最後查看 DNS 與規則。Data 中的流量變化可協助判斷請求是否經過連線,但無法單獨證明路由符合預期;分享記錄前應移除訂閱網址和身分憑證。
依序排查逾時與連線失敗 →CHECK IN ORDER
Connectivity Test
Ping
DNS
Log / Diagnostics
DataPLATFORM PACKAGES
兩種取得方式:iPhone / iPad 在 App Store 一次性付費 $2.99;Mac、Windows、Android、Linux 版免費。以下入口皆前往下載頁,安裝套件由本站提供;首次開啟前,請閱讀對應系統的允許執行說明。
App Store 一次性付費 $2.99
兩種裝置共用購買項目;Mac、Windows、Android、Linux 版免費。系統需求以 App Store 頁面標示為準。開啟產品頁後,先核對開發者與 App ID,再確認目前帳戶所在區域是否可取得。更換裝置或重新安裝時,應先檢查已購項目,不要只根據搜尋結果判斷購買記錄是否仍在。
免費 · Apple 晶片 / Intel
開啟系統的「關於這台 Mac」,依畫面顯示的晶片或處理器選擇對應安裝套件,不要根據電腦外觀或購買年份推測。首次開啟若提示無法驗證開發者,確認下載來源後,依下載頁指引前往「隱私權與安全性」處理。兩種晶片版本的取得方式相同,不需要前往行動裝置商店。
免費
在下載頁選擇 Windows 64 位元安裝套件,下載完成後再執行。若 SmartScreen 阻止啟動,先確認檔案來自本站,再依「其他資訊 → 仍要執行」的步驟處理;受組織原則管理的裝置應先確認權限。開始匯入前,準備好既有訂閱或伺服器資料;安裝完成本身並不代表已可連線。
免費
下載頁提供 arm64 安裝套件。系統提示需要安裝權限時,只對實際用來下載並開啟檔案的應用程式啟用「允許安裝未知的應用程式」,完成後可回到系統設定管理該權限。應用程式內的瀏覽器若阻止儲存檔案,可使用系統瀏覽器開啟本站下載頁,再依裝置提示繼續,不必重複點選同一個下載按鈕。
免費 · deb / rpm / AppImage
先確認發行版、套件管理器與處理器架構,再選擇格式。Debian 系發行版通常選擇 .deb,RPM 系發行版選擇 .rpm;使用 .AppImage 時需要授予檔案執行權限。不要只靠修改副檔名轉換格式。相依套件缺失、桌面環境與系統權限問題,應依據終端機顯示的資訊排查;具體指令請參閱下載頁的安裝允許執行表。
更新時,iPhone / iPad 使用 App Store 的更新機制;其他平台請返回本站下載頁取得新版安裝套件。更新前保留既有設定,更新後檢查目前使用的檔案和伺服器選擇,避免將設定變更誤認為安裝失敗。
FIRST CONNECTION
以下以 iPhone / iPad 的介面用語說明操作方式。前提是已備妥自己的訂閱或伺服器資訊;先完成一筆連線,再新增自動觸發、複雜規則或同步設定,排查時更容易找到原因。
向服務提供者取得既有訂閱或伺服器資訊,先分辨資料是訂閱連結、單筆節點連結,還是完整設定檔。手動新增時進入 Add Server,選擇 Type 後再填寫 Host、Port 和對應的身分參數;使用 QR Code 時,先確認其中包含的是連線資訊,而不是帳戶頁面。匯入訂閱後等待更新完成,確認 Home 的 SERVER 分組中出現項目,再選擇準備測試的項目。
項目未出現時,先核對連結類型和複製的內容,不要立刻修改 DNS。連結中多出的空格、換行或缺少字元都可能影響匯入;也不要為了排查而公開傳送完整訂閱網址。保留匯入前的設定,之後才能比對是項目更新、參數變動,還是選錯分組。
在 Home 檢查 Global Routing。設定對應 Config,依目前設定中的規則決定流量去向;代理對應 Proxy,使用所選代理處理適用流量;直連對應 Direct。準備使用規則分流時,選擇 Config 並確認已啟用預期檔案。若要定位規則問題,可短暫使用 Proxy 進行對照測試,但測試結果只能說明當時的瀏覽差異,不能取代逐條檢查規則。
規則由上往下比對,較寬泛的規則若放在前面,可能使後面的精確規則無法比對。先檢查網域相關規則,再查看位址範圍與最後的 FINAL。不要同時更換伺服器、切換模式並重寫規則;每次只調整一項,測試後記錄結果,才能分辨是連線參數問題,還是流量去向不如預期。
開啟連線開關。首次連線出現系統新增 VPN 設定提示時,確認操作來自 Shadowrocket,再依系統要求允許。接著執行 Connectivity Test,並開啟實際需要瀏覽的網頁。系統顯示已連線,只能代表相應連線狀態已建立,不代表每個網域、每種協定或所有應用程式要求都能成功;延遲測試與網頁瀏覽也不是同一種驗證方式。
若連線失敗,先關閉連線並確認一般網路,再核對伺服器參數、系統時間和訂閱狀態。延遲正常但網頁無法開啟時,繼續檢查 DNS 與規則比對結果;只有切換網路後才發生問題時,再查看 On Demand 條件。查看 Log 或 Diagnostics 時記錄出錯環節,分享前移除訂閱網址、伺服器身分憑證和其他個人資訊。
IDENTITY / PURCHASE / RESTORE
本站是 Shadowrocket 官網與官方手冊。Shadowrocket(小火箭)是閉源商業應用程式;取得用戶端、復原購買項目與匯入服務提供者資料,需分別處理。
iPhone / iPad 使用者開啟指定的 App Store 產品頁,確認名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited,並核對 App ID 932747118。官方圖示為本站頁首所示的白底藍紫描邊圖示。只靠中文別稱、相似圖示或搜尋排序,無法確認產品身分;應一併核對上述資訊。
若搜尋結果出現同名項目,請返回下載頁提供的產品連結核對,不要繼續嘗試相似的搜尋結果。系統需求以 App Store 頁面標示為準,裝置是否符合安裝條件也應在該頁面確認。電腦與 Android 的取得入口位於本站下載頁,安裝套件由本站透過 /dl/shadowrocket/ 路徑提供。
中國大陸 App Store 未提供此應用程式。搜尋不到時,先檢查目前用於商店的 Apple ID 所在地區,以及產品頁在該地區是否可見;地區可見不代表裝置相容。若需調整帳戶地區,請依 Apple 帳戶設定中的「國家或地區」流程處理,並先閱讀餘額、現有訂閱與付款方式等限制說明。
不要混淆網站介面語言、裝置系統語言與商店地區。瀏覽器能顯示產品介紹,也不代表目前的商店帳戶一定可以取得應用程式。若裝置上的產品頁提示不相容,請返回頁面查看需求,不要反覆登出和登入帳戶;購買記錄相關問題則應另外前往已購項目查核。
查看商店地區說明 →iPhone / iPad 在美國 App Store 一次性付費 $2.99,兩種裝置共用購買項目;各地商店依當地貨幣顯示價格。Mac、Windows、Android、Linux 版免費。已購買的使用者更換裝置或重新安裝時,應先使用原購買帳戶檢查已購項目,再下載對應應用程式。更換裝置不代表一定需要再次購買。
若在已購項目中找不到,先確認目前的商店帳戶是否與購買時相同,再檢查購買記錄與產品身分。重新安裝應用程式與復原設定並非同一件事:重新取得用戶端後,仍須確認本機設定、同步檔案和既有訂閱是否齊全。其他平台重新取得安裝套件即可;更新或重新安裝前,請妥善保留原有資料。
查看已購項目復原說明 →用戶端一次性買斷 ≠ 連線服務方案。用戶端用於讀取既有連線資訊、執行規則並提供診斷工具;應用程式購買記錄不包含服務提供者帳戶、伺服器使用期間或訂閱額度。本站不提供、不銷售、不推薦節點或訂閱;訂閱連結與伺服器資訊請向你的服務提供者取得。連線資料的有效期限、參數變更與可用狀態,應與應用程式本身的安裝和購買分開判斷。
訂閱無法更新時,先檢查一般網路和網址是否完整,再確認既有服務是否仍有效;更換用戶端安裝套件不會自動延長訂閱。整理排查資訊時可以描述錯誤位置、所選協定和測試順序,但不要公開完整連結或密碼。清楚區分用戶端、設定檔與服務提供者資料,可減少重複操作,也更容易定位問題。
查看訂閱、設定與規則術語 →FIELD NOTES
以下三篇文章依主題說明常見的排查方式。先選擇最符合目前狀況的項目:解析失敗查看 DNS、節點逾時先核對連線狀態與參數、流量去向不符則檢查 Global Routing 和規則順序。不要同時重設不同層級的設定。
延遲正常並不能排除網域解析問題。文章從實際瀏覽失敗的環節著手,區分伺服器連線、DNS 回應與規則去向,說明欄位意義和調整依據,避免以反覆更換 DNS 取代問題定位。
閱讀 DNS 排查順序 →先確認一般網路,再檢查延遲測試、協定參數與系統時間。針對節點顯示逾時、連線後仍無法瀏覽等狀況分別收集資訊,釐清每個步驟檢查的層面,並在修改後以相同目標重新驗證。
閱讀連線失敗檢查清單 →以實際語法說明規則符合後即停止比對的意義,解釋精確規則與寬泛規則的排列方式,以及 FINAL 為何放在最後。複製範例前先核對既有設定中的策略名稱,避免語法正確卻指向錯誤策略。
閱讀規則排序說明 →