官方手冊 · 初始設定

Shadowrocket 設定教學

從新增現有伺服器或訂閱開始,依序設定分流、開啟連線,再以實際請求檢查結果。

01 匯入資料

在 Add Server 新增伺服器或匯入訂閱

開啟 Shadowrocket,進入 Home。在 SERVER 區域找到 Add Server,開啟新增頁面。先確認手邊資料的類型:包含協定、主機和連接埠等欄位的資料,通常對應單一伺服器;服務商提供的訂閱網址則用來讀取一組項目。請勿將訂閱網址貼入單一伺服器的 Host 欄位。

手動填寫單一伺服器

先在 Type 選擇資料所標示的協定類型,再確認頁面依類型顯示的欄位。以截圖中的欄位為例,Host 填寫主機名稱或位址,Port 填寫連接埠;若該類型顯示 Password 或 Method,請依資料逐項填寫或選擇,不要根據其他協定的同名欄位推測。貼上後檢查前後是否有多餘空格,也不要將主機和連接埠整串填入同一欄位。儲存後返回 Home,確認新增項目出現在 SERVER 區域。

使用 Subscribe 匯入現有訂閱

在 Add Server 中選擇 Subscribe,將服務商提供的完整訂閱網址填入網址欄並儲存。複製時不要刪除問號後的參數,也不要連同備註一起貼上。返回 Home,等待清單載入後展開對應群組,確認其中確實有可選擇的伺服器。若群組出現但沒有項目,請先排查訂閱讀取問題,不要把空群組視為匯入成功。

若手邊有單一伺服器的 QR Code,可在 Add Server 使用 Scan QR Code;辨識後仍須確認類型和主要欄位。截圖中的 Import from Cloud JSON 是另一種匯入方式,不能取代 Subscribe。確認清單後,記下接下來要測試的項目;先進行下一步,決定流量處理方式,再開啟連線。

Shadowrocket 的 Add Server 介面,顯示 Type、Host、Port、Password、Method,以及底部兩個匯入入口
Add Server:先選擇 Type,再填寫該類型所需欄位。

02 選擇模式

在 Global Routing 選擇流量處理模式

返回 Home,點開 Global Routing。這裡決定流量的處理方式,不負責選擇伺服器,也不等於開啟連線。若要檢查日常規則分流,通常先使用設定檔(Config);若只想進行一次對照測試,可暫時選擇另外兩種模式,測試後再切回原選項。

  • 設定檔(Config):依目前設定檔中的規則,決定請求使用代理、直連或其他指定策略。適合檢查不同目標是否依預期分流。
  • 代理(Proxy):將由用戶端處理的流量交由代理路徑處理,而非依設定檔逐條分流。適合暫時確認已選伺服器能否處理實際請求。
  • 直連(Direct):用戶端處理的流量不經代理伺服器轉送。適合在同一裝置、同一網路下進行對照,但不代表關閉 Home 的連線開關。

使用 Config 時,先確認設定檔

Home 的 Global Routing 顯示 Config,表示目前選擇依規則處理;底部的 Config 則是查看及管理設定檔的入口。進入後,確認目前使用哪個檔案,再開啟對應編輯頁查看 Rule。不要只因檔名相似,就認定兩個設定檔內容相同。截圖中的 General、Hosts 和 Rule 各有用途,首次確認分流時主要查看 Rule,不必逐項修改。

例如 DOMAIN-SUFFIX,example.com,PROXY 表示符合該網域後綴的請求使用 PROXY 策略。實際驗證時,請選擇設定檔中確實存在的目標,並檢查前面是否有更早比對成功的規則,以及未符合規則的請求會套用哪個預設策略。初次連線不必先點選 Add Rule;先用現有規則完成一次驗證,確認能區分伺服器與規則問題後再修改。協定參數請參閱技術參考,模式用途請參閱代理模式。

Shadowrocket 的 Config 設定檔編輯介面,包含 General、Rule、Hosts、URL Rewrite 和 HTTPS Decryption 區段
Config 編輯頁:在 Rule 檢查規則內容和順序。

03 建立連線

在 Home 開啟連線開關

返回 Home,在 SERVER 下方開啟剛匯入的群組,點選要使用的伺服器。若同一群組有幾筆名稱相似的項目,請先確認目前選取的確實是要測試的那一筆。再確認一次 Global Routing 顯示的目前模式,避免上一步對照測試後仍留在其他選項。若要驗證規則,請保持模式為 Config。

