官方手冊 / 首次連線
Shadowrocket 使用說明
本教學以 iPhone / iPad 介面為例。從手邊已有的伺服器或訂閱開始,依序完成匯入、路由選擇、連線和驗證。若已成功匯入,可直接前往 Global Routing。
新增伺服器或匯入 Subscribe
先確認手邊的資料。若已有協定、主機名稱、連接埠及相應的登入資料,請選擇手動新增;若已有服務提供者給的訂閱網址,請選擇 Subscribe。訂閱網址和伺服器主機名稱用途不同,請勿將整段訂閱連結填入 Host,也不要把單一伺服器網址當成訂閱。選擇其中一種方式即可開始,不必重複匯入同一項目。
手動填寫 Add Server
開啟 Home,在 SERVER 區域找到 Add Server。進入表單後先點選 Type,依已知資料選擇協定。協定會決定後續顯示的欄位。以 Shadowsocks 為例,Host 填入伺服器主機名稱或 IP,Port 填入連接埠號碼,Password 填入相應密碼,Method 與伺服器端設定保持一致。請勿將示意圖中的欄位組合視為其他協定的通用表單;切換 Type 後,依實際顯示的欄位和服務提供者提供的資料填寫。
儲存前請再次核對,特別確認 Host 是否包含網址路徑、連接埠是否抄錯、密碼前後是否多了空格。若已有用於分享單一伺服器的 QR Code,可在 Add Server 中使用 Scan QR Code;掃描後先核對辨識出的 Type 和重要欄位,再儲存。掃描成功只表示內容已辨識,不代表伺服器可用。
使用 Subscribe 匯入現有連結
從 Home 進入 Add Server,在 Type 中選擇 Subscribe,將服務提供者給的完整連結貼到訂閱網址欄位,保留查詢參數,不要截掉尾端內容。儲存後回到 Home,找到對應的訂閱群組,確認更新後確實出現可選項目。如果只看到群組名稱、沒有伺服器,請先排查訂閱取得或解析問題,不要繼續更改路由模式。看到項目後,選定這次要使用的伺服器並記住名稱,後續測試時要核對的就是這個項目。
選擇 Global Routing
回到 Home,點選 Global Routing,確認目前的路由模式。選取伺服器是指定可用的代理出口;選擇路由模式則是決定如何處理請求。兩者不能互相取代:清單中選取了伺服器,不代表每個請求都會經由它傳送。
- 設定(Config):依目前生效的設定檔比對規則。需要依目標分流時使用此模式;請求可能走 PROXY,也可能走 DIRECT,取決於最先命中的規則。
- 代理(Proxy):不依設定檔中的分流規則逐條選擇策略。若要先確認選定的伺服器能否處理代理請求,可暫時使用此模式進行對照。
- 直連(Direct):請求不會經由選定的伺服器轉送。適合用來比對同一個目標在目前網路下能否直接存取;這不等於關閉 Home 的連線開關。
選擇設定(Config)後,切換至 Config 查看目前使用的設定檔,並在編輯頁找到 Rule。請勿混淆此編輯頁與 Home 中的 Global Routing:前者決定比對條件與策略,後者決定是否採用這些規則。規則依序檢查,符合第一條後即停止。以下片段僅用來說明順序,不必取代現有設定:
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
在此範例中,docs.example.com 先符合第一條,走 DIRECT;另一個子網域如 www.example.com 才會符合第二條。如果將兩條規則對調,範圍較廣的後綴規則就會先涵蓋 docs.example.com。先前規則都未符合的請求則由 FINAL 作為後備。只進行首次連線時,先保留原設定,不必更動 General、Hosts 或 URL Rewrite。需要修改比對條件時,請先備份,再參閱規則手冊。
開啟 Home 連線開關
確認路由模式後回到 Home,在 SERVER 下確認選取的是剛才準備使用的伺服器。如果訂閱中有名稱相近的項目,請先開啟詳細資料核對,不要只憑名稱猜測。接著開啟 Home 頂端 Not Connected 旁的開關。首次執行時,iOS 或 iPadOS 可能會提示新增 VPN 設定;確認提示是由剛才的 Shadowrocket 操作觸發後,允許新增並依照系統提示完成驗證。
處理完系統提示後回到 Home,等待狀態穩定,再確認開關仍保持開啟。如果剛開啟就跳回,請勿連續點擊或同時更換伺服器。先檢查系統提示是否已完成、裝置是否已有其他 VPN 連線,或裝置管理政策是否限制建立連線。受管理裝置應先向管理員確認限制,不要為了測試移除管理設定。
開關保持開啟表示本機連線已建立,不代表遠端伺服器、目標網站和每條分流規則都正常。首次測試時,請固定目前的網路、選定的伺服器和路由模式。即使之後存取失敗,也能分辨問題出在本機連線階段,或是請求進入連線後未如預期完成。
使用 Connectivity Test 和實際存取進行驗證
先回到 Home,點選 Connectivity Test,查看目前選定伺服器的測試結果。若同時出現多個項目的結果,請依名稱找到剛才選取的那一列。測試正常只表示該項目在目前測試條件下有收到回應,不能取代瀏覽器或目標 App 的實際存取;測試失敗也需要配合測試方式判斷,不能直接認定所有存取都會失敗。
接著開啟一個自己有權限存取、平時結果明確的頁面。手動重新載入,確認不是直接看到瀏覽器快取;必要時另開一個頁面再次檢查。若使用設定(Config),可以各選一個預期走 DIRECT 和 PROXY 的目標,記錄目標實際使用的主機名稱。不要只記頁面上顯示的網站名稱:網頁重新導向後可能已進入另一個主機名稱,而頁面中的圖片、指令碼或介面也可能來自不同網域。
如果能查看請求記錄,請依時間和主機名稱找出這次存取對應的請求,並對照記錄中顯示的策略和 Config 中的規則;沒有可用記錄時,回到 Rule 依原順序手動核對。先查看目標是否符合較前面的精確規則或後綴規則,再確認是否落到 FINAL。僅憑頁面能開啟,無法證明它使用了預期的策略。
需要進行對照時,請在相同網路下存取同一目標,一次只更改 Global Routing,測試後恢復原模式。如果代理(Proxy)下可存取、設定(Config)下失敗,請優先檢查規則和目前的設定檔;如果兩者都失敗,再檢查伺服器參數和目前網路。不要直接比較多個不同網站的結果,也不必為了驗證一次連線就永久切換模式。
在 Settings 排查常見問題
先判斷問題發生在哪個階段:清單中沒有可選項目,是匯入問題;頂端開關無法保持開啟,先檢查系統連線;開關穩定但測試或存取失敗,再區分出口、測試條件和規則。依這三個階段的順序排查,可避免同時弄亂正在使用的設定。
訂閱更新後沒有項目
確認 Type 是 Subscribe,並從自己的服務提供者所提供的原始資料重新複製完整網址。如果網址包含查詢參數,問號後方的內容也要保留。網址無誤但群組仍是空的時,請向服務提供者確認連結是否仍有效,以及回傳格式是否適用於 Shadowrocket。不要把完整網址貼到公開的解析工具,也不要先刪除仍可使用的群組。
連線後測試逾時,或只有特定目標失敗
進入 Settings,查看 Test Method,確認兩次對照使用相同的測試方式。如果目前的伺服器一再逾時,先檢查裝置本身能否連上網路,再比較已知可用的網路,並回到 Add Server 核對 Type、Host、Port 和協定要求的參數。如果只有特定目標失敗,請依驗證步驟重新比對同一目標的模式,再檢查網域是否符合 REJECT 或進入與預期不同的策略。
切換網路後連線狀態改變
在 Settings 查看 On Demand 是否已啟用。啟用時,網路變更可能觸發重新連線或中斷;測試時先記下目前條件,避免將隨選連線行為誤判為伺服器故障。仍無法判斷時,開啟 Diagnostics,記錄問題發生時間、連線網路、模式和介面中的錯誤提示。需要提供排查資訊時,請先遮蔽伺服器登入資料、訂閱網址及不宜公開的存取記錄。每次變更一個項目後回到 Home 重新測試,修復後恢復暫時更動的設定。