官方手冊 / 快速入門

Shadowrocket 使用教學

匯入現有資訊、選擇 Global Routing,再進行連線與測試。首次操作請依序完成;已完成的步驟可從目錄直接跳過。

操作順序:資訊完整 → SERVER 出現項目 → 確認模式 → 開啟連線 → 檢查實際存取。截圖取自 App Store 官方頁面;請以裝置目前顯示的介面為準。

步驟 01 / 新增與匯入

Add Server:匯入現有連線資訊

開啟 Shadowrocket,進入 Home。下方 SERVER 區域會顯示現有伺服器與訂閱群組;首次使用時,請先點選 Add Server。接著依手邊的資訊選擇一種方式,不必重複匯入相同內容。訂閱連結是更新一組伺服器資訊的入口;單一伺服器資訊則是建立一條連線所需的參數,兩者的填寫方式不同。

已有訂閱連結:使用 Subscribe

在 Add Server 中點選 Type,選擇 Subscribe,再將自己的完整訂閱連結填入 URL。若需要區分多個來源,可在介面提供的名稱或備註欄位中填入方便辨識的名稱,然後儲存。返回 Home,等待內容取得完成,並確認相應群組中是否出現伺服器項目。若只儲存連結卻沒有項目,應先處理訂閱取得問題,不要直接進入連線步驟。

複製連結時請保留完整參數,避免連同說明文字、前後空格或換行一起貼上。也不要把服務商的網頁網址當成訂閱網址。連結可能包含帳號識別資訊,請只從自己信任的來源複製;排查問題時,不要在公開截圖中顯示完整連結。首次成功取得後,伺服器清單以實際回傳的內容為準,後續更新也可能新增或移除項目。

已有單一伺服器:依 Type 填寫參數

返回 Add Server,先根據現有資料選擇 Type,再填寫 Host、Port 與該協定要求的驗證參數。截圖中顯示 Password、Method 等欄位,但並非所有協定都使用相同欄位。Host 填寫伺服器位址,Port 填寫相應連接埠;驗證資訊、加密方式及傳輸相關參數都必須與伺服器端一致,不可只憑欄位外觀猜測。

若現有資料以 QR Code 提供,可使用 Scan QR Code 掃描;掃描後仍須檢查 Type 與重要欄位。Import from Cloud JSON 僅適用於已有相應格式資料的情況,並非所有連結都能使用的通用入口。儲存後返回 Home,確認 SERVER 中出現該項目。這只代表資訊已輸入,能否建立連線仍須經過後續測試。若不清楚欄位用途,請先查閱術語手冊,不要用反覆修改參數取代核對原始資訊。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method 與底部的匯入入口
Add Server:先選擇 Type,再依現有資料填寫相應欄位。圖中欄位會隨所選協定而變化。

步驟 02 / 選擇模式

Global Routing:確認連線採用的策略

SERVER 中出現項目後,先別急著開啟開關。在 Home 點選 Global Routing,檢查目前模式。這裡決定要求的處理方式;選擇伺服器與選擇路由模式是兩個獨立操作。即使已選取伺服器,直連策略也不會因此自動變成代理策略。

設定(Config):依目前規則處理

設定(Config)會依目前設定檔中的規則決定要求的路由方式。進入 Config,確認已選取要使用的設定,再查看 Rule 中的策略。Config 頁面用於管理設定檔;Global Routing 中的 Config 則表示採用設定規則。兩處名稱相同,但操作目的不同。只匯入 Subscribe,並不能取代對目前規則的確認。

例如,規則可以讓某個網域使用 PROXY,讓某個位址範圍使用 DIRECT。實際結果取決於規則內容、順序與策略引用。初次使用時,不必逐項修改截圖中的 General、Hosts、URL Rewrite 或 HTTPS Decryption 區段,也不需要為了連線而開啟額外功能。已有可用設定時請保留,先確認基本連線,再了解個別規則。

代理(Proxy)與直連(Direct):區分測試目的

