官方手冊 · 入門指南

Shadowrocket
匯入訂閱與首次連線

依五個步驟完成新增、模式選擇、連線與驗證。先建立可供檢查的連線,再調整規則與自動連線條件。

01 · Add Server:新增伺服器或匯入訂閱

開啟 Shadowrocket 後,先停留在 Home,不必急著開啟連線開關。確認手上的資料是哪一種:完整的訂閱連結,或包含伺服器位址、連接埠、協定與驗證內容的一組參數。兩種方式擇一即可,不必將同一組資料匯入兩次。如果資料不完整,請先向你的服務商確認,不能只根據協定名稱猜測缺少的欄位。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角加號,進入 Add Server。點選 Type,從類型清單中選擇 Subscribe,再將完整的既有訂閱連結貼到 URL。可在 Remark 填寫方便辨識的名稱,例如「日常使用」,接著點選右上角的儲存按鈕。返回 Home 後,等待讀取訂閱完成,再查看對應群組下是否出現伺服器項目。群組名稱出現,不代表內容已成功讀取,還要確認群組內確實有項目。

貼上前後都應確認連結的開頭、結尾與查詢參數。聊天文字中的換行、末尾標點,或複製時遺漏的字元,都可能導致讀取失敗。訂閱網址通常包含個人存取憑證,請勿公開完整網址,也不要將它放入公開截圖。如果服務商提供的是供瀏覽的管理頁面,而不是訂閱網址,請先向你的服務商取得正確連結。

既有訂閱內容有變更時,在 Home 找到對應的訂閱群組,使用更新功能,再確認項目是否有變化。不要一開始就反覆刪除並重新新增;先查看更新是否出錯,確認本機網路可用,再檢查服務商端的訂閱狀態。更新訂閱是取得清單,後續的連線測試才是檢查所選伺服器,兩者並非同一件事。

已有伺服器參數:依 Type 逐項填寫

若要手動新增,同樣從 Home 的加號進入 Add Server,先選擇與資料相符的 Type,例如 Shadowsocks、VMess、VLESS 或 Trojan。接著填寫 Address、Port 及該類型要求的驗證欄位。伺服器位址只填寫資料指定的位址,不要任意加上網頁路徑;完整填入連接埠,避免將訂閱管理頁面的連接埠誤當成代理服務連接埠。

涉及 TLS、傳輸方式、Host、SNI 或路徑時,應逐項依原始資料確認。伺服器位址與 TLS 使用的名稱可能不同,不能為了看起來一致就自行替換。儲存後返回 Home,確認新項目名稱容易辨識,並選取準備測試的項目。此時只完成資料輸入,尚未驗證遠端是否可連線。如果不理解不同類型的欄位,請先查閱概念速查,不要不斷切換 Type 碰運氣。

02 · Global Routing:選擇處理方式

準備好清單後,在 Home 點選 Global Routing,選擇接下來要如何處理連線。這裡的三種模式為:配置(Config)、代理(Proxy)、直連(Direct)。Global Routing 決定處理方式;Home 中選取的伺服器則決定需要代理時使用哪個連線入口。只選取伺服器,並不能取代模式選擇。

配置(Config):依目前配置處理

配置(Config)會依目前配置檔中的規則與策略處理請求,適用於已有明確分流需求的情況。切換前先前往底部的 Config,確認目前選取的配置檔。不能只憑檔名判斷內容,也不要假設匯入伺服器訂閱時會同時附帶符合需求的規則配置。訂閱提供伺服器資訊,Config 負責連線處理邏輯,兩部分需要分別確認。

規則通常依序比對,前面的具體規則與後面的 FINAL 會影響最後採用的策略。如果規則引用了策略名稱,還需要確認該名稱存在,且指向符合預期的項目。初次使用時,先保留一份用途明確且自己看得懂的配置,不要同時加入大量規則並修改 DNS。此處先完成選取與確認,詳細關鍵字請參閱規則關鍵字與配置概念。

代理(Proxy):檢查代理路徑

代理(Proxy)可用於排查時比對代理路徑,減少規則分流對觀察結果的干擾。先選取準備測試的伺服器,再切換到代理(Proxy),使用同一個目標進行驗證。這不表示所有類型的系統流量都必然採用完全相同的路徑,也無法讓失效的伺服器恢復可用。比對完成後,如果原本需要規則分流,應切回配置(Config)。

直連(Direct):建立本機網路基準

直連(Direct)用於比對不經代理的連線,可先判斷本機網路本身能否連線至某個目標。這不等同於關閉系統 VPN 配置:連線開關開啟時,系統仍可能顯示 VPN 狀態。因此,若要完全結束這次用戶端連線,請返回 Home 關閉頂部開關,而不是只將 Global Routing 改為直連(Direct)。選好模式後,再進行下一步的授權與連線。

03 · Home:開啟開關並完成授權

返回 Home,確認伺服器選取狀態與 Global Routing 是否符合剛才的選擇,再開啟頂部連線開關。首次建立連線時,系統會提示新增 VPN 配置。確認這是由目前操作觸發後,依提示允許,並在系統驗證畫面完成裝置密碼或生物辨識驗證,再返回 Shadowrocket。裝置密碼只能輸入系統驗證畫面,不應填入伺服器驗證欄位。

如果之前取消過授權,可以再次開啟開關以重新啟動流程。若裝置受組織管理,相關限制可能導致無法新增 VPN 配置;此時應查看裝置管理規定,不要接連修改伺服器參數。連線授權處理的是用戶端能否使用系統網路延伸功能,伺服器參數處理的是能否建立遠端連線,兩個環節應分開判斷。

