OFFICIAL MANUAL / GETTING STARTED

Shadowrocket 使用教學:
匯入、連線與驗證

以 iPhone / iPad 介面為例,依五個步驟完成首次連線。先確認資料完整,再調整規則;每個步驟都留下可檢查的結果。

Subscribe Global Routing Connectivity Test

閱讀順序:首次設定請從頭開始;已能連線但只有個別請求異常,可直接查看驗證與排錯步驟。截圖用於辨識介面,裝置上的欄位請以實際顯示為準。

STEP 01 / ADD SERVER

新增伺服器或匯入 Subscribe 訂閱

訂閱是更新一組伺服器資料的入口;單一伺服器則需要逐項填寫。選擇其中一種方式即可,不必重複新增相同資料。

已有訂閱連結:選擇 Subscribe

開啟底部的 Home,在 SERVER 區域找到 Add Server,或點選右上角的新增入口,進入 Add Server。點選 Type 查看類型清單,選擇 Subscribe,再將向服務商取得的完整訂閱連結填入 URL。名稱僅供自己辨識,可依用途命名;真正決定能否取得內容的是 URL,而非名稱。

貼上後先檢查開頭、結尾與中間是否有多餘空格或換行。有些連結包含查詢參數,這些內容也是網址的一部分,請勿只複製網域,也不要刪除看起來較長的尾端內容。儲存後返回 Home,等待訂閱內容載入,再展開對應群組檢查是否出現伺服器項目。若 App 提示取得失敗,請先檢查連結或目前網路,不要反覆新增同名訂閱。

已有單一伺服器:依 Type 填寫欄位

同樣從 Add Server 進入,但 Type 必須選擇資料中指定的協定,而非 Subscribe。接著填入 Host、Port,以及該協定要求的 Password、Method 或其他驗證欄位。請勿根據截圖猜測參數:不同 Type 顯示的欄位各不相同,截圖中出現某個欄位,不代表所有協定都需要填寫。TLS、SNI 等附加項目也應與服務商提供的資料一致。

如果已有可用的 QR Code,可以使用 Scan QR Code 讀取後再核對;Import from Cloud JSON 僅適用於已持有對應格式資料的情況。請勿將一般訂閱連結隨意放入不相符的匯入入口。手動輸入完成後先儲存,再返回 SERVER 查看項目;後續連線使用的是這裡儲存的伺服器,而非尚未提交的編輯頁面內容。

此步驟的完成標準是:Home 中出現可選取的伺服器,開啟項目後能看到預期的類型與位址。訂閱群組名稱出現但沒有任何伺服器,仍不能進入連線驗證。欄位含義不清楚時可查閱術語表,取得失敗的處理方式請見疑難排解。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 與底部匯入入口
Add Server:先選擇 Type,再填寫對應欄位。截圖中的欄位組合不代表你的伺服器參數。
STEP 02 / GLOBAL ROUTING

選擇 Global Routing 模式

伺服器決定連線到哪裡,Global Routing 則決定如何處理請求。兩者是不同設定,選好伺服器後仍需檢查分流模式。

先區分設定(Config)、代理(Proxy)、直連(Direct)

返回 Home,點選 Global Routing 開啟選項。設定(Config)依目前設定檔中的規則決定請求策略;代理(Proxy)會讓可接管的請求經由代理路徑處理,適合短時間進行對照測試;直連(Direct)則經由直連路徑處理,因此即使頂端開關已開啟,也不代表請求一定會經過所選伺服器。三種模式不是速度檔位,也不會修正錯誤的驗證資料。

準備依規則使用時,先選擇設定(Config),再開啟底部的 Config,確認已選取需要的設定檔。若有多個檔案,匯入新檔不代表它已成為目前設定,必須確認實際選取狀態。進入檔案編輯頁可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段;首次連線不需要逐項修改,也不必啟用所有功能。

檢查規則順序,不要一次修改整份設定

