官方手冊 / 首次使用

Shadowrocket 使用教學

從已有訂閱到連線驗證,依五個步驟完成首次設定。先讓一台伺服器正常連線,再調整規則與自動連線。

建議依序操作。已完成匯入的使用者,可直接從 Global Routing 開始;需要整理多個訂閱、備份或批次更新時,請前往節點管理手冊。

步驟 01 / 先讓伺服器出現在清單中

Add Server / Subscribe:新增與匯入

先確認手上的資訊類型:用來更新伺服器清單的網址是訂閱連結;包含 Type、Host、Port 與驗證欄位的一組資訊,通常用於手動新增。兩者的入口不同,不要把訂閱網址直接填入 Host,也不要只憑連結開頭猜測協定。請以服務商提供的說明為準,保留原始資訊,方便之後逐項核對。

使用 Subscribe 匯入已有訂閱

開啟 Config,找到 Subscribe 入口並新增已有訂閱,填入方便辨識的名稱,將完整連結貼到對應網址欄位後儲存。貼上時檢查首尾是否有空格、換行或中文標點,尤其不要漏掉問號後方的參數。接著執行更新,等待結果返回,再回到 Home 查看 SERVER 群組中是否出現伺服器項目。只儲存網址,不代表已成功取得伺服器清單。

如果更新後清單仍是空的,先查看更新回覆,不要反覆建立相同訂閱。連結過期、缺少驗證參數、目前網路無法存取訂閱網址,都可能導致更新失敗。可以請服務商確認連結狀態,但不要將完整連結貼到公開截圖或討論區;其中的參數可能代表個人存取權限。

使用 Add Server 手動填寫

只有單一伺服器資訊時,請從 Home 的 SERVER 群組進入 Add Server。先選擇 Type,再填寫對應欄位,因為 Type 會影響後續所需的驗證方式。以截圖中顯示的欄位為例,Host 填伺服器網域或位址,Port 填連接埠,Password 與 Method 依原始資訊填寫。Host 通常不是網頁網址,不應附帶頁面路徑;Port 應與伺服器端一致,不能用測試連接埠取代連線連接埠。

不同協定的欄位並不相同。選擇 VMess、VLESS、Trojan 或 Hysteria2 後,如果出現額外驗證或傳輸選項,請依該協定的資訊填寫,不能把所有驗證值都當成 Password。伺服器位址與 TLS 相關名稱也可能不同,缺少欄位時應先確認原始設定,而不是嘗試關閉相關檢查。

已有 QR Code 時,可使用 Add Server 底部的 Scan QR Code,允許相機存取後掃描並核對匯入結果。Import from Cloud JSON 用於相應的 JSON 設定,不是一般訂閱網址的替代入口。如果系統提供剪貼簿匯入提示,請先確認剪貼簿內容確實是自己的分享連結再繼續;匯入完成後,同樣檢查 Type 與位址是否符合預期。

儲存後返回 Home,確認新項目出現在 SERVER 清單,並設定容易辨識的名稱。此時只完成「新增」,尚未確認連線可用。下一步先選擇 Global Routing,再選取伺服器並開啟連線,避免將規則問題誤判為匯入失敗。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method,以及底部的 Scan QR Code 與 Import from Cloud JSON
Add Server:先選擇 Type,再依已有的伺服器資訊填寫對應欄位。

步驟 02 / 決定如何處理請求

Global Routing:選擇三種模式

返回 Home,點選 Global Routing,依目前需求選擇設定(Config) / 代理(Proxy) / 直連(Direct)。這三個選項決定流量的處理方式,不會取代伺服器資訊,也不會修復已失效的訂閱。首次使用時,應先了解所選模式,再判斷某個頁面是否應經過代理。

設定(Config):依目前規則分流

已有明確的設定檔時,選擇設定(Config),並前往 Config 確認目前啟用的是預期檔案。設定中的 Rule 決定符合條件的請求交由哪種策略處理:DIRECT 表示直連,REJECT 表示拒絕,PROXY 表示交由相應代理策略。規則通常依序比對,前面的符合結果會影響後續處理,因此不能只確認某一條規則是否存在。

