官方手冊 · 首次連線
Shadowrocket 入門指南
從匯入現有訂閱到驗證規則分流,依序完成首次連線。
STEP 01
新增伺服器或匯入訂閱
開啟 Shadowrocket,進入底部的 Home,點選右上角的加號進入 Add Server。先確認手上的資料類型:訂閱連結用來同步一組伺服器;單一伺服器資訊則包含協定、位址、連接埠及相應的驗證參數。依資料類型選擇下列其中一種方式即可,不必先匯入訂閱再逐筆手動填寫。
已有訂閱連結:選擇 Subscribe
點選 Type,選擇 Subscribe,將向服務商取得的完整連結貼到 URL。若連結帶有問號及後續參數,應一併保留;通常只複製前面的網域會無法取得訂閱內容。儲存後回到 Home,等待訂閱同步,再展開對應群組查看項目。剛儲存時清單仍是空白,可在群組選單中手動更新一次,再依更新結果排查。
已有單一伺服器參數:依協定填寫
在 Type 選擇服務商標示的協定,例如 Shadowsocks 或 Trojan。將位址填入 Host,連接埠填入 Port;表單出現 Password、Method 或其他欄位時,依照資料逐項填寫。Host 不是訂閱連結,也不必把連接埠接在位址後方。切換 Type 會改變可填寫的欄位,不能把一種協定的參數套用到另一種協定。若服務商也提供 QR Code,可在 Add Server 中使用 Scan QR Code 匯入,再確認讀取的協定和位址是否屬於同一台伺服器。
儲存後回到 Home,在 SERVER 區域找到新項目,點選本次要使用的伺服器。清單中看得到項目,只代表資料已寫入;選取項目後,才會有下一步分流規則使用代理時的連線目標。先保持頂端開關關閉,再確認 Global Routing。
STEP 02
選擇 Global Routing 模式
在 Home 點選 Global Routing,依本次目的選擇模式。這裡設定的是用戶端如何處理要求,不會修改已選取的伺服器,也不是連線開關。首次準備依規則分流時,選擇設定檔(Config);需要分辨問題出在規則還是線路時,再暫時切換到另外兩種模式進行比較。
- 設定檔(Config)
- 依目前啟用的設定檔比對要求。規則給出的
PROXY、DIRECT或REJECT等結果,分別決定要求使用代理、直接連線或遭到拒絕。 - 代理(Proxy)
- 讓用戶端接手的要求都經由代理。可暫時用來確認同一個網址能否透過目前伺服器存取,測試完再切回平時需要的模式。
- 直連(Direct)
- 讓用戶端接手的要求直接連線。可作為存取同一個網址時的對照;選取此模式不代表已關閉頂端開關。
選擇設定檔(Config)後,點選底部的 Config 分頁,確認目前啟用的檔案。請留意兩個同名入口的差異:Global Routing 裡的 Config 決定依規則處理,底部的 Config 則用來管理實際讀取的設定檔。檔案清單中有多份設定時,以目前啟用的檔案為準,不要只看檔名或最近的編輯時間。
開啟目前設定檔的詳細資料,可在 Rule 中查看比對條件和對應策略。規則通常依序檢查:前面的規則已符合時,結尾的 FINAL 不會覆蓋結果。首次連線不必先點選 Add Rule。只要確認一個預計走 PROXY 的網址和一個預計走 DIRECT 的網址,留待第四步比較。如果還不確定設定檔中有哪些規則,可先使用代理(Proxy)完成連線測試,再回到設定檔(Config)檢查分流。
STEP 03
在 Home 開啟連線開關
回到 Home,先確認 SERVER 中選取的項目是否正確,再查看 Global Routing 列顯示的是否為剛才選定的模式。接著點選頂端 Not Connected 旁的開關。首次開啟時,系統可能提示新增 VPN 設定;確認提示是由 Shadowrocket 發起,再允許新增,並依裝置提示完成驗證。
返回 Home,等待頂端狀態從 Not Connected 變為 Connected。如果開關仍處於關閉狀態,先確認剛才的系統操作是否已完成,再嘗試一次;不要連續點選開關,否則很難分辨是系統仍在處理,還是剛開啟又被手動關閉。若裝置上已有其他正在執行的 VPN,請勿任意刪除其設定。在允許的情況下先結束目前連線,再回到 Shadowrocket 重試;受組織管理的裝置則應先向管理員確認限制。
Connected 代表用戶端已啟動連線,不表示所選伺服器已通過測試,也不代表每個網頁都經過代理。尤其在設定檔(Config)模式下,部分要求直連原本就是預期結果。首次確認時先使用手動開關,暫不調整 On Demand,如此在切換網路或從背景返回時,比較容易分辨連線狀態是否由本次操作造成。
接下來維持目前的網路和伺服器,先在 App 內測試一次,再用瀏覽器驗證。如果剛開啟開關就立刻回到 Not Connected,可直接跳到第五步的系統權限與開關排查,不必先修改規則。
STEP 04
使用 Connectivity Test 與網頁驗證
在 Home 點選 Connectivity Test,等待測試完成,再查看本次選取伺服器的結果。測試成功表示該伺服器在目前網路下通過這次偵測;即使顯示耗時,也無法據此判斷目標網頁一定能開啟。測試失敗時,先確認測試對應的是哪台伺服器,並確認裝置本身的網路可用,不要只因一次逾時就立即重寫設定。
接著開啟瀏覽器,造訪第二步從設定檔中選出的兩個網址:先開啟預期走 PROXY 的網址,再開啟預期走 DIRECT 的網址。使用相同的完整網址重新載入,並留意頁面是否轉址到其他網域;轉址後發出的要求會依新網域個別比對。網頁中來自其他網域的圖片、指令碼也可能採用不同策略,因此「網頁開啟了」只能說明瀏覽結果,無法單獨證明整個頁面的流量都經過代理。
結果不如預期時,固定網路、伺服器和測試網址,每次只切換 Global Routing。若同一網址在代理(Proxy)下可存取,在設定檔(Config)下無法存取,請優先檢查目前設定檔、目標網域與規則順序。若代理(Proxy)和直連(Direct)都失敗,先確認網址、目前網路和目標網站狀態,不能只憑現象判定是規則錯誤。
STEP 05
依問題現象縮小排查範圍
訂閱已儲存,但清單空白
先展開 Home 中的訂閱群組,確認不是處於收合狀態。若仍是空白,回到訂閱項目檢查 Type 是否為 Subscribe,確認連結開頭、結尾和查詢參數完整,再手動更新一次。若更新時提示連結失效或存取遭拒,請向服務商確認訂閱狀態。請勿將完整連結貼到公開場合:連結中的參數可能足以存取你的訂閱。
開關剛開啟就跳回,或中斷後又自動連線
若開關立即跳回,先確認已完成系統的 VPN 設定授權,且沒有其他 VPN 正在占用連線。若中斷後又自動連線,請在底部開啟 Settings 中的 On Demand,檢查目前網路是否符合已設定的觸發條件。為了驗證手動開關,可暫時關閉隨選連線,維持相同網路再試一次;確認原因後,再依實際需求恢復原設定。
顯示 Connected,但要求失敗
若多台伺服器的測試結果都異常,先比對 Settings 中的 Test Method,確認前後使用的是相同測試方法,再回到 Home 重新測試。如果只有個別伺服器失敗,先重新確認其協定、位址、連接埠和驗證參數;如果只有切換到設定檔(Config)時失敗,請檢查對應網域是否符合較早的規則,或未符合任何前置規則而落到 FINAL。
若需進一步定位,可前往 Settings 開啟 Diagnostics 查看診斷資訊。只記錄重現問題所需的網路類型、使用模式、失敗環節和錯誤提示;對外求助前請遮蔽伺服器驗證欄位和訂閱連結。分流關鍵字、授權提示及其他問題可參閱常見問題;商店地區、正版確認和換機還原請參閱正版指南。