Rule 中的規則通常依序比對,具體條件應排在兜底條件之前。以下僅用於理解語法:example.com 及其子網域符合 PROXY,指定的區域網路網段符合 DIRECT,其餘請求由 FINAL 處理。實際設定中的策略名稱必須存在;只有規則文字、沒有對應策略時,不能據此判斷連線已準備完成。請勿為了照抄範例而取代整份現有設定。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

如果還不確定問題來自伺服器還是規則,可以先記下原本模式,暫時切換至代理(Proxy),完成後續連線與驗證,再切回設定(Config)進行比對。代理(Proxy)可以連線、設定(Config)卻失敗時,才值得優先檢查規則與策略;兩者都失敗時,應先檢查伺服器與基本網路。首次設定期間請縮小修改範圍,避免同時更換訂閱、設定與 DNS,導致結果難以比較。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段與 Add Rule
Config 檔案編輯頁:此步驟主要確認設定檔已選取,並了解 Rule 的用途,不必修改所有區段。
STEP 03 / HOME

選取預設伺服器,開啟連線開關

先選擇實際要使用的伺服器,再開啟開關。進入項目編輯頁與選取預設伺服器是兩個不同動作。

在 SERVER 中確認選取項目

從 Config 返回 Home,在 SERVER 群組中找到剛才匯入的伺服器,點選該項目左側的圓點,確認選取標記移到目標項目。若點選名稱後進入編輯頁面,請先返回清單,再檢查選取狀態。訂閱中有多個伺服器時,這次先固定一個進行驗證,避免每次測試前都更換伺服器,讓錯誤現象失去比較依據。

再次查看 Home 的 Global Routing,確認與上一步的計畫一致,再開啟頂端的連線開關。首次使用時,系統可能詢問是否允許新增 VPN 設定;閱讀提示,確認操作來自 Shadowrocket 後允許,並依系統要求完成裝置驗證。若取消授權,伺服器項目仍會保留,但這次操作無法建立連線。之後重試時應重新檢查授權結果,而非重新輸入所有伺服器資料。

連線狀態是第一項檢查,不是最終結論

返回 Home,查看頂端是否仍顯示 Not Connected,或已切換為連線狀態。如果開關剛開啟就關閉,請先停止連續重試,記下提示文字,並查看系統是否有其他正在執行的 VPN 連線。首次排錯期間請保留單一連線來源,避免兩個設定互相接管。請勿透過刪除不熟悉的系統設定來嘗試解決問題;受管理的裝置也可能受到管理員限制。

開關保持開啟只代表 App 已進入連線工作狀態,不能單憑這個狀態判斷遠端驗證、網域解析與實際目標存取都已成功。此時請勿立即啟用 On Demand,也不要將自動觸發失敗視為伺服器故障。先維持手動連線,依下一步執行測試並存取目標 App;手動連線驗證成功後,再考慮自動連線條件。

需要停止時,返回 Home 關閉頂端開關,並確認狀態已恢復。日後切換伺服器或修改重要參數,建議先中斷連線、儲存變更,再重新連線並測試。如此較容易確認新設定何時開始生效,也能避免將既有連線的結果誤認為新參數的結果。

Shadowrocket Home 官方截圖,顯示頂端 Not Connected 開關、Global Routing、Connectivity Test,以及 SERVER 與 Add Server
Home:依序檢查 SERVER 選取項目、Global Routing 與頂端連線狀態,再執行 Connectivity Test。
STEP 04 / CONNECTIVITY TEST

驗證是否生效:測試與實際請求

依「App 狀態 → 測試請求 → 目標 App」的順序檢查,避免將單次測試結果擴大解讀為整條連線的結論。

執行 Connectivity Test

維持剛才選定的伺服器與連線狀態,在 Home 點選 Connectivity Test,等待本次測試完成。先確認是否出現明確的成功或失敗結果,不必比較不同伺服器的數值。測試會受到方法、目標與目前網路影響;測試請求成功,代表本次測試經過的路徑可用,不代表每個 App、每個網域都會使用相同路徑。