截圖顯示的是 Config 中的設定檔編輯頁面,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。這不是填寫 Subscribe 網址的頁面。首次連線不需要逐段修改,也不需要開啟 HTTPS Decryption;先使用已確認用途的設定,之後再逐項了解。修改前請保留原設定副本,以便還原。

代理(Proxy)與直連(Direct):用於確認連線路徑

代理(Proxy)可用於檢查所選伺服器的代理路徑是否正常,但仍需另外考量系統保留的流量或設定中的略過項目,不應理解為所有資料都一定經過相同路徑。直連(Direct)用於不經代理的存取,也適合對照基礎網路狀況;選取 Direct 後能開啟一般網頁,不代表伺服器已成功連線。

不確定現有規則是否影響結果時,可以暫時使用 Proxy 進行一次對照測試,記錄結果後再恢復原本的 Config。不要為了排錯同時更換設定、切換伺服器並修改 DNS,否則無法判斷是哪個項目造成影響。確認好模式後,再進入下一步開啟連線。

Shadowrocket 的 Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段與 Add Rule
Config:確認目前使用的設定;首次連線時不必修改編輯頁面的所有區段。

步驟 03 / 選取伺服器,再開啟開關

Home:建立連線

返回 Home,在 SERVER 群組中點選準備使用的伺服器,確認目前選取標記指向剛才核對過的項目。如果訂閱包含多台伺服器,先選一台進行驗證,首次測試時不要頻繁切換。接著確認 Global Routing 仍是預期模式,再開啟頁面頂端的連線開關。

首次使用時,系統可能會提示允許新增 VPN 設定。確認操作是由剛開啟的 Shadowrocket 發起後,依系統提示允許,並使用裝置密碼或系統提供的驗證方式完成確認。如果取消此步驟,用戶端便無法建立所需的系統連線;請返回 Home 重新開啟開關,而不是重複匯入伺服器。

完成授權後返回 Home,觀察頂端狀態是否從 Not Connected 變更為連線狀態,以及開關是否維持開啟。若開關立即關閉,先記下提示文字,再檢查系統授權與伺服器欄位。狀態維持開啟只代表系統連線流程已啟動,不能據此認定所有目標頁面都已能存取,後續仍須透過 Connectivity Test 與實際請求驗證。

測試期間盡量維持網路環境穩定,例如先在同一個 Wi-Fi 下完成驗證。需要從 Wi-Fi 切換到行動網路時,請等網路穩定後再重試,避免將切換當下的失敗誤認為設定錯誤。裝置上的其他 VPN 連線也可能改變目前狀態;排查時請先確認目前啟用的是哪個系統連線。

首次手動連線成功前,暫時保留 On Demand 的原有設定。它用於自動觸發連線,不會補上缺少的驗證欄位,也不適合用來掩蓋手動連線失敗。需要停止連線時,返回 Home 關閉頂端開關,並確認狀態恢復為 Not Connected。

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

步驟 04 / 分開判斷狀態與結果

Connectivity Test:確認是否生效

保持連線開啟,在 Home 點選 Connectivity Test,等待測試完成。測試結果用於判斷測試目標與測試方式下的連通狀況,不代表所有網站、所有協定的整體結果。某項測試失敗時,不要立即刪除已匯入的訂閱,應繼續透過實際請求交叉檢查。

  1. 先確認基礎存取。使用瀏覽器開啟平時可存取的一般頁面並重新載入,避免只看到快取內容。如果連基本頁面也無法開啟,先關閉連線進行對照,確認 Wi-Fi 或行動網路本身是否正常。
  2. 再檢查預期路徑。開啟一個依目前設定應由代理處理的頁面。若使用 Config,先確認規則會將此請求交由代理處理,而不是 DIRECT;否則頁面能否開啟,無法證明代理連線是否正常。
  3. 最後比較模式。同一台伺服器在 Proxy 下可用、在 Config 下不可用時,優先檢查設定是否已啟用、規則順序與策略指向。兩種模式都失敗時,再檢查伺服器資訊與服務狀態。

