iPhone
在 App Store 核對正版後購買,或還原已購項目。首次建立連線時,請閱讀系統顯示的 VPN 設定授權提示,再返回 Home 確認連線狀態;安裝完成不代表伺服器資訊已準備就緒。
前往 iPhone 說明CONFIGURATION / 01
先確認輸入的資訊,再決定如何處理流量。協定、伺服器、設定檔與系統 VPN 授權各自處理不同問題,不能以其中一項成功取代整體連線測試。
在 Home 將 Global Routing 設為 Config 後,請求會依目前設定中的 Rule 順序比對。進入 Config,先確認正在使用的檔案,再查看網域規則、位址範圍規則與 FINAL 的位置。較具體的規則通常應排在較廣泛的規則之前,避免先符合其他項目。以下僅示範規則語法,並非完整設定;PROXY 的實際出口仍須配合所選伺服器確認。儲存後請重新連線,並測試目標請求。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
On Demand 可依系統條件觸發連線,應先確認手動連線正常,再啟用此功能。進入 Settings 查看 On Demand,並確認系統中仍保留 Shadowrocket 的 VPN 設定。調整條件後,請在預期的網路環境中分別測試連線是否建立,以及中斷後是否再次觸發。若連線反覆恢復,先檢查按需條件,不要連續刪除設定。以下規則片段是流量策略範例,不能取代 On Demand 的觸發設定。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Shadowrocket 支援 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等協定。手動新增時,在 Add Server 選擇相符的 Type,再依使用者現有資訊填寫位址、連接埠與驗證欄位。請逐項核對 TLS、SNI 與傳輸參數,不能只因連接埠相同就認定設定相同。匯入後仍須確認協定類型正確;規則只負責選擇處理策略,不會自動修正伺服器驗證或傳輸設定。下方片段示範如何將請求交由代理策略處理。
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECT
使用現有訂閱時,先確認連結提供的是伺服器清單還是設定檔,不要將兩種內容視為同一個入口。進入 Config 查看 Subscribe 相關入口,依現有連結的內容類型匯入;單一伺服器也可透過 Add Server、掃描 QR Code 或從剪貼簿辨識新增。匯入後核對名稱、Type 與伺服器數量是否符合預期,再選一項進行測試。更新失敗時,先確認原連結是否仍可連線;規則片段不包含訂閱網址或驗證資訊。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
Config 檔案可包含 General、Rule、Hosts 等內容;檔案存在不代表目前已選取使用。修改前先記下目前檔名並保留原始內容,每次只調整一項設定。使用 iCloud 同步時,請分別確認兩台裝置上的檔案是否已同步到位,以及目前選取的檔案是否一致;同步完成不代表連線參數完全相同。儲存後回到 Home,確認 Global Routing 設為 Config。以下為局部範例,複製前請先對照原始檔案,避免重複新增相同區段。
[General]
dns-server = system
[Rule]
FINAL,PROXY
在 Home 使用 Connectivity Test 檢查伺服器回應,再搭配實際連線情況判斷問題;測試有回應,不代表所有目標請求都成功。進入 Settings 的 Diagnostics 查看相關資訊,並透過 Data 觀察流量變化,留意統計範圍與記錄時間。若只有特定網域連線失敗,優先核對解析結果與符合的規則;若所有連線都失敗,再檢查網路、伺服器與授權。下方片段說明網域例外規則應放在 FINAL 之前,修改後請重新測試相同目標。
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
Config(設定檔)依選取的設定檔處理請求,適合測試規則分流;Proxy(代理)將主要流量交由代理策略處理,可用來比對規則的影響;Direct(直連)使用直接連線路徑。切換模式後,請重新測試相同目標,才能比較差異。測試結束後應恢復原本需要的模式,不要長期保留臨時排查狀態。
伺服器項目決定「連線到哪裡」,設定檔決定「如何處理請求」,系統授權則決定「是否允許建立 VPN 連線」。無法連線時,先判斷問題所在層級,再調整對應設定。若同時更換伺服器、DNS 與整份設定檔,結果將難以重現,也容易抹去真正的故障線索。完整欄位說明請見名詞解釋,各項功能說明請見功能頁面。
DEVICES / 02
兩種裝置都透過同一個 App Store 產品頁核對。購買帳號、相容性與目前選取的設定檔須分別確認,不能以另一台裝置的連線結果取代本機檢查。
在 App Store 核對正版後購買,或還原已購項目。首次建立連線時,請閱讀系統顯示的 VPN 設定授權提示,再返回 Home 確認連線狀態;安裝完成不代表伺服器資訊已準備就緒。
前往 iPhone 說明Mac / Apple TV 也可透過同一個 App Store 取得;裝置相容性、系統需求與通用購買範圍,請以 App Store 頁面標示為準。
跨裝置使用時,先確認 App Store 中用來購買的帳號,而不只是查看系統頂端的 iCloud 帳號。兩處的登入狀態可能不同。還原應用程式後,再確認設定檔是否已同步、伺服器是否已選取,以及切換網路後連線是否正常。應用程式購買紀錄與使用者現有的伺服器驗證資訊是不同項目;還原其中一項不會自動補齊另一項。
FIRST CONNECTION / 03
01 / IMPORT
準備使用者現有的伺服器參數或訂閱連結。單筆資訊可在 Add Server 填寫;現有連結則依內容類型選擇匯入入口。完成後檢查 Type、位址、連接埠與驗證欄位,確認不只是儲存了名稱。
02 / ROUTING
需要規則分流時選擇 Config,並確認目前使用的設定檔。Proxy 與 Direct 可用來比對測試,但不能取代伺服器參數檢查。開始測試前先記下原本的模式,避免排查結束後忘記還原。
03 / VERIFY
在 Home 開啟連線開關,依系統提示允許加入 VPN 設定。接著執行 Connectivity Test,再嘗試連線至實際需要的目標。分別記錄開關狀態、測試結果與實際連線情況,不要只看單一指標。
選擇明確的目標,在相同網路下重複連線。若開關維持開啟但頁面無法載入,先確認目前的伺服器與 Global Routing;若只有部分網域異常,再檢查 DNS 與 Rule。若開關立即跳回關閉,應優先檢查系統 VPN 授權與設定,而非反覆修改分流規則。若網路切換、裝置進入睡眠或重新開啟應用程式後出現症狀,也請記錄觸發條件。
不要將 Connectivity Test 的結果視為實際傳輸速度。測試方式、目標與目前網路都會影響結果;「伺服器有回應」、「網域可解析」與「目標請求成功」是三種不同的結論。發生異常時,保留必要的錯誤資訊,並遮蔽訂閱網址、密碼與驗證欄位。依症狀逐步檢查的流程請見連線故障排除手冊。
APP STORE / 04
Shadowrocket 是閉源商業應用程式,唯一取得管道為 App Store。核對時應以產品頁列出的開發者資訊、購買條件與相容性為準,不能只憑搜尋結果中的名稱判斷。
932747118開啟產品頁後,先確認應用程式名稱為 Shadowrocket,再查看開發者或提供者資訊中的 Shadow Launch Technology Limited,並比對官方圖示。產品頁網址結尾應為 id932747118。請一併核對名稱、圖示與身分資訊;不要因搜尋結果排名靠前,或名稱包含「小火箭」,就略過產品頁檢查。
進入產品頁後,可進一步查看相容性、應用程式說明與商店更新紀錄。系統需求請以 App Store 頁面標示為準,本文不固定列出系統版本。若系統提示裝置不相容,請返回產品頁查看相應裝置資訊,不要因另一台裝置能安裝,就推定本機也符合需求。詳細核對步驟請見正版核對說明。
App Store 顯示的內容會依目前商店帳號的 Apple ID 地區而異。搜尋不到 Shadowrocket 時,先開啟 App Store 帳號頁確認目前登入的帳號,再到相關帳號設定中核對國家或地區。中國大陸商店的搜尋結果可能與其他地區不同;網頁上能查看產品資訊,也不代表目前帳號一定可以購買。
若打算調整帳號地區,請先閱讀帳號頁列出的條件,並確認餘額、有效訂閱與付款方式等事項。尚未確認帳號狀態前,不要連續更改設定。地區與搜尋顯示的說明請參閱Apple ID 地區與商店顯示核對;本文僅說明核對方式,不提供帳號服務。
買斷用戶端 ≠ 購買線路方案。美國 App Store 參考價格為 $2.99,應用程式採一次性購買;實際金額、稅費與當地貨幣顯示方式,請以 App Store 結帳頁面為準。購買的是 Shadowrocket 用戶端,不會因此取得可用的伺服器或訂閱。後續設定一律以使用者已有的訂閱或伺服器資訊為前提。
本站為官方網站與官方手冊,不提供、不銷售,也不推薦任何節點或訂閱。應用程式購買問題請在 App Store 帳號與訂單中確認;現有伺服器的位址、驗證欄位、可用狀態與服務效期,則依使用者自己的原始資訊檢查。兩類問題應分開記錄,避免將訂閱失效誤判為應用程式購買失敗,或將安裝完成誤認為連線所需條件已備妥。
在 iPhone 與 iPad 間使用時,先以原購買帳號登入 App Store,再從已購項目中尋找 Shadowrocket。兩種裝置的通用購買範圍請以 App Store 頁面標示為準。若顯示價格而非重新下載選項,請先檢查帳號、購買紀錄與產品身分,不要立即再次付款。從裝置移除應用程式,不代表購買紀錄也已消失。
重新下載只能還原應用程式本身,不能據此認定原有設定已完整還原。首次開啟後,請檢查伺服器項目、目前的 Config 與系統 VPN 授權;使用 iCloud 時,也要確認同步狀態與本機實際選取的項目。更新由 App Store 管理;更新後若出現異常,先記錄變更與症狀,再逐項測試,不要直接清除所有設定。詳細步驟請見已購項目還原說明。
READING / 05
依目前遇到的問題選擇文章:參數錯誤先檢查欄位,授權異常先檢查系統設定,搜尋不到應用程式先檢查商店帳號。文章中的介面用語保留英文,方便對照裝置上的選項。
對照 Add Server 中的位址、連接埠、密碼與 SNI,分辨伺服器驗證和 TLS 憑證驗證。遇到握手異常時先檢查參數,不要把停用驗證當作一般處理方式。
閱讀參數說明說明首次開啟連線開關時的系統授權、VPN 設定的查看位置,以及設定遭刪除後如何重新確認。先確認系統權限,再檢查規則與伺服器。
閱讀授權說明從 App Store 目前登入的帳號開始,核對國家或地區與產品頁是否顯示;說明調整地區前應確認的帳號條件,避免將搜尋結果誤認為裝置相容性的判斷依據。
閱讀商店說明