官方手冊 / 首次設定

Shadowrocket 訂閱匯入與首次連線

依照「新增 → 選擇路由 → 連線 → 驗證 → 排除問題」的順序操作。先完成一次可供檢查的連線,再調整規則與自動連線設定。

請先備妥完整連結或完整欄位,並暫時保持連線開關關閉。不要同時修改 DNS、規則與協定參數,否則發生問題時難以判斷是哪項變更造成。下方截圖僅供辨認頁面與欄位,畫面中的項目不是實際連線資料;介面細節請以裝置目前顯示為準。

01 · Add Server 新增伺服器與 Subscribe 訂閱匯入

開啟 Home 首頁,在 SERVER 伺服器群組附近找到 Add Server 新增伺服器入口。進入後先確認手邊資料的類型:用來更新伺服器清單的連結屬於訂閱;包含協定、位址、連接埠與驗證資料的一組參數,則適合手動填寫。依現有資料選擇其中一種方式即可,不必重複新增相同內容。

已有訂閱連結:確認完整後再儲存

在 Add Server 新增伺服器頁面點選 Type 類型,選擇 Subscribe 訂閱類型,再將連結貼到 URL 位址欄。貼上後從頭到尾檢查,確認沒有一併貼入說明文字、引號、換行或空格。連結中的查詢參數通常與存取權限有關,不要因為看不懂就刪除問號後的內容,也不要自行拼接缺漏部分。

填入方便自己辨識的名稱後,點選頁面上的儲存按鈕,返回 Home 首頁並等待匯入結果。確認是否出現對應的伺服器群組,以及群組內是否有可選項目。如果清單是空的,先停在此處檢查連結與更新結果;不要試圖切換 Global Routing 全域路由來解決清單空白,因為清單尚未成功取得。

已有伺服器參數:Type 決定後續欄位

手動新增時,先在 Type 類型中選擇與服務商提供資料相符的協定。官方截圖展示的填寫頁包含 Host、Port、Password、Method:Host 主機位址填入網域名稱或 IP,Port 連接埠填入指定連接埠,Password 密碼與 Method 加密方式必須逐項吻合。不要照抄截圖中的值,也不要套用其他協定的欄位。

選擇不同協定後,頁面欄位也會改變。例如 VLESS 需要核對 UUID 身分識別,以及服務商提供的傳輸與 TLS 參數;這些資料無法從位址與連接埠推算。缺少欄位時,應先核對現有資料,而不是反覆嘗試隨機組合。儲存後返回 Home 首頁,確認新增項目已顯示,再繼續下一步。

如果取得的是 QR Code,可使用 Scan QR Code 掃描 QR Code 入口,並在需要時允許相機存取。匯入後仍須核對協定、位址與連接埠。Import from Cloud JSON 從雲端 JSON 匯入是另一種匯入方式,不等同於一般訂閱位址欄。分享連結、從剪貼簿匯入與管理多個訂閱,請繼續閱讀訂閱與伺服器管理手冊。

Shadowrocket 的 Add Server 新增伺服器頁面,顯示 Type、Host、Port、Password、Method 與 QR Code 匯入入口
Add Server 新增伺服器:先選擇 Type 類型,再核對相應欄位。截圖中的欄位組合不適用於所有協定。

02 · Global Routing 選擇路由模式

已有可選伺服器後,返回 Home 首頁並點選 Global Routing 全域路由。這裡決定請求的處理方式,不負責取得訂閱,也無法修正伺服器密碼。首次使用時,先了解三種模式:設定 (Config)、代理 (Proxy)、直連 (Direct)。選好後返回首頁,確認 Global Routing 全域路由旁顯示的目前模式。

設定 (Config):依目前設定中的規則處理

設定 (Config) 會依目前啟用的設定檔比對規則,適合已備妥規則、希望區分不同請求去向的情況。底部的 Config 設定頁與 Global Routing 全域路由中的 Config 選項相關,但兩者不是同一項操作:前者用來管理與編輯設定,後者則決定是否依設定處理請求。只匯入伺服器清單,不代表也已匯入並選用合適的規則。

