官方手冊 · 快速入門

Shadowrocket 使用教學,從匯入到首次連線驗證

依序完成新增、模式選擇、連線與測試。先確認一台既有伺服器通過驗證,再調整規則與其他設定。

步驟 01

Add Server 與 Subscribe,將既有資訊加入 Home

先確認手邊是哪一種資訊:訂閱連結、伺服器分享連結、QR Code,或是位址、連接埠與驗證參數。訂閱通常包含一組可更新的伺服器;手動輸入的資訊則對應單一伺服器。兩者的輸入方式不同,請勿將訂閱連結填入單一伺服器的 Host,也不要只憑連結外觀猜測協定。匯入時先保持連線開關關閉,方便確認項目是否完整。

已有訂閱連結:使用 Subscribe

前往 Home,點選 Add Server 開啟新增頁面,在 Type 中選擇 Subscribe,再將完整的既有訂閱連結填入 URL。可設定方便辨識的名稱,然後使用頁面上的完成或儲存功能。返回 Home 後,等待訂閱載入,並確認相應群組下出現伺服器項目;如果只看到訂閱名稱、沒有伺服器,先確認載入是否完成,再檢查連結是否有效。

複製連結時請保留原有查詢參數,避免混入前後空格、換行或說明文字。訂閱連結可能包含存取憑證,請視為個人敏感資訊,不要貼到公開留言或截圖中。若顯示載入失敗,請勿反覆新增相同連結;先向既有服務的提供者確認連結狀態,再重新更新。群組管理與後續更新方式,請參閱伺服器管理手冊的 Subscribe 章節。

已有單一伺服器:依 Type 填寫欄位

同樣從 Home 的 Add Server 進入,先選擇與既有資訊相符的 Type,再填寫相應欄位。以圖中的欄位為例,Host 填伺服器位址,Port 填連接埠,Password 填驗證資訊,Method 則依原始參數選擇。不同 Type 顯示的欄位可能不同;VMess、VLESS、Trojan 等協定的驗證與傳輸參數,不能直接套用其他類型的填寫方式。看不懂欄位時,請先查閱術語表,不要自行猜測填入。

若既有資訊包含 TLS、傳輸方式或其他附加參數,也應逐項核對。伺服器位址與 TLS 使用的名稱可能各有用途,不要只為了看起來一致就全部改成同一個值。若有 QR Code,可使用 Scan QR Code 掃描;允許相機權限後,對準完整的 QR Code,匯入後仍須檢查 Type 與主要欄位。Import from Cloud JSON 適用於相應格式的資料,不能取代一般訂閱連結的輸入方式。

本步完成標誌:返回 Home 後,SERVER 或訂閱群組下已有可選伺服器;點選編輯後,能看到預期的 Type 與參數。這表示資料已輸入完成,尚不能證明伺服器可連線。接下來先確認請求應採用哪種 Global Routing 行為。

Shadowrocket 官方 Add Server 頁面,顯示 Type、Host、Port、Password、Method 與 Scan QR Code 入口
Add Server:先選擇 Type,再依既有資訊填寫相應欄位;欄位會隨類型而異。
步驟 02

Global Routing 三種模式,先決定如何處理請求

返回 Home,開啟 Global Routing。初次使用時,先分清設定檔 (Config)、代理 (Proxy) 與直連 (Direct):此處決定整體路由行為,不是選擇伺服器協定。切換 Global Routing 不會自動補齊伺服器參數,也無法讓無法使用的伺服器恢復正常。修改前先記下目前選項,測試完成後才能準確恢復原有設定。

  • 設定檔 (Config):依目前啟用的設定檔及其規則,決定如何處理請求。不同請求可能符合 PROXY、DIRECT 或 REJECT 等動作,不一定都走相同路徑。
  • 代理 (Proxy):讓請求整體採用代理路由的模式。初次排查時可用來排除規則因素、檢查所選伺服器,但伺服器資訊與連線條件仍須有效。
  • 直連 (Direct):直接連線至目標。此時網頁能開啟,不能據此判定所選代理伺服器已通過驗證。

如果目的是先驗證新匯入的伺服器,可暫時選擇代理 (Proxy),完成連線測試後再切回設定檔 (Config) 檢查分流。這是建議的排查順序,不代表必須長期使用同一種模式。若選單中還有 Scene,首次連線流程不需要額外設定;確認基本連線後,再依實際需求閱讀相關說明。

使用 Config 前,先確認設定檔

