官方手冊 / 初次設定

Shadowrocket 快速入門

從新增伺服器到驗證分流。依序操作,確認每一步的結果後再繼續。

步驟 01 / 準備伺服器

新增伺服器或匯入訂閱

開啟 Shadowrocket,進入底部的 Home。先確認手邊資料的類型:一條訂閱連結通常用來取得一組伺服器;單一伺服器的資料則會分別列出協定、位址、連接埠和驗證參數。兩種方式擇一即可,不必先手動新增,再透過訂閱重複匯入同一組項目。

手動新增:先選 Type,再填寫欄位

在 Home 點選右上角的加號,進入 Add Server。先在 Type 選擇資料中明確標示的協定,因為協定不同,接下來顯示的欄位也不同。以 Shadowsocks 為例,在 Host 填入伺服器網域名稱或 IP 位址,在 Port 填入連接埠;再填寫 Password,並在 Method 選擇服務商指定的方法。位址和連接埠分開填寫,不要將網址前綴、路徑或連接埠一併貼入 Host。複製參數後,檢查前後是否多出空格或換行。

確認各欄位與原始資料一致後儲存,返回 Home 查看 SERVER 下方是否出現該項目。如果只有位址和連接埠,卻不清楚 Type 或驗證參數,請先向服務商確認;不要用其他協定的範例值填補缺漏欄位。右側截圖中的 Scan QR Code 和 Import from Cloud JSON 是其他匯入入口,手動填寫時不必使用。

使用訂閱匯入:儲存後檢查 SERVER

如果取得的是訂閱連結,請在 Home 點選加號,在 Add Server 的 Type 中選擇 Subscribe,將完整連結貼到 URL 欄位後儲存。保留連結原有的路徑和查詢參數,不要改用服務商的登入頁面網址。返回 Home,等待訂閱載入,再到 SERVER 下方找到對應群組並查看其中是否有項目。訂閱連結可能包含存取憑證,請勿連同截圖或記錄公開傳送。

看到可選取的伺服器後,就可以繼續設定 Global Routing。若只看到群組名稱,裡面卻沒有伺服器,請先處理匯入問題;反覆切換連線開關不會讓空群組自動補上項目。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method 欄位及底部兩個匯入入口
Add Server:先確認 Type,再依協定核對欄位。

步驟 02 / 指定流量處理方式

選擇 Global Routing 模式

在 Home 點選 Global Routing。這裡決定用戶端接管連線後如何處理流量,不負責新增伺服器,也不會取代 SERVER 中選取的項目。若希望造訪不同目標時分別使用代理或直連,日常使用應選擇設定(Config),並確認所用的設定檔符合預期。

  • 設定(Config):依目前設定檔中的規則選擇策略。不同目標可以分別使用代理和直連,不必讓所有要求走相同路徑。
  • 代理(Proxy):讓用戶端處理的流量經由代理傳送。初次排查時可暫時切換到此模式,確認所選伺服器能否處理測試目標,再切回原模式。
  • 直連(Direct):讓用戶端處理的流量直接連線,不經由所選代理伺服器。適合用來對照,但不等於關閉 Home 的連線開關。

使用設定(Config)前確認目前檔案

Global Routing 中的 Config 是一種模式,底部的 Config 則是管理設定檔的頁面。選擇設定模式後,再前往底部的 Config 確認目前啟用的檔案。編輯頁面可看到 General、Rule 和 Hosts 等區段;初次連線只要確認查看的是目前使用的檔案,並進入 Rule 了解要測試的目標應使用哪種策略,不必點選 Add Rule 暫時修改規則。

初次驗證時,盡量不要同時修改規則和更換伺服器。兩處同時變動,即使目標恢復連線,也難以判斷是哪一項調整生效。選定模式後返回 Home,確認 Global Routing 顯示剛選擇的值,再開啟連線。

Shadowrocket 的 Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段及 Add Rule
Config:截圖為設定檔編輯頁面;模式仍需在 Home 的 Global Routing 中選擇。

步驟 03 / 建立連線

開啟 Home 的連線開關

返回 Home,在 SERVER 下方點選剛新增的伺服器。如果匯入的是訂閱,請先進入對應群組,再選取其中一個個別項目。清單中有伺服器不代表已選取預計測試的項目;操作前記下項目名稱,之後發生異常時才能回到同一項目重新測試。

點選 Home 頂部 Not Connected 旁的開關。首次連線時,系統可能會要求允許 Shadowrocket 新增 VPN 設定。確認要求是在剛才點選開關後由 Shadowrocket 發起,再允許;如果系統要求驗證裝置身分,請依系統提示在裝置上完成。這一步是讓系統允許用戶端建立連線,不需要在系統彈出視窗中填寫訂閱連結或伺服器密碼。

