官方手冊 / 入門指南

Shadowrocket 訂閱匯入與首次連線

依序完成匯入、選擇路由、連線與驗證。先確認一次完整連線正常,再調整規則與自動連線設定。

建議先閱讀完整流程,再依步驟在裝置上操作。介面文字保留英文;不同裝置的排列方式可能略有不同,請依欄位名稱確認,不要只憑畫面位置判斷。

步驟 1 / 準備可連線項目

Add Server 與 Subscribe:匯入現有資料

開啟 Shadowrocket,先停留在 Home。這裡可查看伺服器清單、選取目前使用的伺服器及控制連線。初次使用時,清單中可能還沒有可選項目;此時先不要開啟連線開關。確認手邊資料是訂閱連結,還是單一伺服器的獨立參數;兩者的入口相近,但填寫方式不同。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的加號進入 Add Server,開啟 Type 並選擇 Subscribe。將自己的完整訂閱連結貼到 URL,確認開頭、路徑與結尾參數無誤後儲存。連結中的驗證參數也是網址的一部分;少複製一個字元、帶入換行,或連同說明文字一起貼上,都可能導致取得失敗。備註可填寫自己容易辨識的名稱,避免直接使用完整連結。

儲存後返回 Home,等待取得訂閱內容,再確認是否出現對應的群組與伺服器項目。看到訂閱名稱不代表伺服器清單已成功載入;請展開或查看該群組,確認其中確實有可選項目。若內容仍是空白,請先排查訂閱取得問題,不要反覆新增同名訂閱。若已有伺服器項目,請選取其中一個作為接下來的測試對象。

訂閱連結通常包含存取憑證,請只保存在自己需要使用的裝置與可信任的備份中。向他人說明問題時,描述錯誤現象即可,請勿傳送完整連結。訂閱更新、多個訂閱的整理,以及刪除後的影響,另見伺服器管理手冊;本頁先完成一次匯入,不調整自動更新策略。

已有單一伺服器資料:依協定填寫

若資料包含伺服器位址、連接埠與驗證資訊,同樣從 Add Server 開始,在 Type 選擇資料明確標示的協定,再逐項填寫。不要因名稱相近就更換協定,也不要把整段網頁網址填入伺服器位址欄位。請分別確認位址與連接埠;密碼、使用者識別資訊及協定要求的其他選項,都應與原始資料一致。

不同協定顯示的欄位各不相同。例如,部分連線還需要確認 TLS、Server Name 或傳輸設定,這些選項不能憑猜測填寫。若原始資料未提供必要參數,請先確認資料內容,不要連續嘗試多種組合。填寫完成後儲存,返回 Home 查看項目名稱並選取該項;需要修改時,重新進入該項目的編輯頁面,盡量避免重複新增相同紀錄。

若已有相容的 QR Code,可使用 Scan QR Code 掃描;辨識成功後仍須檢查產生的伺服器欄位。螢幕截圖、QR Code 與分享連結都可能包含驗證資訊,不適合作為公開的排查資料。本步驟的完成標準是:Home 中有一個來源明確、參數已確認且已選取的伺服器,而不只是儲存了訂閱名稱。

步驟 2 / 確認流量處理方式

Global Routing:選擇合適的模式

選取伺服器後,在 Home 開啟 Global Routing。這裡用來決定流量的處理方式,不會補上伺服器參數。初次使用時,請先確認目前選項再測試網頁;否則即使連線成功,也可能無法判斷請求是經由所選伺服器,還是直接連線。三種模式分別是配置 (Config)、代理 (Proxy) 與直連 (Direct),不要與底部的頁面分頁混淆。

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

配置 (Config) 會依目前生效設定中的規則決定流量去向。若要使用分流,請先前往 Config 確認選取的是自己準備使用、且了解其來源與用途的設定,再返回 Home 選擇 Config。僅匯入訂閱不代表同時匯入了符合預期的規則;訂閱中的伺服器清單與 Config 中的設定檔用途不同。