完成授權後,等待 Home 的連線狀態穩定,再開啟需要使用的 App。系統出現 VPN 標示,通常代表本機連線配置已啟用,但不代表所選伺服器一定能正常傳輸,也不代表目前規則一定符合預期。不要把「開關保持開啟」當成最後驗收,下一步還需要使用 Connectivity Test 並檢查實際連線。

首次驗證時,建議先使用手動開關,不必急著設定 On Demand。如果同時啟用了其他 VPN 連線,應先確認是否有配置衝突,並在可控的條件下逐一測試。要結束這次測試時,請在 Home 關閉開關;如果關閉後自動重新連線,再檢查 On Demand 的觸發條件,避免將自動連線誤認為開關沒有生效。

04 · Connectivity Test:驗證實際連線

連線驗證分為三個層次:Home 是否維持預期的連線狀態、Connectivity Test 是否有回應,以及實際需要使用的網頁或 App 是否正常。三項應分別觀察。單次測試顯示有回應,只能表示該次測試在當時條件下得到結果,不能直接代表持續下載速度、所有目標都可使用,或後續連線穩定。

  1. 在 Home 使用 Connectivity Test,先查看目前所選伺服器的結果。如果清單中有多個項目,不要因為另一個項目顯示有回應,就認定目前選取的項目也可使用。
  2. 開啟平時熟悉且目前網路應可連線的頁面,確認基本連線正常;再測試實際需要使用的目標,記錄是完全無法開啟、部分內容失敗,還是載入緩慢。
  3. 使用配置(Config)時,搭配連線記錄或日誌檢查該目標採用的規則與策略。系統 VPN 標示本身無法證明某個目標已經透過代理連線。
  4. 需要比對時,在同一網路、同一伺服器與同一目標下,分別測試代理(Proxy)與配置(Config)。每次只改變一個條件,完成後恢復日常使用方式。

網頁快取與既有的長連線會影響觀察。切換模式後,可以重新載入頁面或重新建立 App 連線,再比較結果。不要只憑頁面某個元素是否改變來判斷分流;有些服務會同時連線至多個網域,其中一個請求成功,不代表所有請求都採用相同策略。也不需要為了驗證首次連線而修改整份配置。

如果直連基準、代理路徑與規則路徑都已檢查,實際目標仍然失敗,請記錄失敗時間、目前網路類型、所選伺服器與錯誤提示。記錄是為了還原當時條件,不必包含訂閱網址、密碼或其他驗證資訊。測試通過後,保留這組可正常運作的選擇,之後再逐項調整 Config 或 On Demand,發生變化時便能回到已知狀態。

05 · 常見問題:從最早出現異常處開始檢查

排查順序應與操作順序一致:先確認清單,再確認測試結果,接著檢查授權與實際連線,最後檢查規則。每次只修改一項並立即重新測試,同時記下結果。不要同時更換伺服器、切換網路、匯入配置與調整 DNS,否則即使問題排除,也難以確認是哪個步驟起了作用。

訂閱群組已出現,但伺服器清單為空

先檢查 Subscribe 的 URL 是否完整,是否誤填登入頁面或複製到多餘空格,再嘗試更新對應訂閱。如果更新出現錯誤提示,請保留提示文字,並確認裝置目前能正常連線。連結過期、服務商回傳內容變更或訂閱狀態異常,都需要向你的服務商確認;只修改 Remark 不會改變回傳內容。既有項目仍可使用時,也不要在確認原因前大量刪除。

Connectivity Test 逾時或結果不穩定

先用直連確認本機網路可用,再比對另一個既有伺服器項目。如果所有項目都異常,檢查目前網路、裝置時間與最近修改的配置;如果只有一個項目異常,優先確認該伺服器狀態及 Address、Port、驗證與傳輸參數。延遲結果會受到測試方式與當時網路影響,不應只依單一數值判斷是否可用。

開關已開啟,但目標仍無法開啟

先確認 Global Routing。如果目前是直連(Direct),即使選取了伺服器,目標也不會自動透過代理連線。如果代理(Proxy)可以連線,但配置(Config)失敗,應前往 Config 檢查規則比對、策略名稱與 DNS 設定,而不是立刻重新購買或重新安裝用戶端。如果兩者都失敗,請回頭檢查伺服器參數、本機網路與遠端服務是否可用。

部分頁面可用,部分內容持續失敗

先判斷是否只影響特定網域或 App,再檢查相關請求的規則與策略。單一頁面可能需要連線至多個網域,局部失敗不一定代表整體連線中斷。保留目前可用的狀態,只調整與問題目標相關的一項設定;涉及 DNS、規則順序或協定欄位意義時,請先查閱概念速查再修改,避免用整份替換掩蓋實際原因。

關閉後重新連線,或切換網路後狀況改變

關閉後自動重新連線時,先前往 Settings 確認 On Demand,再檢查系統中的 VPN 配置狀態。切換 Wi-Fi 與行動網路後出現異常,則分別建立直連基準,並重新測試同一台伺服器;網路變更可能使原有連線失效,需要重新建立。不要只為了維持開關狀態而忽略實際連線結果。完成首次連線後,再依日常使用情境決定是否啟用自動連線。

如果仍需向服務商說明問題,只提供必要的錯誤提示、協定類型、網路條件與重新測試結果;完整訂閱網址與驗證資訊應妥善保密。關於 App Store 取得、已購項目復原與商店地區的問題,請前往取得指南處理,不要與連線參數排查混在一起。