Shadowrocket 官方手冊
Shadowrocket
使用說明與設定詳解
iOS / iPadOS 規則代理用戶端,App Store 正版,一次買斷。先準備好現有設定,再依步驟連線。
On Demand 與 DNS 設定參考
規則、設定與連線策略
伺服器資訊決定連線目的地,Config 決定如何分配請求,Settings 則控制連線與診斷行為。分開檢查三者,比一次修改多個開關更容易找出問題。
規則分流:DOMAIN-SUFFIX / GEOIP / FINAL
規則用來將不同請求交由指定策略處理。在 Config 中確認目前啟用的設定,再確認 Global Routing 使用 Config,規則才會參與分流。DOMAIN-SUFFIX 依網域後綴比對,GEOIP 依 IP 位址所屬區域比對,FINAL 則接手先前未符合任何規則的請求。規則通常依序判斷,較具體的條件應放在兜底條件之前。修改後請儲存並確認實際套用的策略;不要只因連線開關已開啟,就認定分流正確。
閱讀選項手冊On Demand:依條件觸發連線
On Demand 可依設定條件觸發系統 VPN 連線,但不保證伺服器可用。先在 Home 手動連線,確認現有設定有效,再前往 Settings 檢查 On Demand 相關選項。設定前先釐清希望在哪些網路條件下連線,避免將自動連線與規則分流混為一談。前者決定何時建立連線,後者決定請求交由哪項策略處理。若要完全停止測試,也請檢查此設定,避免系統之後依條件重新建立連線。
查看 On DemandSubscribe:匯入現有訂閱
訂閱可將使用者現有的多筆伺服器資訊匯入用戶端,之後更新可取得該訂閱提供的內容變更。匯入前請確認連結完整,特別留意複製時是否帶入空格、換行或失效參數。透過 Add Server 選擇 Subscribe,依 App 內欄位填寫並儲存,再檢查返回的項目是否符合預期。成功取得訂閱清單,不代表每台伺服器都能連線;還需選取特定項目進行測試。訂閱網址可能含有存取憑證,請勿放入公開截圖或記錄檔。
查看匯入步驟Config:分清設定檔與伺服器項目
Config 檔案可包含 General、Rule、Hosts 等設定,與 Home 中的伺服器項目屬於不同層級。準備修改設定前,先保留可用副本,並確認目前選取的檔案。匯入其他設定後,請檢查其中的規則與策略參照,確認參照名稱能對應到現有項目;檔案成功匯入,不代表所需項目都已備妥。每次只修改一個目標項目,儲存後再驗證相關請求的行為。如此一來若發生問題,就能明確還原到哪份設定,而不必反覆重建所有設定。
查看設定檔與選項說明Global Routing:Config / Proxy / Direct
Global Routing 決定目前採用哪種整體處理方式。Config 依目前設定中的規則分配請求;Proxy 讓請求使用代理策略;Direct 則直接連線。需要規則分流時,先確認此處選擇 Config,再檢查相關規則。排查時可暫時切換模式,比較同一目標在不同方式下的結果;測試完成後,請恢復預期設定。切換模式不會自動修正錯誤的位址、驗證資訊或 DNS,也不能據此證明所有 App 請求都走相同路徑。
查看模式選擇步驟多種協定:參數須與現有伺服器一致
Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等協定。進入 Add Server 後,先依現有伺服器資料選擇 Type,再填寫相應欄位。不同協定所需的驗證與傳輸參數各不相同,不能將某種類型的密碼或 UUID 直接當成另一種類型的設定。位址與連接埠正確,也不代表 TLS、SNI 或傳輸層設定無誤。請優先完整匯入本人現有的設定;若必須手動填寫,請逐項對照原始資料,不要靠反覆切換 Type 猜測。
查看協定概念Ping / Log / Data:分別檢視不同問題
Connectivity Test 與 Ping 可協助檢查連線是否可達,但測試結果不能取代實際請求驗證。連線失敗時,先記下測試方式,再查看 Log 中的錯誤線索;DNS、驗證與握手問題應分別處理。Data 用於查看 App 記錄的流量統計,不能取代連線服務的計費紀錄。判斷異常時請留意統計範圍與時間,勿將累積歷史數值當成目前速度。分享排查資訊前,請遮蔽訂閱網址、驗證參數及可能洩露存取紀錄的內容。
查看 Log 排查參考iCloud:同步前先確認備份範圍
iCloud 同步適合在自己的裝置間延續設定,但 App 購買紀錄與設定資料是兩種不同的還原項目。換機前先檢查 App 內的同步選項與系統 iCloud 狀態,並為重要設定另行備份;不要預設所有本機紀錄都會同步。新裝置還原後,請核對伺服器項目、目前的 Config 與 Global Routing,再實際測試一次連線。若新舊裝置的內容不一致,先確認哪一份才是預期副本,避免未核對就覆蓋仍可使用的設定。
查看 iCloud 設定參考Config 與 Log 參考入口
iPhone 與 iPad 取得說明
先在商店確認正版,再依裝置完成購買或還原。系統需求與購買適用範圍以 App Store 頁面標示為準,裝置上實際顯示的商店資訊才是操作依據。
iPhone
前往 App Store 產品頁核對開發者與 App ID,購買後開啟 Shadowrocket。首次建立連線時,請依系統提示確認新增 VPN 設定;此授權是連線所需的系統步驟,不會自動補上伺服器參數。
查看 iPhone 取得步驟 →iPad
同一 Apple ID 的已購紀錄可用來尋找 App;iPhone 與 iPad 的購買適用範圍以 App Store 頁面標示為準。重新取得 App 後仍須核對本機設定,不能將購買紀錄還原視為訂閱與規則也已還原。
查看 iPad 取得步驟 →Mac / Apple TV 也可透過同一個 App Store 取得;相容性、系統需求與購買適用範圍以 App Store 頁面標示為準。
使用現有設定快速入門
開始前,請準備本人有權使用的訂閱連結或伺服器資訊。以下步驟依序處理輸入、設定路由,最後驗證結果;購買 App 不代表已備妥連線設定。
-
新增伺服器或匯入 Subscribe
在 Home 開啟 Add Server,依現有資料選擇 Type。使用訂閱時選擇 Subscribe,並完整貼上連結;手動填寫時逐項核對位址、連接埠、驗證與傳輸設定。儲存後返回清單,確認項目已出現,並選取這次要測試的伺服器。若清單為空,請先檢查訂閱取得結果,不要直接進行連線測試。
Scan QR Code 可用來讀取本人現有設定的 QR Code。識別後仍應核對類型與內容,尤其要確認 QR Code 來源可信。不要在不了解設定作用時覆蓋原有可用設定,也不要公開轉傳含有驗證參數的 QR Code。
-
選擇 Config、Proxy 或 Direct
需要規則分流時選擇 Config,並檢查目前啟用的 Config 檔案。Proxy 與 Direct 可用來比較不同處理方式,但不是伺服器清單中的其他連線。初次使用時,應先釐清測試目的:確認伺服器是否可用,還是確認某條規則是否符合。兩種測試需要觀察不同資訊,不宜混為一談。
若匯入的設定參照了特定策略名稱,請確認有對應的項目。只複製規則文字,卻未補齊策略參照,可能導致結果不符預期。DOMAIN-SUFFIX、FINAL 與 DIRECT 的意義,可分別在概念速查中閱讀。
-
開啟連線開關並驗證實際請求
開啟 Home 的連線開關,依系統提示確認 VPN 設定授權,再使用 Connectivity Test 協助檢查。接著存取這次要驗證的目標,並核對 Log 中的處理線索。連線狀態、測試結果與目標存取結果屬於不同層面的資訊:開關已開啟只代表連線流程已啟動,不能單獨證明規則與解析都正確。
失敗時先記錄現象,再依序檢查伺服器參數、驗證、DNS 與規則比對結果。每次只修改一項,並重複相同測試,記錄結果是否改變。Data 顯示有流量也不能取代存取驗證;流量增加與目標請求成功並非同一結論。
開發者、圖示與 App ID
Shadowrocket 是閉源商業 App。辨識正版應依據 App Store 產品頁上可核對的資訊,而非相似名稱、搜尋排序或未經查證的介紹。
先核對產品頁,再確認購買
開啟商店產品頁後,先確認名稱為 Shadowrocket,再查核開發者是否為 Shadow Launch Technology Limited,並將圖示與本站使用的官方圖示比對。產品連結末尾的 id932747118 即為 App ID。請一併核對這三項資訊;只看名稱相似或圖示配色相近,無法確認是否為正版。本網站的下載說明頁集中列出這些核對項目,方便購買前逐項確認。
一次買斷的是用戶端使用權
美國商店價格約為 2.99 美元,一次付費;各店面會以當地貨幣顯示,實際成交價格以 App Store 頁面及購買確認畫面為準。買斷用戶端 ≠ 連線服務方案。App 購買與連線服務彼此獨立,首次開啟後仍須匯入使用者現有的訂閱或伺服器資訊。本網站是官網與官方手冊,不提供、販售或推薦節點與訂閱,僅說明如何匯入、設定及排除現有設定的問題。
已購紀錄與本機設定分開還原
iPhone 與 iPad 可透過相應 Apple ID 的已購紀錄尋找 App,具體購買適用範圍以 App Store 頁面標示為準。換機或重新安裝時,先確認商店登入的是原購買帳號,再查看已購項目;若頁面顯示價格而非重新取得選項,請先檢查帳號與店面,不要急著重複購買。成功重新取得 App 後,還須另外確認設定備份、iCloud 狀態與現有訂閱是否已還原;購買本身不會建立伺服器資訊。
商店顯示與帳號地區
產品是否會顯示於目前店面,取決於 App Store 的實際展示內容與帳號地區。若搜尋不到,請先透過正版產品頁確認入口,再查看目前帳號的國家或地區及商店提示。若需變更帳號地區,請先閱讀裝置中 Apple 帳號的相關說明,並處理餘額、訂閱及付款方式等條件。網頁能開啟不代表目前帳號一定能完成購買,請以商店內的購買流程為準。
更新、系統需求與設定檢查
Shadowrocket 一律透過 App Store 取得與更新。是否啟用自動更新,可在裝置系統的 App Store 設定中查看;系統需求以 App Store 頁面標示為準。更新後若選項位置與手冊範例不同,請先依介面上的英文名稱尋找對應項目,再檢查目前設定與連線結果。修改重要設定前保留副本,比依靠記憶重新填寫參數更容易還原。
若要繼續核對購買紀錄,可閱讀已購項目還原說明;若已能開啟 App 但尚未連線,請前往首次連線教學。若不確定 Subscribe 與 Config 的差異,請先查閱概念速查,避免將更新訂閱清單與替換規則檔案當成同一項操作。
參數填寫、首次連線與遷移
以下文章著重於用戶端操作。先確認問題屬於協定參數、購買與連線,還是設定還原,再閱讀對應步驟;連線資料仍應以使用者現有的伺服器資訊為準。
Trojan 協定科普:在 Shadowrocket 新增 Trojan 節點的參數填寫要點
介紹 Trojan 的運作方式,逐項說明位址、連接埠、密碼、SNI 與 Allow Insecure 的填寫注意事項。參數應與現有伺服器資料相符,不要以放寬憑證檢查取代正確設定。
備份遷移Shadowrocket 設定備份與換機還原:iCloud 同步及設定檔匯出
整理 iCloud 同步、Config 匯出與匯入的檢查順序,並區分已購 App 還原與設定還原。遷移前確認要保留的副本,遷移後核對伺服器、規則與實際連線結果。
入門指南小火箭新手常見問題十問:從 App Store 購買到首次連線
集中解答正版辨識、一次買斷、訂閱匯入與 Global Routing 選擇等問題。依購買、準備設定、連線及驗證的順序閱讀;遇到失敗時,先判斷問題所在的層級。