規則有比對順序,也可能將部分請求設為 DIRECT,因此在 Config 模式下能開啟某個網頁,不足以單獨證明代理連線正常。首次連線後,請搭配請求紀錄確認實際採用的策略。若尚未準備好規則設定,可先使用下一種模式排除規則影響,確認伺服器本身可用,再回頭檢查設定。

代理 (Proxy):先檢查所選伺服器

首次排查時,可暫時使用代理 (Proxy) 檢查所選伺服器的代理連線路徑,減少規則選擇造成的干擾。此模式仍仰賴正確的伺服器參數、可用的本地網路與伺服器端狀態,也不保證所有 App 的請求結果都相同。測試期間請記住原本的選項,驗證後切回日常使用的 Config,避免長期保留臨時排查設定。

直連 (Direct):作為本地網路對照

直連 (Direct) 會直接連線,不透過所選伺服器。可用來與代理連線結果對照,判斷本地網路原本是否能連線至目標。選擇 Direct 後,不要只因開關已開啟就認定伺服器連線成功。選好後返回 Home,再次確認所選伺服器,接著完成系統授權並連線。

步驟 3 / 建立裝置連線

開啟連線開關並完成系統授權

返回 Home,確認目前伺服器與 Global Routing 和前兩步的選擇一致,再開啟頂端的連線開關。初次連線時,系統可能會提示新增 VPN 設定;這是允許客戶端建立網路通道的授權步驟。請閱讀提示中的 App 名稱,確認操作是由剛開啟的 Shadowrocket 發起,再依系統指示允許,並完成裝置要求的驗證。

完成授權後返回 Home,確認開關是否維持開啟,以及頁面是否顯示已連線。系統的 VPN 標示可供參考,但不同裝置的顯示位置可能不同;不必為了尋找固定位置的圖示而反覆操作。更重要的是客戶端連線狀態是否穩定,以及下一步的實際連線是否成功。

若先前取消授權,請返回客戶端再次發起連線,並依系統提示操作。若系統仍未顯示預期提示,可到裝置的 Settings 檢查 VPN 相關設定與管理限制。若裝置受管理,請依管理規範處理,不要任意刪除不熟悉的設定。系統授權尚未完成前,無須急著更換伺服器協定。

若開關剛開啟就自行關閉,請記錄是否出現錯誤提示,並確認伺服器仍已選取、必要欄位均已填妥,以及裝置是否有其他正在使用的 VPN 連線。此時不必快速反覆切換開關;請先關閉連線,確認一個項目後再試。反覆快速連線會讓排查紀錄混亂,也無法判斷是哪項變更造成結果。

首次驗證期間請維持目前的網路,不要先啟用 On Demand,以免網路條件觸發的自動操作干擾判斷。若需要依條件自動連線,請等手動連線與網頁瀏覽都正常後再設定。完成本步驟僅表示裝置已嘗試建立通道,仍須透過下方的實際請求確認是否可正常使用。

步驟 4 / 確認實際連線

Connectivity Test 與網頁驗證

保持連線開啟,在 Home 使用 Connectivity Test,確認所選伺服器是否回傳測試結果。這項測試適合快速篩查明顯無法連線的項目,但測試目標與瀏覽器實際瀏覽的目標不一定相同。測試有數值只表示該次測試收到回應,不能據此判定所有網頁都正常,也不能用來評估日常瀏覽速度。

接著開啟瀏覽器,重新載入一個自己熟悉、能確認內容是否更新的網頁,再以另一個平常使用的頁面作對照。請優先送出新的請求,不要只查看已開啟的分頁,因為舊頁面可能來自快取。若要驗證特定目標,請使用相同目標比較修改前後的結果,避免將不同網站的回應差異誤認為設定變更的影響。