準備使用設定檔 (Config) 時,前往 Config 確認目前選取的設定檔,並開啟檢視規則內容。官方截圖顯示的是設定檔編輯頁面,General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分別管理不同設定;這不是 Home 中的 Global Routing 選單。看到 Add Rule 只表示可新增規則,不代表連線前必須先新增規則。

初次操作不必逐一修改所有區段,也不需要為了連線而啟用 HTTPS Decryption。先檢視既有 Rule 的比對條件與動作,尤其確認未符合規則的請求會如何處理。規則順序會影響比對結果;若將範圍較廣的規則放在前面,後續較精確的規則可能無法處理請求。遇到 DOMAIN-SUFFIX、IP-CIDR、FINAL 等關鍵字,可前往術語表確認含義。

本步完成標誌:返回 Home 後,能清楚說出目前選擇的是設定檔 (Config)、代理 (Proxy) 還是直連 (Direct)。若選擇 Config,也知道目前使用哪個設定檔。確認後再選擇伺服器並開啟連線,避免同時修改規則又判斷連線結果。

Shadowrocket 官方 Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:查看設定檔區段與 Rule。選擇 Global Routing 模式時,請返回 Home 操作。
步驟 03

在 Home 選擇預設伺服器,再開啟開關並完成授權

在 Home 的 SERVER 或訂閱群組中,點選這次要使用的伺服器,並留意項目旁的選取標記。請分清「點選項目」與「開啟項目編輯」:進入編輯頁只是查看參數,不代表該伺服器已成為目前使用的伺服器。返回列表確認 DOT 選取標記,再查看一次 Global Routing,確認與前一步的測試計畫一致。

若列表中有多個訂閱群組,先展開目標群組,選擇自己能辨識來源與用途的項目。首次連線時不要同時測試多台伺服器,也不要不斷切換項目;維持一台明確的目前使用伺服器,後續 Connectivity Test 的結果才有可追溯的對象。剛更新訂閱時,也要確認原先選取的項目仍在列表中。

首次 VPN 設定授權

點選 Home 頂端的連線開關。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定。閱讀系統提示,確認這是目前主動發起的操作,再依系統流程允許,並完成裝置要求的身分驗證。此授權用於讓 App 建立相應的網路連線設定,不代表遠端伺服器已驗證可用,也不會代為建立訂閱或補齊驗證參數。

如果剛才取消授權,請先返回 Home,再次主動開啟開關,並依出現的系統提示操作。若開關立即關閉,請勿連續快速點按;先查看 App 或系統提示,確認授權流程是否完成。裝置受管理政策限制時,相關設定可能無法變更;請先確認裝置管理要求,不要反覆修改伺服器密碼。

完成授權後返回 Home,確認頂端是否已離開 Not Connected 狀態,以及開關能否維持開啟。系統狀態列或控制中心可能會顯示 VPN 狀態,但顯示位置會依裝置與系統介面而異。不要只憑是否看到圖示判斷成功;應一併檢視連線開關、App 提示與下一步的實際測試結果。

本步完成標誌:目前選取的伺服器明確、系統授權已完成,且連線開關維持開啟。若開關能維持開啟,但網頁仍無法使用,先不要刪除設定;「已建立連線」與「可存取目標」是兩個檢查層次,接下來分別使用 Connectivity Test 與實際存取進行驗證。

Shadowrocket 官方 Home 頁面,顯示頂端 Not Connected 開關、Global Routing、Connectivity Test、SERVER 與 Add Server
Home:依序確認伺服器選擇、Global Routing 與連線開關,再執行 Connectivity Test。
步驟 04

Connectivity Test 與實際存取,分別驗證連線是否生效

保持 Home 的連線開關開啟,點選 Connectivity Test,等待本次測試結果。測試期間不要切換伺服器或 Global Routing,否則前後結果可能不是在相同條件下取得。測試成功表示本次測試所檢查的路徑能完成相應操作,不代表所有網站、協定或 App 都一定可用;測試失敗時,也須搭配測試方式與實際存取情況判斷。

接著開啟平常確實需要使用的網頁或 App,重新發起一次存取,避免只查看已快取的內容。可以重新整理頁面,或開啟該服務中尚未載入的內容。先驗證一個明確目標,再測試另一個目標;若只有單一服務失敗,應將問題範圍縮小至該目標、相應規則或服務本身,不要立刻重新匯入所有伺服器。

依目前模式判讀測試結果