記錄時至少保留目前網路、所選伺服器的辨識名稱、Global Routing 模式、測試時間與具體錯誤。不要只記錄「無法連線」,因為無法開啟網頁、訂閱更新失敗、測試目標逾時是三種不同問題。每次只變更一個條件,再重複相同請求,才能取得可比較的結果。

確認手動連線與日常存取都正常後,再考慮 On Demand、細化規則或整理多個訂閱。訂閱更新成功不代表伺服器可用,連線開關開啟也不代表每條規則都符合預期。

步驟 05 / 由外而內,每次只改一項

Settings / Diagnostics:常見問題

完成前四個步驟後仍有問題,請依照「基礎網路 → 匯入結果 → 伺服器欄位 → 模式與規則 → 測試設定」的順序檢查。先處理最外層條件,避免一開始就在 Settings 嘗試大量不相關的開關。修改前先記下原值;若確認沒有改善,請還原設定,保留清楚的排錯流程。

訂閱更新失敗或沒有伺服器

返回 Config 的 Subscribe,檢查網址是否完整、參數是否保留,以及是否誤貼了說明文字。確認基礎網路正常後,再更新一次並查看回覆訊息。如果服務商已更換訂閱網址,應修改原有訂閱紀錄,而不是繼續重複嘗試舊網址。更新結果為空時,先確認服務狀態,不要立即刪除所有舊項目,以免失去比對資訊。

開關可以開啟,但無法存取

先返回 Home 確認 SERVER 中實際選取的是哪一台,再開啟對應編輯頁面,核對 Type、Host、Port 與驗證值。手動輸入時特別注意全形符號、首尾空格與英文字母大小寫。如果使用額外的傳輸或 TLS 設定,也應逐項對照原始資訊,不要隨意降低安全設定碰運氣。

確認欄位一致後,使用同一台伺服器在 Proxy 與 Config 下分別提出相同請求。如果只有 Config 失敗,請在 Config 檢查目前檔案與 Rule 的策略指向;如果兩者都失敗,再換一台自己已有的伺服器進行比對,並向服務商確認服務是否正常。更換伺服器是為了診斷比對,不代表應該重建所有原有設定。

Connectivity Test 與瀏覽器結果不一致

進入 Settings 查看 Test Method,確認測試方式適用於伺服器端環境。某些探測方式失敗,不代表實際網頁請求一定失敗;反過來說,探測成功也不能證明網頁涉及的所有資源都可用。請保留瀏覽器顯示的實際錯誤,搭配 Diagnostics 中與該次請求相關的資訊判斷,不要只根據單一測試結果調整整套設定。

使用 Diagnostics 記錄問題時,盡量只保留能重現問題的一次操作。對外提供記錄前,請遮蔽訂閱網址、驗證欄位與個人存取內容。不要公開完整設定檔;確實需要比對欄位時,只展示欄位名稱與已遮蔽的值。

連線自動開啟,或切換網路後發生異常

在 Settings 檢查 On Demand 是否已啟用,以及自動連線條件是否符合預期。排查時可暫時關閉自動觸發,返回 Home 手動連線驗證;確認正常後再還原原有設定。TCP、UDP 等項目不是通用的修復按鈕,沒有明確證據時請保留原值。需要有系統地整理更新策略、備份與刪除流程,請繼續閱讀訂閱與伺服器管理手冊,首次使用時不必一次完成所有進階設定。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP 設定項目
Settings:排錯時重點檢查 Test Method、On Demand 與 Diagnostics,依問題選擇項目。

完成標準:已有伺服器已匯入、Global Routing 符合預期、手動連線成功,並通過實際頁面驗證。之後遇到問題,可從驗證步驟重新比對,不必先清除設定。