返回 Shadowrocket,查看 Data 中的請求或流量紀錄,依照瀏覽發生時間找到對應請求。若目前版本提供相關詳細資訊,可檢查目標、命中的規則與使用的策略。在 Config 模式下看到 DIRECT 不一定是錯誤;若規則本來就要求該目標直連,這就是分流結果。反之,若預期透過代理卻記錄為 DIRECT,請先確認目前設定與規則,不要立即重新建立訂閱。

若要確認伺服器連線路徑,請先記下原有設定,再暫時切換到 Proxy,對同一個目標送出新的請求。若 Proxy 可以連線而 Config 不行,請優先檢查規則與設定;若兩者都失敗,再檢查伺服器參數、DNS 與本地網路。測試結束後請恢復原本的 Global Routing,不要同時保留多項臨時變更。

一次完整驗證可確認三件事:Home 的連線狀態維持穩定、網頁的新請求成功完成,以及請求紀錄符合所選模式。這三項比單看開關狀態更具參考價值。使用完畢後返回 Home 關閉連線;之後若切換到其他網路,請重新簡短驗證,不要直接套用先前的成功結果。

步驟 5 / 依問題現象縮小範圍

常見問題:每次只變更一個項目

遇到問題時,先確認卡在哪個步驟:無法取得訂閱、伺服器測試失敗、連線無法維持,或網頁無法開啟。不同情況要檢查的位置也不同。請先記錄目前網路、所選伺服器、Global Routing 與錯誤提示,再依下列順序排查。不要一開始就重新安裝 App,因為這無法修復失效的伺服器資料,還可能造成現有設定遺失。

訂閱已儲存,但清單是空的

回到訂閱編輯頁面,檢查 URL 是否完整,尤其確認結尾的驗證參數沒有遭到截斷。確認自己的訂閱仍有效,並檢查目前網路能否完成訂閱取得。訂閱存取與伺服器連線是兩個不同階段:舊的伺服器項目可以測試成功,不代表訂閱更新也一定成功。請先查看更新結果,再決定是否需要修改連結;不要將完整訂閱連結貼到公開討論區詢問。

Connectivity Test 失敗或連線立即中斷

先確認本地網路可正常使用,再檢查所選項目的位址、連接埠、協定與驗證欄位。若有 TLS 或傳輸選項,請逐項比對原始資料,特別留意複製時是否多了空格。如果自己還有其他伺服器,可在維持 Global Routing 不變的情況下,只切換伺服器作為對照。若只有一個項目失敗,先檢查該項;若所有項目都失敗,再檢查共通的網路條件與系統授權。

測試有結果,但網頁仍無法開啟

此時應釐清問題在 DNS 解析還是實際連線。若紀錄顯示解析失敗,請先確認目前設定是否指定了無法連線的 DNS,或是否有不符合目前網路條件的設定。不要為了測試一次新增多個 DNS 位址,也不要直接覆寫整份設定。若在 Proxy 模式下同一網頁可以開啟,但 Config 模式下不行,請進一步檢查該目標命中的規則、策略與相關解析設定。

切換網路後才發生異常

從 Wi-Fi 切換至行動網路後,本地網路路徑與可用條件可能有所不同。請維持相同伺服器與模式,重新連線並測試同一目標,記錄兩種網路的差異。若切回原網路後恢復正常,這項對照比連續更改協定更有參考價值。若已設定 On Demand,也請確認切換網路時是否觸發自動連線或中斷,避免將自動操作誤認為手動開關失效。

記錄結果,再逐步深入排查

每次變更後都重複相同測試;若沒有改善,請還原原值,再檢查下一項。若要進一步分析,可整理錯誤訊息、發生步驟與已確認的條件,但請遮蔽訂閱連結、密碼及驗證參數。常見現象說明請參閱疑難排解;訂閱更新、伺服器整理與備份方式請參閱伺服器管理手冊。完成本頁流程後,再逐步加入規則、自動更新與 On Demand 設定,後續會更容易定位問題。

前往 App Store