官方手冊 · 初次設定

Shadowrocket 使用指南

在 iPhone 或 iPad 完成伺服器匯入、分流選擇與連線驗證。第一次設定時,先用一筆既有伺服器資料跑完流程,再檢查具體規則。

01 匯入

在 Add Server 新增伺服器或訂閱

先確認手上的資料類型:訂閱連結用於匯入一組伺服器,之後也可以更新訂閱;單台伺服器資訊則對應一筆紀錄,通常包含協定、位址、連接埠和驗證參數。只需選擇其中一種方式,不必把同一條連結同時填入兩個入口。

已有訂閱連結:選擇 Subscribe

  1. 從服務提供者處複製完整的訂閱連結。不要複製成帳戶頁面網址,也不要只截取連結開頭;問號之後可能還有訂閱所需的參數。
  2. 開啟 Home,點選 Add Server,在 Type 中選擇 Subscribe。將連結貼到訂閱網址欄,確認前後沒有多餘空格;若有備註欄,可填寫容易辨識來源的名稱。
  3. 儲存並返回 Home。展開相應的訂閱群組,確認 SERVER 中出現可選的伺服器。看到群組名稱不代表已取得伺服器清單;首次匯入後若群組仍是空的,請先更新訂閱,再確認是否出現項目。

已有單台伺服器資訊:依協定填寫

從 Home 開啟 Add Server,在 Type 選擇資料註明的協定,再填寫對應欄位。Host 填伺服器位址,Port 填連接埠;位址和連接埠要分開填寫,不要把整段分享連結貼進 Host。Password、Method 等欄位是否出現,取決於所選協定。不要將截圖中某種協定的欄位套用到其他協定。

如果你已有服務提供者提供的單台伺服器 QR Code,可在 Add Server 使用 Scan QR Code。掃描後先確認 Type、Host 和 Port,再儲存。QR Code 或分享連結也可能包含驗證資訊,請勿將它們貼到公開討論區。

Shadowrocket 的 Add Server 介面,顯示 Type、Host、Port、Password、Method 與 Scan QR Code
Add Server:先選擇 Type,再填寫該類型要求的欄位;截圖顯示的是單台伺服器表單。
02 分流

在 Global Routing 選擇分流模式

返回 Home,點選 Global Routing。這裡決定接下來如何處理流量;在 SERVER 中選擇伺服器,只是指定代理請求可使用的伺服器,不會自動將分流模式切換為代理。

設定檔(Config)
依目前啟用的設定檔逐條比對請求。已經有需要使用的設定檔,且希望部分請求走代理、部分請求直連時,請選擇此項。
代理(Proxy)
讓用戶端接管的流量走代理,而不是依設定檔中的分流規則逐項決定。初次判斷伺服器是否能處理代理請求時,可短時間使用此模式進行對照。
直連(Direct)
讓用戶端接管的流量直接存取目標,不經所選的代理伺服器。可用來建立對照:如果直連也無法開啟同一個網址,不能只憑這個結果認定代理伺服器有問題。

選擇 Config 前確認設定檔

底部的 Config 用於查看和管理設定檔;Global Routing 中的 Config 則表示使用設定檔進行分流。先到設定檔清單確認目前啟用的是預期檔案,再返回 Home 確認 Global Routing 顯示 Config。只開啟某個檔案的編輯頁,不代表已啟用該檔案。

在設定檔中,Rule 的比對順序會影響結果:若同一網域既符合上方較寬泛的規則,也符合下方較具體的規則,先符合的規則會決定流向;FINAL 處理前面未符合的請求。初次連線不必編輯 Rule,先記下使用的設定檔和模式,方便驗證時比對。

Shadowrocket 的 Config 設定檔編輯介面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:這是設定檔編輯頁。選擇分流模式時,請返回 Home 的 Global Routing。

選好模式後返回 Home,確認 Global Routing 這一列顯示的選項與剛才的選擇一致。若暫時沒有明確的分流目標,可以先用 Proxy 驗證一筆伺服器,再返回 Config 驗證規則。

03 連線

在 Home 開啟連線開關

  1. 先選擇伺服器。在 Home 的 SERVER 中點選一筆剛匯入的紀錄,確認選取標記位於目標項目上。若清單中有多個相似名稱,請確認群組和備註,避免後續測試選到另一筆紀錄。
  2. 開啟頂端開關。首次操作時,iPhone 或 iPad 可能會顯示系統提示,要求允許 Shadowrocket 新增 VPN 設定。確認彈出視窗來自系統後,依提示允許;若需要裝置驗證,請只在系統介面中完成。若先前曾取消,返回 Home 再開啟一次開關。
  3. 等待狀態更新。頂端狀態從 Not Connected 變為 Connected,表示本機連線已建立。若開關彈回、狀態一直沒有變化,或系統提示受到管理政策限制,請先依第五步檢查,不必重複匯入相同資料。

