官方手冊 · 全平台
Shadowrocket 幫助中心
下載、設定與規則參考
全平台規則代理用戶端 ,用於連接既有伺服器與規則分流 。iPhone / iPad 在 App Store $2.99 一次性買斷;Mac / Windows / Android / Linux 版免費。
目前版本 讀取中 · iPhone / iPad App Store $2.99 一次性;Mac、Windows、Android、Linux 版免費
首次使用:查看匯入與連線步驟 →
先區分伺服器、訂閱與設定檔:伺服器儲存連線參數;Subscribe 用於更新一組伺服器;Config 決定請求如何比對規則。匯入其中一項,不代表另外兩項已完成。以下功能依使用情境整理,選取方塊可查看操作要點;範例僅說明規則語法,不含可連線的服務資料。
規則分流
On Demand
多種協定
Subscribe 訂閱匯入
Config 設定檔
診斷工具與 Data
Global Routing 模式
裝置與 iCloud
先比對條件,再執行策略 規則分流可讓不同請求採用不同處理方式。在 Config 中核對 Rule,並在 Home 將 Global Routing 設為 Config,規則才會參與一般分流。DOMAIN-SUFFIX 比對網域後綴,IP-CIDR 比對 IP 位址範圍,FINAL 處理先前未符合的請求。檢查時先看規則順序,再確認目標策略是否存在;過於寬泛的規則若放在前面,可能會遮蔽後續的細分規則。修改前請保留原始檔案,每次只調整一項,並以實際請求記錄核對比對結果。
查看規則關鍵字 →
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
連線穩定後再設定 On Demand On Demand 會依已設定的條件觸發連線,不會產生伺服器資料,也無法修復失效的服務。先在 Home 手動連線並完成連線驗證,再進入 Settings 檢查 On Demand 的條件。調整後分別測試 Wi-Fi 與行動網路切換,確認是否符合預期。若關閉連線後又自動開啟,請先檢查此項與系統中的相關連線設定,不要重複刪除設定。疑難排解期間可暫時關閉自動觸發,等手動連線正常後再恢復,避免將觸發問題誤認為規則問題。
查看 On Demand 設定說明 →
# 操作檢查順序
Home
Settings → On Demand
Home → Connectivity Test
Type 必須與既有服務相符 Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、WireGuard 等協定。新增時在 Add Server 選擇對應的 Type,再依既有伺服器資訊填寫欄位;不同協定的驗證方式與傳輸參數不可互相套用。Host 與 Port 正確,不代表其他參數都齊全,還需要核對密碼或識別碼、TLS 與傳輸相關選項。資料不完整時,請向自己的服務商確認。掃描 QR Code 可減少輸入錯誤,但匯入後仍應檢查協定類型與位址,不能只憑備註判斷伺服器是否可用。
查看協定術語 →
# 欄位核對,不是連線設定
Type
Host
Port
# 依所選協定繼續核對驗證參數
匯入既有 Subscribe 資料 訂閱可集中更新伺服器清單,前提是使用者已有自己的訂閱連結。在 Home 進入 Add Server,選擇 Subscribe,填入既有位址並儲存,再檢查傳回的伺服器項目。若結果為空,先確認連結是否完整、是否已失效,以及傳回內容是否為支援的格式,不要重複新增同一連結。更新前保留必要的群組備註;刪除前先確認要刪除的是單一伺服器還是整份訂閱。訂閱位址可能包含存取憑證,截圖、回報問題或移轉裝置時,請避免公開完整位址。
查看多訂閱管理 →
# Home → Add Server
Type: Subscribe
# 儲存後檢查
# 群組名稱 / 伺服器清單 / 更新結果
匯入與啟用需分別檢查 Config 用來儲存規則及相關設定,與伺服器清單的用途不同。取得設定檔後,先備份目前檔案,再核對 General、Rule、Hosts 等區段及其引用的外部資源。匯入完成後,還要確認目前選取的檔案,並在 Global Routing 使用 Config。若切換後只有部分網站異常,請優先比對新舊檔案的 DNS 設定、規則順序與策略名稱,而不是立即重新安裝用戶端。範例中的 FINAL,DIRECT 表示未符合規則的請求採用直連,僅用於說明語法,不能取代依需求編寫的完整設定。
查看設定與 Settings 參考 →
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECT
分開檢視連線狀態與請求結果 Connectivity Test 可初步觀察連線狀況,Data 可檢視流量記錄,Settings 中的 Diagnostics 和 Log 則有助於定位問題。測試有回應,不代表目標網站的每項請求都正常;連線開關已開啟,也不代表所有流量都會經過代理。排查時記錄所用網路、伺服器、Global Routing 模式與出錯操作,再對照記錄中的網域、策略及錯誤資訊。回報前請隱藏位址中的憑證與個人資訊;排查完成後依需求調整記錄設定,避免累積與目前問題無關的記錄。
查看診斷設定 →
# 依層次檢查
Home → Connectivity Test
Data
Settings → Diagnostics
Settings → Log
Config / Proxy / Direct Global Routing 有三種模式:設定檔 Config、代理 Proxy、直連 Direct。Config 依目前設定檔中的規則處理請求;Proxy 讓請求採用代理路徑;Direct 用於直連檢查。日常需要規則分流時請選擇 Config,並確認對應檔案已啟用。疑難排解時可暫時切換模式以縮小範圍,但切換本身不會修正錯誤的伺服器參數。若 Proxy 可用但 Config 異常,請回頭檢查規則與 DNS;比對完成後恢復原本模式,避免將暫時測試設定當成最終設定。
查看模式選擇步驟 →
Global Routing
├─ Config
├─ Proxy
└─ Direct
先備份,再同步與移轉 在支援 iCloud 同步的裝置上,先確認系統帳號、iCloud Drive 與應用程式相關權限,再檢查 Shadowrocket 的同步設定。同步與手動匯出是不同的備份方式,移轉前應保留一份用途清楚的 Config 檔案,並妥善保存既有服務資料。新裝置匯入後,重新核對目前檔案、伺服器選擇、Global Routing 與 On Demand;也需要在新裝置上確認系統連線權限。不要因為檔案已出現就直接覆蓋舊裝置內容,先驗證連線與規則,再決定是否清除原有備份。
查看備份與換機移轉 →
# 移轉後逐項檢查
Config
Home → Global Routing
Settings → On Demand
Home → Connectivity Test
Shadowrocket / 932747118
正版核驗 · 2 種取得方式
商店資訊與本站安裝檔
iPhone / iPad 請核對開發者、官方圖示與 App ID;Mac、Windows、Android、Linux 請從本站下載頁選擇安裝檔。先確認應用程式身分與裝置類型,再進行匯入。
查看正版核驗步驟 →
核對開發者、圖示與 App ID
開啟 Shadowrocket 的 App Store 產品頁,開發者應為 Shadow Launch Technology Limited ,App ID 為 932747118 。同時比對本站頁首使用的官方圖示:白底、藍紫色描邊圖案。搜尋結果中的名稱和圖示僅供初步辨識,請繼續進入產品頁核對開發者與 App ID,不要將名稱相近的項目視為同一款應用程式。系統需求以 App Store 頁面標示為準。
Shadowrocket 是閉源商業應用程式。本手冊依實際介面用詞與操作步驟說明功能,不以評分或下載量取代身分核對。電腦與 Android 使用者應從本站全平台下載頁進入,安裝檔透過本站 /dl/shadowrocket/ 路徑提供;選擇裝置與安裝格式後,再依照系統提示完成安裝。
價格與購買範圍
iPhone / iPad 在 App Store $2.99 一次性買斷,Mac / Windows / Android / Linux 版免費。 App Store 各商店會依當地貨幣顯示價格,實際付款金額以產品頁及確認付款頁面為準。iPhone 與 iPad 可使用同一購買帳號的已購項目取得應用程式;此項購買是用戶端使用權,不是按月購買連線服務,也不會自動產生伺服器。
用戶端買斷 ≠ 連線方案。 本站不提供、不銷售、不推薦任何節點或訂閱。新增伺服器、掃描 QR Code 和 Subscribe 操作,皆以使用者已擁有自己的訂閱或伺服器資訊為前提。若只有用戶端而沒有這些資料,請先向自己的服務商確認既有資訊,不要在 Config 中反覆切換檔案。
商店顯示與帳號地區
App Store 搜尋結果與 Apple ID 所屬商店地區有關。中國大陸商店若沒有此應用程式,請先檢查目前商店帳號地區,再確認是否能開啟產品頁。變更地區應依系統中的帳號設定提示操作,並先了解餘額、現有訂閱與付款方式受到的影響;更改裝置語言或顯示地區,不代表已變更商店帳號地區。
購買前請確認使用的是準備長期保留的個人帳號,並保留自己的購買記錄。商店搜尋不到與用戶端連線失敗是兩種不同問題:前者先檢查商店與帳號資訊,後者再檢查伺服器、網路和規則。分開處理這兩個階段,可避免尚未安裝應用程式時就誤改網路設定。
重新安裝、換機與後續更新
在 iPhone / iPad 重新安裝或換機時,請使用原購買帳號查看已購項目並重新下載;若顯示需要再次購買,先核對帳號和購買記錄,不要立即重複付款。重新取得應用程式與還原設定是兩件事,原裝置中的伺服器選擇、Config 檔案和自動連線條件仍需備份與確認。
iPhone / iPad 後續更新透過 App Store 管理;Mac、Windows、Android、Linux 使用者可回到本站下載頁取得新版安裝檔。更新前請保留目前使用的設定,完成後先驗證原有連線路徑,再檢查新增或變更的設定。若首次開啟時遭系統攔截,請依下載頁的安裝放行說明逐項核對來源與提示,不要將無法連線與系統安裝提示混為一談。
取得方式分為兩種:iPhone / iPad 在 App Store $2.99 一次性購買,Mac / Windows / Android / Linux 版免費。以下入口均會前往本站下載頁的對應區段;系統辨識僅用於將目前裝置排在前面,實際安裝時仍需核對晶片、系統與檔案格式。
安裝檔沒有程式碼簽章,首次開啟時可能出現系統攔截提示。僅對已確認來自本站的檔案依步驟放行,不應為了完成一次安裝而關閉整套系統防護。詳細提示、操作入口與指令請見安裝放行說明 。
以下預覽使用 iPhone / iPad 的介面用詞。開始前請確認已取得自己的訂閱或伺服器資訊,並能區分訂閱位址與單一伺服器參數。首次操作先完成一條可重現的連線流程,再逐項加入規則與自動連線設定;發生問題時,便能回到上一個已驗證的狀態。
01 / Home
新增伺服器或匯入既有訂閱
在 Home 進入 Add Server。單一伺服器依資料選擇 Type,填寫 Host、Port 及對應的驗證欄位;既有訂閱則選擇 Subscribe 並儲存完整位址。使用 Scan QR Code 時,匯入後也應開啟詳細資料核對參數。掃描只是輸入方式,不代表參數已通過連線測試。
儲存後檢查 SERVER 群組是否出現預期項目,再選擇準備測試的伺服器。若匯入結果為空,先檢查連結是否遭截斷、訂閱是否有效、傳回內容是否正確。資料尚未確認完整前,不要連續建立多個重複項目,也不要將 Config 檔案位址當成伺服器訂閱位址。
02 / Global Routing
確認模式與目前設定檔
需要規則分流時,在 Global Routing 選擇 Config,並到 Config 確認目前使用的檔案。Proxy 與 Direct 可用來區分問題:前者檢查代理路徑,後者檢查直連路徑。選擇模式不能取代伺服器設定;伺服器資料錯誤時,切換模式也無法自動補齊缺少的參數。
剛匯入新設定檔時,先查看 Rule 中的策略名稱是否與既有伺服器選擇相符,再檢查 FINAL 的處理方式。一次只修改一處,並保留原始檔案以供比對。若只有 Config 模式下失敗,可優先檢查 DNS、規則順序與引用資源,而不是立即刪除所有伺服器資料。
03 / Connectivity Test
開啟連線並驗證實際請求
回到 Home 開啟連線開關,首次使用時依系統提示允許新增連線設定。執行 Connectivity Test 後,還需要開啟實際要使用的網站或應用程式,檢查內容能否正常載入。測試結果與實際服務請求並不完全相同,不能只看開關狀態就判斷所有設定正確。
若連線失敗,依「目前網路 → 伺服器參數 → Global Routing → Config 與 DNS」的順序檢查。若只有一個網站異常,記錄網域和發生時間,再查看請求比對到的策略。分別測試 Wi-Fi 與行動網路,完成後再啟用 On Demand;回報問題時請隱藏訂閱憑證、密碼與個人位址。
設定入口的閱讀順序: 不熟悉介面用詞時先查術語手冊 ,需要操作路徑時查教學 ,需要逐項了解 DNS、Ping、Log、Widget、iCloud 或 Proxy 連接埠時,請參閱Settings 設定參考 。介面項目可能隨系統與應用程式版本而變動,操作前請以裝置目前顯示為準。
依目前需求選擇文章:尚未取得應用程式,先核對商店資訊;已能連線,再閱讀協定參數;準備更換裝置,先製作可還原的備份。文章僅說明用戶端操作與使用者既有資料,不提供連線服務。
正版購買
從搜尋結果進入產品頁,依序檢查開發者、官方圖示與 App ID,再確認商店帳號和付款資訊。iPhone / iPad $2.99 一次性購買;Mac、Windows、Android、Linux 免費。適合首次取得應用程式,以及重新安裝前核對購買記錄的使用者。
閱讀購買步驟 →
協定參考
區分本機金鑰、對端公鑰與路由範圍,依既有設定資料核對參數來源。範例用於理解欄位,不是可直接使用的連線資料;填寫前請確認自己的伺服器支援相應協定,避免填錯不同端的金鑰欄位。
閱讀參數說明 →
進階設定
分別說明 iCloud 同步與手動匯出 Config 的用途。移轉前記錄目前使用的伺服器和模式,移轉後重新確認系統權限、目前設定檔與 On Demand;先測試還原結果,再清理舊裝置和備份檔案。
閱讀移轉步驟 →