代理(Proxy)會依該模式的行為,將要求交由所選代理伺服器處理,適合初次測試時減少規則差異造成的干擾;但這不代表所有系統流量都一定會經過處理。直連(Direct)則以直連模式處理要求,不經過所選代理伺服器。若要測試剛匯入的伺服器,停留在 Direct 無法完成這項測試。

初次操作時,可先記下原本模式,暫時切換為 Proxy,完成連線與存取檢查後,再切回需要的 Config。切回後必須重新測試,因為伺服器可用與規則正確是兩回事。若尚未準備好規則,請先了解目前的設定,不要只為了讓模式顯示 Config 就匯入來源不明的內容。規則關鍵字的含義可查閱術語手冊;設定檔管理請參閱Config 設定說明。

Shadowrocket 的 Config 設定編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:查看設定中的 Rule 等區段。Global Routing 的模式選擇在 Home 進行,不是在這個編輯頁面中操作。

步驟 03 / 開啟連線

Home:選取伺服器並開啟連線

返回 Home,在 SERVER 中點選一台現有伺服器。若同一訂閱下有多筆記錄,先選一筆進行測試,不要連續切換多個項目。接著再確認一次 Global Routing,確定仍是上一步選定的模式。項目名稱只是辨識標籤,不能據此推斷連線品質、協定參數或目前是否可用。

點選 Home 頂端的連線開關。首次建立連線時,系統可能會提示允許新增 VPN 設定。這項提示是讓 Shadowrocket 建立系統網路連線設定,不是再次購買 App,也不代表訂閱內容已通過驗證。請核對提示中的 App 身分,確認這是由本次主動操作引發後,再依系統指示完成裝置驗證。

完成授權後返回 Home,查看頂端開關與連線狀態是否有變化。截圖中的 Not Connected 表示尚未連線,不是需要手動填寫的文字。若先前拒絕授權,開關可能無法維持開啟;請重新發起連線並處理系統提示,不要重新匯入相同訂閱。若裝置受到管理限制,系統也可能不允許建立所需設定,請先確認裝置權限。

若系統目前已有其他 VPN 連線,請先在系統設定中確認目前使用的連線,再返回 Shadowrocket 重試,避免連線互相切換造成誤判。首次測試期間,也先不要設定 On Demand;自動觸發條件會增加判斷步驟。等手動連線與中斷都能重複成功後,再依需求了解按需連線。

開關已開啟只表示連線流程進入相應狀態,不能證明伺服器端驗證、目標存取或所有規則都正確。請勿在此結束操作。維持目前的伺服器與模式,進入下一步執行 Connectivity Test,並透過實際存取確認結果。若開關立刻跳回關閉,請記下系統提示或錯誤文字,再前往排查失敗原因。

Shadowrocket 的 Home 頁面,頂端顯示 Not Connected 開關、Global Routing 與 Connectivity Test,下方為 SERVER 和 Add Server
Home:先在 SERVER 中選取伺服器,確認 Global Routing,再操作頂端的連線開關。

步驟 04 / 確認生效

Connectivity Test:從測試到實際存取

保持連線開啟,在 Home 點選 Connectivity Test。等待本次測試完成後再查看結果。測試結果會受到採用的測試方法影響:可能只反映特定探測目標或某種交握流程,不代表所有網頁都能存取。顯示的耗時也不是實際下載速度,不能只憑一個數值判斷整體連線體驗。

接著開啟瀏覽器,前往平常使用的網頁。確認內容確實重新載入,而不只是顯示瀏覽器快取。再開啟另一個常用目標交叉檢查,區分單一網站問題與整體存取問題。需要比較時,可以記錄開啟連線前後的情況,但不應只以網頁外觀變化作為判斷依據。

Config 模式下,再次確認規則

若上一步為了排除干擾而使用 Proxy,現在請切回預計長期使用的 Config,再重複相同的存取操作。Proxy 下可用、Config 下部分目標失敗時,通常應優先檢查規則比對、策略引用及網域解析,而不是立刻刪除伺服器。反過來說,Direct 下網頁能開啟,也不能證明代理伺服器可用,因為該要求可能根本沒有使用代理伺服器。