Connected 描述的是本機連線狀態,不代表每個請求都經過伺服器,也不代表目標網頁一定可以存取。例如,Global Routing 選擇 Direct 時,頂端仍可顯示 Connected,但請求會以直連方式處理。要判斷實際存取是否正常,還需要進行下一步測試。

如果裝置平時會自動連線到其他 VPN,請先確認目前系統使用的是哪一項。只有在裝置由你管理,且這些連線不是工作或學校要求時,才暫停其他 VPN 進行對照。不要移除不屬於自己的設定。

Shadowrocket 的 Home 介面,頂端顯示 Not Connected 開關,下方有 Global Routing、Connectivity Test、SERVER 和 Add Server
Home:選取 SERVER 中的紀錄,再開啟頂端開關。Connectivity Test 位於 Global Routing 下方。
04 驗證

使用 Connectivity Test 和網頁存取進行驗證

將測試分成兩件事:先確認伺服器在目前測試方式下是否有回應,再確認瀏覽器能否存取你關心的網址。第一項通過不代表第二項也通過;能開啟網頁,也不能單憑這點判斷請求走的是代理還是直連。

  1. 記下本次測試條件。在 Home 確認頂端狀態、選取的伺服器和 Global Routing 模式。重新測試時盡量使用相同的 Wi-Fi 或行動網路;更換網路和伺服器都可能改變結果,請勿同時進行。
  2. 執行 Connectivity Test。在 Home 點選 Connectivity Test,等待結果更新,再查看所選伺服器對應的結果。若逾時,記下是只有這筆紀錄失敗,還是其他既有紀錄也有相同情況。測試回應時間只反映本次測試條件,不能當作網頁載入速度。
  3. 重新開啟已知可用的網址。切換到瀏覽器,用新分頁開啟平時可以存取的一般網頁;也可以重新整理頁面並開啟同一網站的另一頁,避免將先前已載入的內容誤認為新請求成功。若出現錯誤,記下是找不到主機、連線逾時,還是頁面開始載入後中斷。
  4. 需要確認分流時,再進行模式對照。保持網路、伺服器和目標網址不變,在 Home 分別選擇 Proxy、Direct,重新存取同一網址,接著返回 Config 再測一次。若只有 Config 的結果不同,請優先確認目前的設定檔和實際符合的 Rule。測試完成後,恢復日常使用的模式。
05 疑難排解

依失敗階段定位問題

先確認是沒有匯入紀錄、沒有建立連線,還是已連線但存取異常。從最早發生問題的環節開始檢查,每變更一項就重新測試一次。如果同時重新安裝用戶端、更換訂閱和修改設定,即使問題排除,也很難判斷原因。

已儲存訂閱,但 SERVER 中沒有伺服器

先確認群組沒有收合,且一般網頁在目前網路下可以開啟。檢查訂閱網址是否遭截斷,或是否貼成帳戶頁面網址。如果更新失敗、舊清單仍在,舊項目只能表示之前曾匯入;請先保留現有紀錄,確認新網址可以讀取後再替換,不要一開始就刪除仍可使用的群組。

開啟開關後仍顯示 Not Connected

返回 Home 確認已選取一筆伺服器,並檢查首次新增 VPN 設定時是否取消過系統提示。如果系統中有其他 VPN 正在執行,請依第三步先確認目前連線。若手動中斷後又自動連線,請在 Settings 確認 On Demand 是否正依條件觸發;在允許調整的個人裝置上,可先關閉 On Demand,再進行一次手動連線對照。

顯示 Connected,但測試逾時或網頁無法開啟

先用 Direct 進行對照。如果直連也無法開啟多個平時可用的網頁,請先檢查目前網路是否需要登入,或裝置本身能否正常上網。如果直連正常、Proxy 失敗,返回 Add Server 檢查對應紀錄中的協定、位址、連接埠和驗證參數。服務提供者沒有明確要求修改的欄位,請先維持原值。

只有 Config 模式下某個網域出現異常

確認 Config 中啟用的檔案,再檢查 Rule 中是否有排序更前面的寬泛比對。如果錯誤是找不到主機,請先記下網域和發生時間,再檢查目前設定的 DNS,不要一開始就修改所有 DNS 設定。規則和 DNS 的細節,可前往設定手冊逐項確認。

Shadowrocket 的 Settings 介面,顯示 Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:測試結果前後不一致時,確認 Test Method;自動重新連線時,檢查 On Demand;定位請求時,查看 Diagnostics。

若仍需要排查,請先記下問題發生在哪一步、目前網路類型、Global Routing 的選項和錯誤訊息,再依疑難排解中的分類繼續檢查。分享截圖或診斷紀錄前,請遮住訂閱連結、QR Code、伺服器驗證參數和其他敏感資訊。