進入 Config 設定頁,確認目前使用的設定檔,再查看其中的 Rule 規則區段。官方截圖是設定編輯頁,可看到 General 一般設定、Rule 規則、Hosts 主機對應等區段,以及 Add Rule 新增規則入口。入門階段先確認現有內容即可,不必為了連線成功而修改 URL Rewrite 網址重寫或 HTTPS Decryption HTTPS 解密等進階設定。

代理 (Proxy) 與直連 (Direct):先了解用途

代理 (Proxy) 會讓通常受此路由模式控制的請求使用目前的代理伺服器,適合在初步排查時減少規則選擇帶來的變數,但不代表能絕對保證所有系統流量都如此處理。直連 (Direct) 則會讓請求以直連方式傳送;如果要確認代理伺服器能否支援瀏覽,保持在直連 (Direct) 就無法完成這項驗證。

已有可信且適用的設定時,選擇設定 (Config);只想先確認所選伺服器的基本連線時,可暫時使用代理 (Proxy),驗證後再切回設定 (Config)。記下切換前的模式,避免測試結束後忘記目前的設定。規則順序、策略與設定備份屬於後續內容,可在訂閱手冊繼續閱讀相關管理說明。

Shadowrocket 的 Config 設定編輯頁,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段與 Add Rule 入口
Config 設定編輯:規則位於 Rule 區段。Global Routing 全域路由模式須返回 Home 首頁選擇。

03 · 在 Home 選取伺服器並開啟連線

返回 Home 首頁,在 SERVER 伺服器群組中點選這次要測試的項目,確認已選取,再檢查 Global Routing 全域路由。清單中有伺服器不代表已選取伺服器,選取伺服器也不代表已開啟連線開關。這三種狀態須分開確認,尤其是剛匯入多個群組時。

點選頂端 Not Connected 未連線狀態旁的開關。首次建立連線時,系統可能會提示是否允許 Shadowrocket 新增 VPN 設定。這是授權系統建立相應網路設定的步驟,不是填寫訂閱資料的視窗。確認提示對應 Shadowrocket 後,依系統指示允許,並在系統要求時完成裝置驗證;請勿將裝置解鎖資料填入伺服器驗證欄位。

完成授權後返回 App,觀察頂端的連線狀態是否改變。如果開關隨即關閉,或系統授權尚未完成,先不要快速連續點按。確認剛才是否取消系統提示、是否還有待完成的驗證,再試一次。只看到系統 VPN 圖示或連線計時,也只能表示連線設定已啟動,不能據此斷定網頁一定能正常瀏覽。

如果先前已允許新增 VPN 設定,這次可能不會再次出現相同提示,這是授權流程上的正常差異。使用 iPad 時也依照「選取項目、確認路由、開啟開關」的順序操作;頁面配置可能因裝置顯示方式而不同,但要確認的狀態不變。接著維持目前的伺服器與模式,進入驗證步驟。

Shadowrocket 的 Home 首頁,頂端顯示 Not Connected 連線開關、Global Routing 與 Connectivity Test,下方為 SERVER 群組及 Add Server
Home 首頁:先選取 SERVER 伺服器群組中的項目,再操作頂端開關;Connectivity Test 連線測試供下一步檢查使用。

04 · Connectivity Test 與實際瀏覽驗證

先確認頂端的連線狀態,再點選 Home 首頁的 Connectivity Test 連線測試入口,查看目前測試的結果。測試結果反映的是特定測試方式下的回應,不是服務品質保證,也不能證明所有網頁都能開啟。即使顯示延遲數值,驗證、DNS 解析、規則選擇或目標網站仍可能各自有問題。

接著開啟瀏覽器,瀏覽平常使用且允許存取的網頁。先確認頁面是否完整載入,再開啟另一個不同網頁,避免只憑單一頁面的快取內容判斷。如果連線前已開啟頁面,重新載入後再觀察;只看到舊頁面內容,並不足以證明這次請求是透過目前的連線送出。