若要核對具體的處理方式,請查看 App 內與本次存取相對應的連線記錄或診斷資訊,並依目標網域、時間及命中策略進行判斷。記錄中的 DIRECT 與 PROXY 代表不同的處理方式;只有系統 VPN 圖示,無法說明某項要求命中了哪條規則。規則順序等細節可前往術語手冊繼續閱讀;本頁先完成最基本的測試流程。

最後手動中斷一次,再重新連線並重複相同測試。兩次結果一致且實際存取正常後,才適合繼續調整更細部的設定。若測試失敗但網頁正常,先確認測試方法與目標;若測試成功但網頁無法開啟,請保留目前設定並記錄失敗網域、時間及提示,再依下一步逐層找出原因。每次只變更一項,才能將變更與結果對照。

步驟 05 / 排查失敗原因

Settings:依現象逐項檢查

先確認問題發生在哪一層:訂閱未取得、伺服器無法連線、開關無法開啟,或只有部分網頁失敗。不同情況需要不同處理方式。保留現有項目與設定,記下原始狀態,不要一開始就刪除所有內容。進入 Settings 後,可看到 Test Method、On Demand、Diagnostics,以及 Proxy、TCP、UDP 等設定入口;本次只檢查與問題現象相關的項目。

訂閱更新失敗:先確認連結與網路

若 Home 中沒有取得任何項目,請重新核對 Subscribe 的完整連結,確認是否已過期、遭到更換,或複製時遺漏參數。確認目前網路能連到該連結對應的服務,並向自己的服務商確認訂閱是否仍有效。取得失敗與單一伺服器連線失敗是不同問題;此時修改伺服器的 Port 或 Method 通常沒有幫助。更多情況請參閱訂閱失敗問答。

項目存在但無法連線:重新核對伺服器參數

開啟相應項目,逐一比對原始資料中的 Type、Host、Port 與驗證資訊。若資料明確列出 TLS、傳輸方式、伺服器名稱等參數,也應保持一致。不要因為欄位看起來可選,就刪除已有值。可改用自己已有的另一台伺服器作為對照,但每次只測試一台,並記錄切換後的結果,避免混淆不同項目的現象。

開關或存取異常:區分系統、規則與網路

開關無法維持開啟時,先檢查 VPN 設定授權、系統提示與裝置限制。開關正常但所有目標都失敗時,再檢查所選伺服器與本機網路;在自己的 Wi-Fi 與行動網路之間切換一次,有助於判斷是否與目前的網路連線有關。切換可能產生流量費用,請先確認自己的網路使用條件。

只有部分目標失敗時,優先重新檢查 Global Routing 與 Config 中的規則。若只有 Connectivity Test 失敗,請進入 Settings 查看 Test Method,確認所選方法及其限制。不要為了讓某次測試通過,就同時更改 DNS、TCP、UDP 等多組設定,也不要直接關閉與驗證相關的檢查。每次修改前先記下原值;測試沒有改善就還原。

若需要進一步找出問題,可在 Diagnostics 中查看目前介面提供的診斷項目。分享錯誤資訊前,請遮蔽訂閱連結、密碼、驗證識別資訊及不需公開的位址,只保留必要的錯誤文字與操作順序。連線相關問題可繼續參閱無法連線問答;若問題出在安裝、商店地區或還原已購項目,請改看App Store 安裝指南,不必透過修改連線參數處理。

完成基本排查後,返回 Home,使用相同伺服器、相同模式與相同目標重新測試。能夠重現的操作記錄,比一次修改許多設定更有幫助。日常使用時,先保留已確認可正常運作的設定;需要了解 On Demand 或更細部的規則時,再閱讀功能與設定,逐項新增,不要一次啟用所有功能。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:依現象選擇檢查項目。初次排查請保留原值、每次只修改一項,並重複測試。