撥動頁面頂端、位於 Not Connected 狀態旁的開關。首次啟動時,iPhone 或 iPad 可能會出現新增 VPN 設定的系統提示。確認提示對應剛開啟的 Shadowrocket,再依系統提示允許並完成裝置驗證。返回 Home 後,等待連線狀態更新;若剛開啟就回到 Not Connected,請先依排查步驟檢查授權和連線衝突,不必反覆切換開關。

頂端狀態顯示已連線,只能表示裝置端已建立連線,不能證明剛選取的伺服器可用,也不能證明某個網站已符合預期規則。首次測試時,盡量維持裝置使用的網路不變,並記下目前伺服器、模式和設定檔名稱。即使下一步結果不如預期,也能在相同條件下重新測試。

Shadowrocket 的 Home 介面,顯示 Not Connected 開關、Global Routing、Connectivity Test 和 SERVER 群組
Home:上方是連線開關,下方是伺服器清單。

04 確認結果

使用 Connectivity Test 和實際請求進行驗證

先在 Home 點選 Connectivity Test,等待測試結果更新。請留意剛才選取的項目,不要用相鄰伺服器的結果判斷。出現可用結果,只表示該項目在當時的網路和測試方法下有收到回應;測試逾時也不代表設定一定錯誤,測試目標無法連線或目前網路不穩,都可能造成相同現象。若要驗證實際用途,仍須在下一步發出實際請求。

在設定檔模式下,分別驗證兩種路徑

使用 Config 時,請在目前設定檔中各找一個預期使用 DIRECT 和 PROXY 的目標。開啟瀏覽器或相關應用程式,重新發出請求,並留意顯示的是否為快取內容。若能查看對應請求的比對紀錄,請依請求時間找出實際目標網域和使用的策略,再對照 Rule 中的規則順序。網址列中的主網域不一定涵蓋所有請求目標;頁面圖片或登入介面可能使用不同網域,因此不能只憑頁面能開啟,就判定所有流量都符合同一條規則。

結果不一致時,一次只變更一項條件

若只有預期使用代理的目標失敗,請維持網路和已選伺服器不變,暫時使用 Proxy 對同一目標重新測試。若 Proxy 下可用、Config 下失敗,優先檢查目標實際符合的規則或策略;兩種模式下都失敗,再檢查伺服器參數和測試方法。若要對照直連路徑,則暫時切換至 Direct,確認不經伺服器時同一目標的狀況。測試結束後切回原模式,並依原設定再試一次。

05 找出故障點

依故障現象檢查 Settings 和連線條件

從最早發生異常的環節開始檢查。項目沒有匯入,就先檢查匯入步驟;開關無法維持開啟,就先檢查裝置端連線;能連線但部分請求失敗,再檢查伺服器、測試方法和規則。每次只調整一項條件,接著重做剛才失敗的操作。

群組空白,或重新匯入後仍找不到項目

返回 Add Server,確認類型是否選為 Subscribe,並檢查網址是否完整、是否仍是服務商目前提供的網址。手動新增時,請確認 Type 與資料相符,並檢查 Host 和 Port 是否填反。重複匯入相同網址通常無法解釋失敗原因。若需整理資訊以尋求協助,只記錄錯誤提示和發生步驟,不要分享完整訂閱連結、密碼或金鑰。

開關跳回,或中斷後又自動連線

開關跳回時,先確認是否已允許首次出現的系統提示,並檢查裝置上是否還有其他作用中的 VPN 連線。受組織管理的裝置可能會限制設定變更,若出現管理提示,請先詢問裝置管理員。若情況相反,也就是手動中斷後又自動連線,請進入 Settings 查看 On Demand 是否已啟用,記錄自動連線時的網路環境,再判斷是否由隨選連線條件觸發;不要將自動重新連線和伺服器測試逾時混為一談。

測試逾時,或只有部分應用程式連線異常

在 Settings 記下 Test Method,返回 Home 對同一伺服器再測一次。若已有同一訂閱中的其他伺服器,可在不變更模式和網路的情況下進行對照。若只有一筆失敗,優先重新確認該筆參數;若多筆都失敗,先確認裝置的基本網路和測試條件。測試有結果但只有部分應用程式異常時,查看 Diagnostics 中可用的診斷資訊,記下失敗時間、目標網域和實際模式,再對照驗證步驟找出問題。先記錄再修改,不要同時修改規則、切換伺服器和更換網路。

Shadowrocket 的 Settings 介面,包含 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:檢查測試方法、隨選連線和診斷入口。