官方手冊 / 快速入門

Shadowrocket 匯入訂閱與首次連線

首次設定只需完成三件事:匯入現有資料、選擇分流模式、確認實際瀏覽狀況。無須先編輯設定檔,也不必一次新增多筆伺服器。

01 / ADD SERVER

新增伺服器或匯入訂閱

開啟 Shadowrocket,進入 Home,在 SERVER 分組中找到 Add Server。先確認手邊資料的形式:若有一組獨立的位址、連接埠與驗證參數,請以單筆伺服器方式新增;若服務提供者給的是用來取得項目的連結,則以訂閱方式匯入。兩種方式擇一即可,首次連線不必重複輸入。同一份資料無論以哪種方式新增,都應保留原有通訊協定與參數,不要根據截圖猜填欄位。

有單筆伺服器資料:先選 Type

進入 Add Server 後,先在 Type 選擇資料中註明的通訊協定,例如 Shadowsocks 或 Trojan。所選通訊協定會決定後續欄位。一般先填寫 Host 和 Port,再依介面補上 Password、Method 或該通訊協定所需的其他參數。Host 填入提供的伺服器位址,Port 填入獨立的連接埠;不要把整條訂閱連結拆開填進這兩個欄位。如果有與該伺服器對應的 QR Code,也可以使用 Scan QR Code 匯入,再核對通訊協定與位址。欄位資料不齊全時,先向資料提供者確認,不必嘗試填入其他通訊協定的參數。

有訂閱連結:選擇 Subscribe

在 Add Server 中將 Type 設為 Subscribe,將原始訂閱連結完整貼到連結輸入欄,再儲存。連結中問號之後的部分也可能是載入項目所需的資訊,不要自行刪減,也不要將連結傳到公開聊天室或截圖中。回到 Home,等待對應分組出現可選項目;如果只出現分組名稱,展開後仍沒有項目,請先處理訂閱載入問題,不要將空分組當成伺服器連線。儲存只代表資料已輸入,不代表用戶端已連線。看到可選項目後,再繼續選擇分流模式。

Add Server 介面,顯示 Type、Host、Port、Password、Method 與底部掃描入口
Add Server · 先選擇 Type,再填寫該通訊協定要求的欄位。
02 / GLOBAL ROUTING

選擇 Global Routing 模式

返回 Home,點選 Global Routing。這個入口決定用戶端如何處理要求,不負責新增伺服器,也不會替你開啟連線。首次打算依規則使用時,請選擇設定(Config);如果只是想判斷某個要求經過代理與直接連線有何差異,再暫時切換另外兩種模式進行比對。

  • 設定(Config):使用目前設定檔中的規則。不同要求可以分別符合 PROXY、DIRECT 或 REJECT,因此開啟開關後,並非所有要求都會經過所選伺服器。
  • 代理(Proxy):讓用戶端處理的要求經過代理路徑。可用此模式比對瀏覽結果,判斷異常是否只在依規則分流時出現;驗證結束後,記得切回日常使用的模式。
  • 直連(Direct):讓用戶端處理的要求直接連線,不經過代理伺服器。適合用來比對,但與關閉頂端開關不同:切換至 Direct 不代表停止用戶端連線。

選擇設定(Config)後,回到 Config 確認目前啟用的是預期檔案。可以開啟該檔案查看 General、Rule、Hosts、URL Rewrite 等區段;圖中的 Add Rule 是編輯規則的入口,不是首次連線必須操作的按鈕。尤其要區分 Home 中的 Config 模式與底部的 Config 頁面:前者會讓規則參與分流,後者用於查看或管理檔案。在 Config 頁面開啟檔案查看,也不代表已將它設為目前啟用的檔案。

如果已經有可用設定,首次連線時先保留原樣。不要為了驗證單一目標而清空 Rule,或將所有規則改成相同策略,否則之後很難分辨是伺服器、設定還是目標本身發生變化。需要了解規則順序與 FINAL 時,再查看設定欄位參考;現在回到 Home,準備連線。

Config 檔案編輯介面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config · 查看目前檔案的 Rule 區段,無須先新增規則。
03 / HOME

在 Home 開啟連線開關

在 Home 的 SERVER 中選取剛新增的伺服器;如果匯入的是訂閱,先展開對應分組,再選取其中一個項目。確認名稱或備註與手邊資料相符,避免誤用舊項目。接著查看 Global Routing 目前的值,確認沒有停留在僅供比對的直連(Direct)。此時再開啟 Home 頂端的開關。點選伺服器項目與點選連線開關是兩個獨立動作,只完成前者不會啟動連線。

