Shadowrocket · 官方手冊

Shadowrocket 使用教學

新增伺服器或匯入訂閱,選擇 Global Routing,連線後驗證分流結果。

01 / Server

新增伺服器或匯入訂閱

先判斷手上的資料屬於哪一種。若已有一組協定、位址、連接埠和驗證資訊,請手動新增伺服器;若服務商提供用來同步伺服器清單的訂閱連結,請使用 Subscribe。可在瀏覽器中開啟的連結不一定是訂閱網址:若開啟後顯示帳號登入頁或服務說明頁,請回到自己的服務商確認連結類型。

已有伺服器資訊:使用 Add Server

開啟 Home,在 SERVER 分組找到 Add Server。先點選 Type,選擇資料上註明的協定,再填寫介面顯示的欄位。Host 填寫伺服器主機名稱或位址,Port 單獨填寫,請勿將位址和連接埠一起貼入 Host。Password、Method 等欄位是否出現取決於 Type;請以手上的資料為準,不要套用其他協定的參數。

若手上的是單台伺服器的 QR Code,可使用 Add Server 底部的 Scan QR Code 讀取,再確認辨識出的協定、名稱和位址。Import from Cloud JSON 有其匯入用途,請勿用它取代 Subscribe。儲存前檢查複製內容的開頭與結尾是否多出空格或換行;若伺服器資料帶有參數,請勿擅自刪除其中一段。

已有訂閱連結:使用 Subscribe

在 Add Server 中開啟 Type,選擇 Subscribe,將完整訂閱連結填入對應的位址欄,再儲存。返回 Home 等待清單更新;若儲存後暫時只看到訂閱來源而沒有伺服器項目,請先檢查該訂閱的更新結果。訂閱網址可能包含存取憑證,請勿將完整連結貼在公開留言中,也不要連同位址欄或 QR Code 一起截圖分享。

此階段的完成標誌是:Home 的 SERVER 分組中至少出現一筆可選的伺服器記錄。看見記錄只代表資料已寫入用戶端,尚無法判斷伺服器能否連線。下一步先設定流量處理方式,再測試連線。

Shadowrocket Add Server 介面,顯示 Type、Host、Port、Password 和 Method 欄位
在 Add Server 先選擇 Type,再確認該類型所需的欄位。底部可找到 Scan QR Code。

02 / Routing

選擇 Global Routing 模式

在 Home 找到 Global Routing,點開查看三個選項。選擇模式前,先確認這次要驗證什麼:日常使用通常需要驗證某條規則是否生效;首次連線一台伺服器時,可能只需要確認能否透過它存取目標。兩種目的不必使用相同模式。

設定(Config)
依照目前設定的規則處理請求。適合讓不同目標分別走 PROXY、走 DIRECT 或執行 REJECT。測試結果取決於目前啟用的設定及其規則順序。
代理(Proxy)
使用所選伺服器處理流量。首次連線時可用來驗證代理路徑,避免將規則選擇和伺服器連線狀態混為一談。測試完成後切回日常使用的模式。
直連(Direct)
流量不經所選的代理伺服器。適合在同一個網路上進行對照;即使頁面能夠開啟,也不能據此判斷代理伺服器可用。

選擇設定(Config)時,還要進入底部的 Config 頁面確認啟用的是哪個檔案。Home 裡的 Config 表示依規則處理流量;底部的 Config 是檢視和編輯設定檔的入口,兩者不是同一個開關。右圖展示的是檔案編輯頁,用來定位 Rule 和 Add Rule,不是 Global Routing 的模式選單。

首次操作建議先使用原有設定完成驗證,不必同時新增規則、修改 DNS 和更換伺服器。若發現目標未走預期路徑,再檢查 Rule:通常先符合的適用規則會決定策略,FINAL 則處理未命中前置規則的請求。條件寬泛的規則若放在前面,可能讓後面更具體的規則無法生效。編輯前請先保留原設定,方便還原。更多規則寫法請參閱完整使用手冊。

Shadowrocket Config 設定檔編輯介面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config 設定檔編輯頁。若要確認規則內容與順序,請從 Rule 開始。

03 / Connection

在 Home 開啟連線

返回 Home,先在 SERVER 分組選定要測試的一筆記錄,再確認 Global Routing 顯示的是剛才選定的模式。匯入訂閱後可能出現多筆名稱相近的記錄,首次測試請先固定一筆;否則切換網路或模式後,很難判斷變化來自哪個項目。

確認這兩項後,開啟 Home 頂部 Not Connected 旁的開關。首次啟用時,系統可能會提示新增 VPN 設定。這是系統允許 Shadowrocket 接管相應網路流量的步驟。確認提示來自剛才開啟的 Shadowrocket,再依系統提示授權;完成後返回 Home,等待開關狀態穩定。若剛才取消了提示,可返回 Home 重新發起連線。