如果測試失敗,先確認目前是否處於直連(Direct),以及選取的伺服器是否符合預期。必要時到 Settings 查看 Test Method,記下原本的選擇後再比較。請勿只為取得成功結果而不斷切換方法;更重要的是將目前方法、網路與實際存取結果相互對照。

發出一次新的實際請求

開啟需要使用的 App 或頁面,主動重新整理或發出新請求。已開啟的頁面、快取內容與既有連線都不適合用來證明新設定已生效。返回 Shadowrocket,在 Data 中查看與本次操作時間相符的記錄;若有規則與策略資訊,請核對目標請求實際符合了什麼,而不只是查看開關是否亮起。

「測試通過但目標 App 失敗」與「測試、目標 App 都失敗」是兩種不同問題。前者優先檢查目標請求的規則、DNS 與 App 行為;後者先檢查伺服器、驗證資料與目前網路。頁面可以開啟,也不能單獨證明它經過代理,因為設定(Config)可能依規則將目標交給 DIRECT。

STEP 05 / SETTINGS & DIAGNOSTICS

依故障環節排查,一次只改一項

先分辨匯入失敗、連線失敗與請求失敗。它們發生在不同階段,不必使用相同的處理方式。

先確認基本網路,再檢查匯入結果

關閉連線後,先確認裝置本身能正常存取原本可用的網路資源。若基本網路無法使用,請優先處理 Wi-Fi 登入、行動數據權限或網路中斷。無法取得訂閱時,核對 URL 是否完整,以及服務商提供的訂閱是否仍有效;請勿將訂閱連結當作搜尋關鍵字提交,也不要公開傳送給他人。匯入階段尚未取得伺服器清單時,切換 Global Routing 通常無法解決取得問題。

分別處理開關關閉與連線後逾時

開關立即關閉時,優先檢查系統 VPN 授權、其他 VPN 的連線狀態,以及是否有裝置管理限制。開關維持開啟但請求逾時,則核對目前伺服器的 Host、Port、Type 與驗證欄位,特別留意複製貼上時帶入的空格。若服務商提供多種連線資料,請勿將一組資料的位址與另一組資料的驗證欄位混在一起。修正並儲存後重新連線,再使用相同的測試方式驗證。

只有部分請求異常:回頭檢查 Config

如果在代理(Proxy)下可用、設定(Config)下不可用,請返回 Config 檢查實際選取的檔案,再查看失敗請求符合的規則與策略。留意範圍過廣的 DOMAIN-KEYWORD、過早出現的兜底規則,以及策略引用是否指向預期伺服器。先保留原設定副本,修改一項後重新發出請求;請勿為了解決單一目標,而長期將所有請求固定為另一種模式。

維持手動連線,再使用 Diagnostics

在 Settings 中檢查 On Demand。首次排錯時先關閉自動觸發,維持手動連線,避免 Wi-Fi 或網路切換導致狀態變化而被誤判為隨機斷線。手動連線穩定後,再單獨設定 On Demand 並驗證每個觸發條件。Test Method 用於了解測試結果,Diagnostics 用於收集診斷線索;沒有明確原因時,不應一次修改 Proxy、TCP、UDP 等多項設定。

需要繼續排查時,記錄錯誤原文、出錯步驟、網路類型、Global Routing 模式,以及是否每台伺服器都出現相同現象。分享 Diagnostics 或 Data 資訊前,請先隱藏訂閱連結、驗證內容及不必要的存取記錄。常見現象的後續處理方式請見疑難排解;介面詞與規則關鍵字請見術語表。若問題涉及 App Store 顯示、購買或已購項目復原,請閱讀正版指南,不必重新調整連線參數。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:排錯時優先記錄 Test Method、On Demand 與 Diagnostics,暫不批次更改其他選項。