首次開啟開關時,系統可能會提示新增 VPN 設定。確認提示是剛才在 Shadowrocket 中開啟開關所觸發,再依裝置提示允許;若系統要求驗證身分,請使用裝置本身的驗證方式。完成後回到 Home,等待開關穩定,查看頂端是否已離開 Not Connected 狀態。如果不小心取消提示,回到 Home 後先確認開關狀態,再嘗試開啟一次;如果仍立即切回中斷狀態,請前往排查常見問題,不要連續反覆點按。

看到連線已建立,只能確認裝置端的連線已啟動。這不能證明所選伺服器能瀏覽特定目標,也不能證明某條規則已符合要求。先讓裝置維持在目前的 Wi-Fi 或行動網路,不要在連線時切換網路;保持伺服器與 Global Routing 不變,下一步分別檢查測試結果與實際瀏覽狀況。

Home 介面頂端顯示 Not Connected 開關,下方有 Global Routing、Connectivity Test、SERVER 和 Add Server
Home · 選取 SERVER 項目,再操作頂端開關。
04 / CONNECTIVITY TEST

透過測試與實際瀏覽確認連線

在 Home 點選 Connectivity Test,查看所選項目是否能傳回測試結果。先區分兩種結論:開關穩定開啟,表示裝置端連線已啟動;測試有結果,表示目前測試方式取得了回應。無論結果顯示有回應或逾時,都只反映當時的測試條件,不能據此判斷所有網站或應用程式都能否瀏覽。不要只憑一次測試結果就更換整份訂閱或設定。

接著開啟一個平時能穩定瀏覽、且你知道預期分流方式的頁面,重新載入一次。不要將已顯示在畫面上的舊頁面當成成功;請重新載入並確認確實取得新內容。如果預期使用 Config 分流,最好分別選擇一個預期走 DIRECT 的目標,以及一個預期走 PROXY 的目標進行驗證。即使兩個頁面都能開啟,也只能確認瀏覽成功;若要確認實際符合的規則,應對照目前檔案的 Rule 順序,不能只根據頁面是否開啟來推斷策略。

如果同一個目標在設定(Config)下失敗,可以暫時改為代理(Proxy),使用相同網路、相同伺服器與相同目標重新測試;必要時再切換至直連(Direct)比較。只有 Config 失敗時,優先查看目前設定檔與符合順序;Proxy 也失敗而 Direct 正常時,優先核對伺服器資料與測試結果。三種模式都失敗時,先檢查基本網路與目標本身是否可用。記下在哪種模式成功或失敗,再切回預期模式,帶著結果進入下一步。

05 / SETTINGS

依故障現象排查並重新測試

訂閱已儲存,但 SERVER 沒有項目

先確認匯入時選擇的是 Subscribe,再檢查貼上的連結是否包含換行、遺漏結尾字元,或誤用了服務提供者的登入頁面位址。回到 Home 查看分組是否已載入;如果分組一直是空的,請向原服務提供者確認連結是否仍有效。手動新增的項目若能顯示但無法連線,請回到該項目的編輯頁核對 Type、Host、Port 與驗證參數。訂閱更新失敗與單筆伺服器連線失敗是不同問題,重新安裝用戶端通常不是第一步。

開關跳回,或手動中斷後又自行連線

如果開關無法開啟,先檢查首次 VPN 設定提示是否已完成,再確認系統是否有另一個 VPN 連線正在執行。如果開關可以關閉,但切換 Wi-Fi 或行動網路後又恢復連線,請到 Settings 查看 On Demand。記下原始設定;若裝置允許調整,可在手動測試期間暫時關閉自行設定的隨選連線,重新測試後再恢復。這樣可以分別觀察手動開關與隨選條件觸發的結果。

連線穩定,但瀏覽結果不一致

先根據上一步的比對結果判斷問題範圍。只有設定(Config)失敗時,從目前啟用的檔案與 Rule 順序查起;Connectivity Test 與代理(Proxy)瀏覽都失敗時,再核對所選伺服器與目前網路。到 Settings 查看 Test Method,先記下使用的測試方式,避免將不同測試條件下的結果直接比較。需要查看診斷資訊時,可從 Diagnostics 開始;分享截圖或診斷內容前,請遮住訂閱連結與驗證資訊。

每次只修改一處,然後依序「檢查開關 → 執行測試 → 重新載入同一頁面」進行複測。即使問題仍存在,也能將故障範圍縮小至資料輸入、裝置連線或瀏覽路徑中的一層。若要進一步檢查 DNS、規則或其他連線異常,請查看連線問題問答;遇到不熟悉的通訊協定或設定名稱,請先查閱術語表。

Settings 介面,列出 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings · 從 Test Method 或 On Demand 核對測試與連線條件。

DOWNLOAD / 全平台取得

依裝置取得 Shadowrocket