若開關立即回到中斷狀態,請先記下螢幕提示,不要連續點擊開關。若裝置正在執行其他 VPN 設定,或是由組織管理的裝置,請先確認是否有連線衝突或系統政策限制。請勿為了測試而移除組織下發的設定;受管理裝置上的授權問題應由裝置管理員確認。

Home 顯示已連線,只代表用戶端已啟動連線所需的系統通道,不等同於某個目標網站已經走 PROXY。下一步請保留目前的伺服器和網路,分別檢查伺服器測試結果與實際瀏覽結果。

Shadowrocket Home 介面,顯示 Not Connected 開關、Global Routing、Connectivity Test 與 SERVER 分組
在 Home 先選定 SERVER 項目並確認 Global Routing,再開啟頂部開關。

04 / Verification

驗證連線與規則是否生效

先測試伺服器,再開啟目標網頁

保持使用同一個 Wi-Fi 或 Cellular 網路,在 Home 執行 Connectivity Test,觀察所選伺服器是否有回應。測試失敗時,先記下出現的是逾時還是其他提示,不要只憑一次結果就刪除記錄。測試成功也只代表目前的測試方法得到回應,不代表所有網站、App 或協定都已可用。

接著在瀏覽器中重新載入平常使用、且能確認是否正常的網頁。不要只看連線前已開啟的分頁:快取或先前建立的連線可能讓舊頁面繼續顯示。可以開啟新分頁,主動重新整理,確認頁面內容確實重新載入。

用兩個目標檢查 Config 的分流

若選擇設定(Config),請從目前規則中找出兩個熟悉的目標:一個預期走 PROXY,另一個預期走 DIRECT。分別重新發起連線,並在介面有相應記錄時使用 Diagnostics 對照請求網域和實際策略。兩個網頁都能開啟,只能代表它們可以存取;路徑是否不同,應以策略記錄為準。留意輸入的網域是否發生轉址,也不要把頁面中的圖片或其他資源請求誤認為主頁面請求。

若要區分伺服器問題和規則問題,可以暫時切換至代理(Proxy),對同一個目標再測試一次,並保持伺服器、網路和目標不變。若代理(Proxy)下可用、設定(Config)下失敗,請優先檢查啟用的設定檔與規則命中情況;若兩種模式都失敗,再回頭檢查伺服器資料和網路。若要確認基本網路狀況,可用直連(Direct)進行對照。測試結束後,請還原日常使用的模式。

也可以開啟 Data,比較瀏覽前後是否有流量變化。此方式適合確認是否有流量經過用戶端,但流量增加不能單獨證明某條規則已命中。記下測試時的模式、所選伺服器和結果,發生故障時就能直接重現這組條件。

05 / Diagnostics

依失敗現象逐項排查

從最早失敗的步驟開始檢查。清單中還沒有可選伺服器,就先處理匯入;伺服器已選定、開關卻無法開啟,就先檢查系統授權。只有在建立連線後,才需要透過瀏覽網頁和規則記錄判斷分流。

訂閱已儲存,SERVER 中沒有可選記錄

返回訂閱項目檢查網址是否完整,尤其是複製時容易遺漏的查詢參數。確認連結是自己的服務商提供給用戶端使用的網址,而不是登入頁連結。若現有設定可正常使用,請先保留,不要為了解決一次更新失敗而刪除整份設定。若同一訂閱多次回傳空白內容或更新錯誤,請記下錯誤提示,再向自己的服務商確認網址是否仍有效。

無法開啟連線,或剛開啟又中斷

先確認首次連線的 VPN 設定提示是否已處理,再確認目前網路在中斷 Shadowrocket 時,能否正常存取熟悉的直連網站。若 Wi-Fi 還需要登入,請先依網路要求完成登入,再返回 Home 測試。若手動中斷後過一段時間又自動連線,請到 Settings 查看 On Demand 是否啟用及相關觸發條件;自動重新連線和手動連線失敗是兩種現象,應分開判斷。

顯示已連線,但測試或網頁瀏覽失敗

先比對 Type、Host、Port 和驗證欄位,再從相同入口重新執行 Connectivity Test。到 Settings 查看 Test Method,記下目前的測試方式;不同方式的結果不能直接比較。若測試成功但只有某些網域失敗,請在 Diagnostics 中先區分網域解析異常與策略命中異常。若出現解析錯誤,請核對目前設定的 DNS 設定;若請求命中非預期策略,請返回 Config 檢查 Rule 和 FINAL,不要同時修改 DNS 與規則。

每次只修改一項,修改後用同一個目標重新測試。仍無法判斷時,可前往 FAQ 查找相應現象;若需要保留排查記錄,只要記下裝置類型、連線方式、模式與錯誤提示即可,並先遮蔽伺服器位址、驗證資訊、訂閱連結和 QR Code。

Shadowrocket Settings 介面,顯示 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings 中的 Test Method、On Demand 和 Diagnostics 分別用於確認測試、自動連線和診斷資訊。