驗證時也要留意目前的路由模式。使用直連 (Direct) 時網頁能開啟,只能證明在該環境下可直連瀏覽;使用設定 (Config) 時,某個網頁能開啟,也不代表它一定套用了代理策略。若要進一步確認請求的去向,應參考目前的規則與可用的請求記錄,而不是只根據連線圖示或網頁速度推測。

如果結果符合預期,首次連線流程就完成了。現在可以停止測試並保留目前可用的設定,不必立刻調整所有選項。若要比較不同伺服器,每次只更換一個項目,並在相同路由模式與相近網路條件下重複測試。測試方式或目標不同,所得數值也不宜直接比較。

05 · Settings 設定與常見問題

發生問題時,先回想最後一個已確認成功的步驟:是否取得清單、是否選取伺服器、是否建立連線、實際瀏覽是否成功。依照這個順序定位,比同時重填欄位、更換設定與修改 DNS 更容易重現問題。每完成一項檢查,都回到同一個網頁重新驗證,每次只變更一個條件。

訂閱沒有項目:先檢查匯入過程

如果 SERVER 伺服器群組中沒有預期的項目,請檢查連結是否完整、是否填入 Subscribe 訂閱對應的 URL 位址欄,以及更新時裝置能否存取該位址。網頁版帳戶入口不一定是訂閱連結;出現登入頁面或說明頁面,也不代表用戶端已取得可解析的伺服器資料。連結有效性與服務狀態請向你的服務商確認,不要公開完整連結請他人代為查詢。

開啟開關後連線失敗:先檢查選取項目與驗證資料

確認已選取一部實際伺服器,再逐項比對 Type 類型、Host 主機位址、Port 連接埠與驗證欄位。手動輸入時尤其要留意相似字元、結尾空格、TLS 與傳輸參數。系統授權尚未完成時,先完成授權;欄位不完整時,先補齊資料。反覆切換開關無法取代這些必要條件。也請留意裝置上是否有其他正在使用的 VPN 連線,避免將切換連線誤認為本次連線已穩定建立。

測試有回應但網頁無法開啟:分別檢查解析與路由

先換一個平常瀏覽的網頁,區分是單一網站或普遍無法瀏覽,再確認 Global Routing 全域路由是否符合預期。進入 Settings 設定頁可查看 Test Method 測試方式;不同方式的檢查範圍不同,因此不能只靠一個延遲結果排除所有問題。需要使用 Diagnostics 診斷時,只查看與目前狀況相關的資訊,分享記錄前確認內容是否包含位址或驗證資料。

不要將 DNS 設定改成隨機位址,也不要略過憑證檢查來掩蓋驗證問題。關於「延遲正常但網頁無法開啟」、DNS 與規則比對的深入排查,請參閱常見問題;如果問題出在訂閱更新或管理多個群組,請前往訂閱手冊繼續檢查,不必在首次設定時一次處理所有進階選項。

關閉後又自動連線:檢查 On Demand 隨選連線

如果手動關閉後又觸發連線,請進入 Settings 設定頁檢查 On Demand 隨選連線是否已啟用,以及目前的條件是否會觸發連線。首次測試建議先確認手動連線的結果,再設定自動觸發行為。調整前記下原本狀態,避免為了解決自動連線而誤刪伺服器或設定檔。排除問題後,恢復所需設定,再重複「選取伺服器、開啟連線、驗證網頁」的完整流程。

最後,用戶端的連線設定與服務商提供的存取條件各有適用範圍。確認欄位相符、設定明確但問題仍持續時,請整理問題發生步驟、裝置網路環境與錯誤提示,再向你的服務商確認服務狀態。不要反覆刪除所有資料來取代問題定位;修改或刪除前,先備份需要保留的設定與連線資料。

Shadowrocket 的 Settings 設定頁,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP 設定入口
Settings 設定:排查問題時,重點確認 Test Method 測試方式、On Demand 隨選連線與 Diagnostics 診斷,每次只調整一項。