Shadowrocket 官方手冊

Shadowrocket 使用教學

先匯入既有連線資訊,再選擇路由模式。連線後分別檢查伺服器與實際存取結果,不要把開關狀態當成分流結果。

01 Add Server

新增伺服器或匯入訂閱

開啟 Shadowrocket,在底部進入 Home,先找到 SERVER 群組。若已有一台伺服器的參數,請選擇手動新增;若取得的是一條用於同步多個項目的連結,請選擇匯入訂閱。兩種方式擇一即可,不需要重新抄寫訂閱中的項目。首次操作時,先讓頂端連線開關保持關閉,儲存完成後再檢查項目。

手動填寫伺服器參數

從 Home 點選加號或 Add Server,先在 Type 選擇與既有伺服器相同的協定。選定類型後,表單才會顯示對應欄位。依原始資訊分別填寫 Host 和 Port:前者是主機名稱或 IP 位址,後者是連接埠號碼。不要把連接埠、路徑或協定前綴一併貼到 Host。若頁面顯示 Password、Method 等欄位,也請依既有參數填寫,不要根據截圖中的欄位排列推測自己的協定設定。

儲存前檢查輸入內容是否有多餘空格、換行或遭自動改寫的字元。若已有對應的 QR Code,可以使用 Scan QR Code,辨識後同樣核對 Type 和位址再儲存。截圖底部也可看到 Import from Cloud JSON,這是另一種匯入方式;本步驟的普通訂閱連結不需要從該處貼上。

匯入既有訂閱

透過加號進入新增介面,在 Type 選擇 Subscribe,將原有訂閱連結完整貼到位址欄。檢查開頭和結尾是否完整,查詢參數也應一併保留;不要以瀏覽器網址列中經過轉址的頁面網址取代原始連結。儲存後回到 Home,展開對應群組,選取一個伺服器供下一步測試。若已出現群組標題,但底下沒有可選項目,請先檢查訂閱是否更新成功,不要直接將問題歸咎於連線開關。

此時應能在 SERVER 群組下看到至少一個可選項目。記下目前選取的名稱即可,不必將訂閱連結、密碼或 QR Code 複製到故障排除筆記中。接著選擇路由模式;儲存伺服器並不會替你決定哪些請求經由它轉送。

Add Server 頁面,顯示 Type、Host、Port、Password、Method,以及底部的掃描與 JSON 匯入入口
Add Server:先選擇 Type,再核對該類型的欄位。
02 Global Routing

選擇 Global Routing 模式

回到 Home,點選 Global Routing。這裡選擇的是連線後的流量處理方式,不負責新增伺服器,也不負責開啟連線。若已有準備使用的設定檔,且希望不同目標使用不同路徑,請選擇配置(Config)。若要比較代理與直連的表現,先確認要測試哪條路徑,再暫時選擇代理(Proxy)或直連(Direct)。

配置(Config):依目前規則分流

選好模式後,到底部的 Config 確認目前使用的是哪一份設定檔。清單中看得到某份檔案,不代表它已生效;請從 Config 開啟目前的檔案,再查看 Rule 區段。網域規則可依目標位址比對,命中後執行相應策略,例如 PROXY 或 DIRECT;若未命中前面的規則,還要查看檔案中的 FINAL 如何設定。初次驗證時,了解兩條預期路徑即可,不必在 Add Rule 中臨時新增規則。

同一個頁面也可能向圖片或登入服務發出請求,而這些請求的網域與網址列不同。因此,看到主網域有規則,不代表此頁面的所有請求都使用同一條路徑。若目前還沒有明確的規則預期,可以先測試單一流量路徑,了解結果後再回到配置模式。

代理(Proxy)與直連(Direct):用於對照測試

代理(Proxy)會讓交由用戶端處理的流量走代理路徑,適合確認所選伺服器能否承載實際請求。直連(Direct)則會讓這些流量直接存取目標,適合檢查同一目標在目前網路下的直連表現。比較時請維持伺服器、網路和測試目標不變,只切換模式;直連成功不能證明代理正常,代理成功也不能證明設定檔已比對到預期規則。

選擇完成後回到 Home,確認 Global Routing 列顯示預期的英文模式。若要進一步了解規則順序或協定欄位,請參閱技術參考;此處先保留可重現的設定,再進入連線步驟。

Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:在目前的設定檔中查看 Rule 區段。
03 Home

開啟連線開關

在 Home 再核對兩處:SERVER 群組下選取的是準備測試的伺服器,Global Routing 列顯示的是剛才選擇的模式。確認後,再開啟頁面頂端處於 Not Connected 狀態的開關。開關用來控制用戶端連線,選擇伺服器和模式都是連線前的設定,不能取代這個步驟。

裝置首次使用 Shadowrocket 時,系統可能會要求新增 VPN 設定。確認提示視窗是由剛才的操作觸發,且要求來自 Shadowrocket 後,依系統介面指示確認;若要求驗證裝置身分,請在系統介面中完成。回到 Home 等待狀態更新,再確認開關是否維持開啟。若誤點取消,先回到 Home 再試一次,不必因此刪除剛儲存的伺服器或訂閱。