完成驗證後返回 Home,等待狀態更新。看到頂部從 Not Connected 變為 Connected 後,再檢查 Global Routing 是否仍是第二步選定的模式。如果已有其他 VPN 正在運作,請先在對應 App 中中斷連線,再返回 Shadowrocket 重試,避免將另一個連線的狀態誤認為本次結果。請勿為了測試而任意刪除裝置上既有的 VPN 設定。

如果先前點選了不允許,請返回 Home 重新開啟開關,查看系統是否再次提示。如果開關開啟後立即跳回,請勿連續點擊:記下是否出現彈出視窗、是否已允許,以及跳回發生在選取伺服器之前或之後,再依第五步找出原因。即使看到 Connected,也只能確認用戶端已建立連線;伺服器是否可用、特定目標是否依預期分流,仍需在下一步分別驗證。

Shadowrocket 的 Home 頁面,頂部為 Not Connected 開關,中間有 Global Routing 和 Connectivity Test,下方有 SERVER 群組與 Add Server
Home:先在 SERVER 選取項目,再操作頂部的連線開關。

步驟 04 / 檢查實際連線

透過 Connectivity Test 與實際要求交叉驗證

維持與第三步相同的網路、伺服器及 Global Routing 模式。在 Home 點選 Connectivity Test,等待本次結果返回,再確認對應項目是否為剛才選取的伺服器。出現結果表示該項目在目前測試方法下有回應,不代表每個網站都能正常連線;反之,單次逾時也不一定表示連線已中斷,測試目標本身也可能沒有回應。

依目前模式選擇測試目標

如果選擇的是設定(Config),請用瀏覽器分別開啟兩個熟悉的目標:一個依目前規則應使用代理,另一個應直連。對照時以規則實際比對的網域名稱為準;一個頁面可能也會向其他網域要求內容,因此頁面能開啟,不代表其中所有要求都使用相同策略。可以重新載入頁面,避免將已快取的內容當成新連線結果。若只想確認代理能否連線到某個目標,可維持同一伺服器,暫時切換到代理(Proxy)重試,再切回設定(Config)。

如果選擇的是直連(Direct),目前結果只用來確認目標在直連條件下是否可連線,不能作為代理成功的依據。測試結束後返回 Home,確認開關和模式符合日常使用需求。如果 Connectivity Test 有回應、實際目標也能連線,但仍無法確認規則比對到哪個項目,請查看使用手冊中的規則與連線驗證章節,不必因此重建訂閱。

步驟 05 / 找出故障環節

依現象排查常見連線問題

SERVER 沒有項目:先檢查匯入

訂閱群組為空時,先確認貼上的連結是否完整、Type 是否選擇 Subscribe,再確認裝置目前能否連線至網路。如果確認連結是最新的,但重新整理後仍沒有項目,請向服務商確認連結是否有效,以及傳回的內容是否適用於用戶端。手動新增後找不到項目,請返回 Add Server 檢查必填欄位是否完整、是否已完成儲存。看到個別伺服器後,才需要檢查連線模式。

開關跳回或自動重新連線:區分權限與依需求連線

如果未完成系統的 VPN 設定確認,請先從 Home 重新發起一次連線。若已允許 VPN 權限,但手動中斷連線後又自動連線,請進入 Settings 檢查是否啟用 On Demand。需要進行一次純手動對照時,可先記下原設定,再暫時停用 On Demand,返回 Home 重試;排查結束後依需求還原原設定。

已連線但測試失敗:先釐清失敗範圍

先確認一般網路連線是否正常,再核對 Home 中選取的伺服器與目前模式。如果只有 Connectivity Test 逾時,但實際連線正常,請在 Settings 查看 Test Method,避免直接比較不同測試方法的結果。如果測試與實際連線都失敗,可在條件允許時選擇另一個既有伺服器,以相同模式和目標重新測試。每次只變更一項,觀察是某個項目失敗,還是更換項目後仍出現相同現象。

如果只有一個目標無法連線,而且同一伺服器在代理(Proxy)下可以連線,切回設定(Config)後卻不行,請優先確認目前的設定檔及 Rule 比對順序。問題持續時,可在 Settings 中查看 Diagnostics,對照剛記錄的重現時間和現象。更多權限、匯入和路由排查方式,請參閱疑難排解。

Shadowrocket 的 Settings 頁面,列出 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:依據現象查看 Test Method、On Demand 或 Diagnostics。