官方手冊 · 首次連線
Shadowrocket 使用教學
先將現有連線資料新增至 Home,再決定請求要依規則處理、統一走代理,還是直接存取。開啟開關後,透過一次伺服器測試和一次實際存取確認結果,不要只把開關狀態當成驗證結論。
開始前:確認已安裝 Shadowrocket,並備有自己的訂閱連結或伺服器資料。iPhone / iPad 版可從 App Store 產品頁取得,$2.99 一次性付費,系統需求以 App Store 頁面標示為準;Mac / Windows / Android / Linux 版免費,請從客戶端下載頁安裝。本教學以 iPhone / iPad 介面為例。
客戶端一次買斷 ≠ 線路方案。本網站不提供、銷售或推薦節點與訂閱。訂閱連結可能包含存取憑證,只需在客戶端內填寫,請勿將完整連結發布到公開頁面或貼入排查紀錄。
01 / 匯入
Add Server 或 Subscribe:匯入現有連線資料
開啟 Shadowrocket,進入底部的 Home,點選右上角的加號進入 Add Server。若手邊只有一組伺服器參數,請新增單一伺服器;若取得的是用於同步伺服器清單的訂閱連結,請使用 Subscribe。兩種方式擇一即可,不必為了匯入同一組連線資料分別操作兩次。
在 Add Server 中填寫單一伺服器
先選擇與現有參數相符的協定,再填入伺服器位址、連接埠及該協定要求的驗證資料。不同協定顯示的欄位不盡相同,不能將某個協定的驗證資料照搬到另一個協定。若參數另有指定傳輸或 TLS 設定,也要與原始資料相符。位址和連接埠分開填寫時,請勿將兩者連同冒號一起貼到位址欄位。儲存前特別檢查複製時是否多帶了空格、換行或引號。
儲存後回到 Home,在 SERVER 清單中找到剛新增的項目。若清單中有名稱相似的舊項目,請先查看內容,確認位址和協定與這次新增的資料相符,再選取該項目。項目出現只代表資料已儲存,尚未驗證遠端伺服器是否可連線。
在 Subscribe 中匯入現有訂閱
在 Add Server 的類型選項中選擇 Subscribe,再將完整訂閱連結貼到連結欄位並儲存。若連結包含查詢參數,請保持原樣,不要只複製網域,也不要將連結當成伺服器位址填入單一項目。回到 Home 等待取得完成,確認訂閱下方是否出現可選的伺服器項目,而不只是查看是否新增了訂閱名稱。若已有相同訂閱,請先更新原項目,不必再建立同名副本。
無論採用哪種方式,繼續前都要在 Home 選定一個用於測試的伺服器。後續切換 Global Routing 或檢查存取時,先保留這項選擇,這樣測試結果改變時才容易判斷是模式變了,還是伺服器本身有問題。
02 / 分流
Global Routing:選擇流量處理方式
在 Home 點選 Global Routing,依照今天要驗證的目標選擇模式。這裡決定的是請求如何傳送,不會更改剛才儲存的伺服器參數。第一次驗證代理路徑時,可暫時選擇代理(Proxy)以減少規則條件;日常需要讓不同請求依各自策略處理時,再使用設定(Config)。直連(Direct)可作為對照,但無法證明代理伺服器可用。
- 設定(Config)
- 依目前設定中的規則處理請求。先進入底部的 Config,確認實際啟用的是準備使用的設定,而不是只確認檔案出現在清單中。測試某個網域時,從規則前段往後查看可能優先符合的條件;若沒有相符條件,再看
FINAL指向的預設策略。
- 代理(Proxy)
- 將客戶端接管的請求交由代理處理,不逐條依目前設定進行日常分流。適合確認選定的伺服器能否支援實際存取。測試通過後若切回設定(Config),還要再測一次具代表性的頁面,因為兩種模式的請求路徑可能不同。
- 直連(Direct)
- 讓請求直接存取目的位址,不經所選代理伺服器。遇到無法開啟的頁面時,可用它檢查目前 Wi‑Fi 或行動網路下的基本存取狀況。直連成功表示這次請求有直接存取路徑,不代表分流規則正確。
選好後回到 Home,核對 Global Routing 欄位目前的值。請注意,底部的 Config 是管理設定檔的入口,Global Routing 中的 Config 則是啟用規則處理的模式:只開啟設定檔清單,不代表流量處理方式已改變。
03 / 連線
Home:開啟連線開關
在 Home 核對目前的伺服器和 Global Routing,接著開啟連線開關。首次開啟時,系統可能會顯示新增 VPN 設定的要求。這是為了讓 Shadowrocket 依選定方式處理裝置流量。確認此要求是由剛才的操作觸發後,點選系統彈出視窗中的「允許」,並依提示完成裝置驗證。若先前已完成授權,不一定會再次看到此視窗。
完成後回到 Home,查看開關短暫等待後是否維持開啟。若開關立刻跳回關閉,先不要反覆點選,也不必立刻刪除訂閱。檢查是否有忽略的系統視窗,或裝置上是否有另一個 VPN 連線正在執行。若裝置由公司或學校管理,請先確認是否允許變更網路設定,不要自行移除管理描述檔。若開關仍然跳回關閉,請直接前往常見失敗情況檢查授權與連線狀態。
開關維持開啟表示系統連線已建立,但不代表伺服器一定有回應、每個網站都能存取,或每條規則都符合預期策略。現在保持網路、伺服器和模式不變,進入下一步驗證。若先前設定過 On Demand,請留意它是否會在切換網路時自動重新連線,以免將不同條件下的兩次結果當成同一次測試。
04 / 驗證
Connectivity Test:檢查伺服器與實際存取
先在 Home 找到 Connectivity Test 並執行,等待結果更新,再查看剛才選定的伺服器是否傳回測試結果。回應時間只反映當時的測試條件,不等於實際存取速度;單次逾時也不足以判定伺服器長期無法使用。記錄是否有回應或逾時即可,不必分享伺服器位址、驗證欄位或訂閱連結。
接著開啟瀏覽器,重新載入先前確認能存取的頁面。不要只查看已開啟的分頁:分頁可能仍顯示連線前載入的內容。測試前後盡量使用相同網路和位址。若使用代理(Proxy)測試且頁面能正常重新載入,表示這次實際存取成功;若 Connectivity Test 有回應但頁面載入失敗,就要分別檢查目標網站、網域解析或目前的請求路徑,不要把兩種結果視為矛盾。
若要驗證設定(Config)下的分流,先找一個依設定預期走 DIRECT 的網域,再找一個預期使用代理策略的網域,分別重新載入。若可使用客戶端診斷紀錄,再依網域和請求時間核對實際使用的策略。頁面能開啟並不能單獨證明符合指定規則;網頁也可能同時請求其他網域,因此應依具體請求核對,而不只查看網址列中的主網域。
完成標準:連線開關能維持開啟,選定的伺服器在測試條件下有回應,實際頁面能重新載入。若要驗證分流,還應確認具代表性的請求使用了預期策略。完成對照後,將 Global Routing 切回日常所需的模式,並再次存取測試頁面。
05 / 排查
常見失敗情況:從最早出錯的步驟開始排查
先確認問題最早出現在哪裡:清單沒有項目、開關無法維持開啟、Connectivity Test 逾時,還是只有部分頁面載入失敗。從最早出錯的位置開始處理,不要一次同時更換網路、伺服器和設定。每次修改一項,就用相同的測試動作重新檢查;否則即使恢復存取,也很難知道是哪項修改發揮了作用。
訂閱已儲存,但沒有可選伺服器
回到 Home 查看訂閱是否已取得並展開,先更新一次現有訂閱。沒有項目時,檢查裝置目前是否能連上網路、連結是否複製完整或已失效,以及取得的內容是否確實供 Subscribe 使用。若儲存單一伺服器後找不到項目,請回到 Add Server 核對必要欄位,不要將同一組參數再次貼到 Subscribe。修正後先確認 SERVER 清單中有可選項目,再回到流量處理方式繼續。
開關跳回關閉,或未出現預期的授權提示
先確認系統視窗是否已被拒絕,或是否已有其他 VPN 正在連線。在裝置的「設定 → 一般 → VPN 與裝置管理」中查看 VPN 狀態;系統選單可能因版本略有不同,也可在設定中搜尋 VPN。確認沒有衝突後,返回 Shadowrocket 再開啟一次。若是受管理裝置且無法更改設定,請向裝置管理員確認限制,不要透過清除客戶端資料來處理系統端問題。
開關能開啟,但伺服器測試總是逾時
先關閉連線,確認裝置在目前網路下能正常存取常用頁面。若基本存取也失敗,例如公共 Wi‑Fi 尚未完成登入,應先恢復網路再重新測試。基本網路正常時,核對伺服器協定、位址、連接埠及對應設定。若已有其他可用項目,可在相同網路下只更換一個伺服器進行對照,並保留其他設定。這樣可以縮小問題範圍,但不能只憑一次對照就斷定服務端故障。
代理測試通過,但設定模式下部分頁面失敗
在相同網路下,以相同頁面分別測試代理(Proxy)和設定(Config)。若只有設定(Config)下出錯,先查看目前啟用的檔案,再檢查故障網域是否符合更前面的規則。沒有符合規則時,檢查 FINAL。一個頁面可能會從不同網域載入圖片或傳送登入請求;正文能顯示但部分內容失敗時,要分別核對這些請求,不要只根據主網域的策略就修改整份設定。
排查紀錄只需保留問題發生在哪一步、目前的模式、使用 Wi‑Fi 或行動網路,以及問題是否能重現。若遇到系統版本、商店顯示或換機復原問題,請改查取得指南,不必透過重新匯入訂閱處理購買或安裝問題。