若裝置目前還有另一條 VPN 連線、受管理的網路設定,或先前曾開啟 On Demand,請先確認目前由哪項設定接管連線。受組織管理的裝置應遵循管理員的設定要求。首次測試盡量在同一個 Wi-Fi 或行動網路中完成,不要在開關剛開啟時切換網路,以免將切換網路造成的中斷誤判為伺服器錯誤。

開關開啟只代表連線已啟用,不能證明所選伺服器可連線,也不能證明某個請求走了代理。若狀態能維持,請繼續下一步驗證;若狀態立即回復,直接依第五步檢查,不要連續修改模式和伺服器參數。

Home 頁面,頂端顯示 Not Connected,下方依序為 Global Routing、Connectivity Test 和 SERVER 群組
Home:頂端開關、目前模式和測試入口可在同一頁查看。
04 Connectivity Test

驗證伺服器與實際分流

先留在 Home,點選 Connectivity Test,查看目前伺服器的結果。測試有回應,表示在目前網路和測試方式下取得了結果;逾時則表示這次沒有如預期回應。此測試反映的是設定測試條件下的表現,不能取代實際目標驗證。比較兩次結果前,先確認查看的是同一個伺服器項目。

接著發出一次實際請求。若目前使用配置(Config),從已知規則中選一個應走 DIRECT 的目標,以及一個應走 PROXY 的目標,分別重新存取。不要只查看已開啟的頁面:快取可能讓頁面看起來正常,卻沒有發出新請求。若用戶端中可查看這次請求的記錄,可以依請求時間和目標網域找到對應項目,再核對顯示的策略或比對規則。只憑頁面已開啟,無法判斷流量路徑。

若結果不如預期,請維持目前網路、伺服器和測試目標不變,使用代理(Proxy)與直連(Direct)進行一組對照。例如,同一目標在代理(Proxy)下可以存取,回到配置(Config)後卻失敗,請優先檢查目前設定檔、比對順序和實際請求網域,而不是重複填寫伺服器參數。完成對照後,將 Global Routing 還原為日常需要的模式。

驗收時可以記錄三項:開關能否維持開啟、伺服器測試是否有回應、請求命中哪項策略。分開記錄這三項,之後即使其中一項有變化,也能判斷問題出在裝置連線、伺服器可連線性,還是分流結果。

05 Settings

依故障現象排除問題

每次只修改一項,再使用相同目標重新測試。進入底部的 Settings,先找到 Diagnostics、Test Method 和 On Demand。從下列符合目前現象的項目開始,不必一次修改所有設定。

開關開啟後立即中斷,或關閉後又重新連線

若開啟後立即中斷,先確認第一次的系統提示是否已完成,以及裝置目前是否有其他 VPN 設定正在執行;再查看 Diagnostics 中與這次嘗試時間對應的資訊。若手動關閉後又重新連線,請檢查 On Demand 是否定義了目前網路的觸發條件。調整既有設定前,先記下原本狀態,方便排除問題後還原。

伺服器清單空白,或選取項目後測試逾時

清單空白時,回到新增步驟,先確認訂閱群組是否有項目,以及同步是否完成。若已有項目但測試逾時,先檢查裝置網路,再逐項比對所選項目的協定、主機和連接埠與原始資訊是否一致。查看 Test Method 是為了了解目前測試的內容,不要只為了取得不同讀數而更改測試方式。若需要切換 Wi-Fi 與行動網路進行對照,每次只切換網路,其他條件保持一致。

測試有回應,但部分頁面無法存取

先確認無法存取的是整個頁面,還是圖片、登入等個別請求。使用上一步的模式對照縮小範圍;若問題只出現在配置(Config),請檢查目前作用中的設定檔和錯誤請求的目標網域,再確認是否由較早的規則處理,或套用到 FINAL。不要先大量修改規則。若要進一步確認訂閱更新、系統提示或模式差異,請查看常見問題。

記錄問題時,保留發生時間、連線模式、網路類型和錯誤現象即可。分享截圖或診斷內容前,請遮住訂閱網址、伺服器憑證,以及可用於再次匯入的 QR Code。

Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics,以及 Proxy、TCP、UDP 設定項目
Settings:依現象查看 Diagnostics、Test Method 或 On Demand。

Shadowrocket 取得與安裝

iPhone / iPad 版在 App Store 一次性付費 $2.99,系統需求以 App Store 頁面標示為準;Mac / Windows / Android / Linux 版免費,安裝檔透過本站 /dl/ 提供。Mac 請先在「關於這台 Mac」確認晶片,再選擇 Apple 晶片版或 Intel 版。

用戶端一次性買斷 ≠ 線路方案。本教學使用的是你已持有的訂閱或伺服器資訊,購買用戶端不會為你取得這些資訊。

iPhone / iPad 一次性付費 $2.99;Mac / Windows / Android / Linux 免費

首次在 Mac、Windows 或 Android 裝置上安裝時若遇到系統封鎖,請先確認安裝檔來自本站且適用於該裝置,再依對應平台的安裝與允許執行說明操作。若無法確認來源,請先停止安裝。