目前使用直連 (Direct) 時,存取成功只表示直連路徑可用,不能驗證代理伺服器。目前使用設定檔 (Config) 時,目標可能符合 DIRECT、PROXY 或 REJECT;因此,「網頁已開啟」與「該網頁經由所選伺服器連線」並非同一結論。若要確認分流情況,可搭配 Data 中可見的連線紀錄,核對目標與處理結果;實際顯示內容請以介面為準。

若暫時切換至代理 (Proxy) 後能存取同一目標,但在設定檔 (Config) 下失敗,應優先檢查目前的設定檔與規則,而不是繼續修改驗證資訊。若兩種模式都失敗,再依下一步檢查伺服器與本機網路。每次只變更一個條件,接著重新執行 Connectivity Test,並測試同一目標,才能判斷結果變化的原因。

也不要把列表中的延遲測試與 Home 的 Connectivity Test 混為一談。延遲結果會受 Test Method 與當時網路狀況影響,不能只憑單一數值認定伺服器適用於所有實際請求。正常完成流程的判斷方式是:開關維持開啟、測試結果可以解讀,且目標存取符合目前 Global Routing 與規則的預期。

本步完成標誌:你能分辨 App 連線狀態、測試結果與目標實際存取這三個層次。若三者符合預期,首次連線流程即可完成;之後需要整理訂閱、更新或備份時,再閱讀伺服器管理手冊,目前不必一次調整所有設定。

步驟 05

連線失敗,依層次檢查,每次只變更一個條件

遇到失敗時,先記錄目前的伺服器、Global Routing、使用的網路,以及是「開關無法維持開啟」、「測試失敗」還是「只有目標存取失敗」。不同現象對應的檢查位置也不同。保留既有設定,依下列順序逐步縮小範圍;不要一開始就刪除 App 或清空所有訂閱,以免同時失去判斷問題所需的資訊。

先檢查本機網路與伺服器選擇

暫時關閉連線,確認本機網路本身可以存取原本能直接連線的服務。若基礎網路需要先完成登入驗證,請先完成該流程。接著返回 Home,確認目前選取的是預期伺服器,而非同名的舊項目或其他訂閱中的項目。重新開啟連線後再測試。切換 Wi-Fi 與行動網路時請留意流量使用,並維持其他設定不變,觀察問題是否只發生於特定網路。

接著檢查訂閱有效性與協定參數

訂閱匯入失敗與伺服器連線失敗是兩回事。前者先檢查連結是否完整、載入結果與既有服務狀態;後者則開啟 Add Server 中相應項目的編輯頁面,逐項核對 Type、Host、Port、驗證資訊,以及既有資料要求的傳輸與 TLS 參數。大小寫、額外空格或遺漏欄位都可能影響連線,請勿套用其他協定的參數格式。若要長期修改訂閱產生的項目,請先了解更新是否會覆寫手動變更,詳情請參閱伺服器管理手冊。

最後檢查系統時間、規則與測試設定

使用 TLS 的連線請檢查裝置日期、時間與時區是否正確,必要時啟用系統的自動設定。若代理 (Proxy) 可用、但設定檔 (Config) 不可用,請返回 Config 檢查規則順序、目標符合的動作與最終處理方式。若只有特定目標失敗,也應確認目標本身是否正常,避免將遠端服務故障誤判為用戶端參數錯誤。

在 Settings 中可查看 Test Method 與 Diagnostics 等項目。確認測試方法後,使用相同方法重新比較,避免前後設定不同卻直接比較結果。Diagnostics 的資訊僅供輔助判斷,不應將每筆紀錄都視為故障結論;若要儲存資訊或回報給既有服務的提供者,請先遮蔽訂閱連結、伺服器位址及驗證資訊等敏感內容。

首次連線成功前,建議維持 On Demand 等自動行為設定不變,先使用 Home 的手動開關驗證基本流程。之後調整 On Demand 時,請個別觀察網路切換與連線觸發行為,避免將自動重新連線誤認為手動開關未生效。測試完成後,恢復日常需要的 Global Routing,並再次確認目標存取情況。

本步完成標誌:問題已定位至本機網路、授權、伺服器參數、規則或目標服務其中一個層次,或已取得可重現的失敗情況。若還要處理多個訂閱、更新、排序或備份,請前往伺服器管理手冊;若只是不理解介面用語,查閱術語表即可,不必為了一個詞重新設定整個用戶端。

Shadowrocket 官方 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:排查時確認 Test Method 與 Diagnostics;自動連線設定可等基本連線驗證後再調整。