官方手冊 · 快速上手
Shadowrocket 快速上手
匯入現有伺服器或訂閱,選擇分流模式,再分別驗證伺服器與網頁瀏覽情況。
步驟 01 · 匯入
在 Add Server 新增伺服器或匯入訂閱
開啟 Shadowrocket,停留在 Home。從右上角的加號,或 SERVER 分組中的 Add Server 進入新增頁面。先辨認手邊的資料:一組位址、連接埠和驗證參數對應單一伺服器;用來取得伺服器列表的連結則是訂閱;服務提供者提供的伺服器 QR Code 可透過掃描入口新增。同一份資料只需選擇一種匯入方式,不必把連結拆開填入單一伺服器的欄位。
手動填寫:先選 Type,再填參數
點開 Type,選擇資料中明確標示的協定。以 Shadowsocks 為例,將主機名稱或 IP 位址填入 Host,連接埠填入 Port,密碼和加密方法分別填入 Password 與 Method。不要把含連接埠的完整位址填進 Host,也不要用其他伺服器的密碼或加密方法補填。不同協定的欄位也會不同;如果欄位與資料明顯不符,請先返回 Type 核對,再繼續填寫。若要了解欄位含義,請參閱協定詳解。
訂閱或 QR Code:保留原始內容
如果已有訂閱連結,請在 Type 中選擇 Subscribe,將完整連結貼到連結欄位後儲存。連結末尾的查詢參數也是連結的一部分,不要為了縮短文字而刪除。若已有伺服器 QR Code,請在新增頁面使用 Scan QR Code,依照系統提示允許相機存取後對準 QR Code,確認辨識出的內容與自己持有的資料一致。不要將含有密碼、訂閱參數或 QR Code 的完整頁面傳到公開管道。
儲存後返回 Home,確認 SERVER 下方出現新增項目,或訂閱分組展開後確實列出伺服器。看到訂閱分組名稱,不代表列表已成功取得。若分組是空的,請先在目前網路下確認連結是否完整、是否仍有效;等列表中出現可選伺服器後,再進入下一步。
步驟 02 · 分流
在 Global Routing 選擇處理模式
伺服器出現在列表後,從 Home 點進 Global Routing。這個選項決定「如何處理流量」,而不是「選擇哪台伺服器」。第一次依照步驟驗證時,請先記下所選模式,返回 Home 核對該行顯示的名稱。之後若要進行對照,請盡量不要同時更換伺服器或網路,否則很難判斷是哪項變更影響結果。
- 設定檔(
Config) - 依照目前生效的設定檔規則處理要求。部分要求可能透過代理、部分可能直連,也可能符合拒絕策略。若已有可用的規則設定檔,並要檢查日常分流情況,請選擇此項。不要把能開啟某個網頁直接當成符合代理規則的證據。
- 代理(
Proxy) - 讓由此模式處理的流量透過所選代理伺服器。若想先檢查代理連線、不讓目前設定檔中的分流規則影響判斷,可暫時切換至此項測試。對照結束後,請恢復平時使用的模式。
- 直連(
Direct) - 讓由此模式處理的流量直接連線,不經過代理伺服器。適合用來對照裝置目前的網路能否存取同一個網頁。即使連線開關已開啟,直連結果也不能用來判斷所選伺服器是否可用。
區分同名的 Config 模式與 Config 頁面
Global Routing 裡的 Config 是一種處理模式,底部的 Config 則是檢視和管理設定檔的頁面。首次連線不需要點選 Add Rule,也不必修改 General 或 Hosts。若之後發現某個網域走了非預期的路徑,請返回目前生效的設定檔查看 Rule,確認是否已有較前面的規則符合,以及未符合時會套用哪條預設策略。規則關鍵字請查閱術語手冊。
步驟 03 · 連線
在 Home 選擇伺服器並開啟連線
返回 Home,展開包含目標伺服器的 SERVER 分組,點選要使用的項目。透過項目旁的圓點確認目前選擇,尤其是多個項目名稱相近時;不要把展開分組或看到測試數值誤認為已選取伺服器。首次測試只選擇一台自己能辨認的伺服器;接下來會將該項目的結果與網頁瀏覽情況互相比對。
處理首次連線時的系統提示
確認伺服器和模式後,開啟 Home 頂部的連線開關。第一次操作時,iPhone 或 iPad 可能會詢問是否允許新增 VPN 設定。請先確認提示是由剛才操作的 Shadowrocket 發出,再依照系統提示繼續;如果系統要求裝置身分驗證,完成後返回 Home 查看狀態。若先前取消授權,請先確認開關是否已關閉,不要把彈出視窗消失當成授權完成。
開啟開關後,觀察頂部狀態是否仍顯示 Not Connected,或是否短暫變化後立即恢復。若裝置原本已有其他 VPN 正在執行,請先確認用途;在允許調整的裝置上,可以先中斷自己啟用的其他連線再試。若工作或學校管理的裝置限制 VPN 設定,請聯絡裝置管理員,不要移除管理設定來嘗試連線。
介面顯示已連線時,請先保留這組伺服器和模式,不要立即切換項目。系統連線建立只代表連線已啟動,並不表示伺服器可連線或規則符合預期。下一步分別檢查伺服器測試和實際網頁瀏覽,就能區分這幾種狀態。
步驟 04 · 驗證
執行 Connectivity Test,再驗證網頁瀏覽
留在 Home,點選 Connectivity Test,等待測試完成,再查看帶有圓點的伺服器項目對應的結果。不要用列表中其他伺服器的結果推斷目前連線。測試有回應,表示該項目通過這次探測;逾時或失敗則表示這次探測未得到預期結果。數值與測試方式、測試目標及目前網路有關,不代表下載速度,也無法證明每個網站都能存取。
接著開啟瀏覽器,在不更換 Wi-Fi 或行動網路、不切換伺服器和模式的情況下,瀏覽平時能開啟的一兩個網頁。盡量開啟需要重新載入的頁面,不要只查看之前已開啟的頁面。若要核對 Config 下的實際分流,也要確認所測網域預期套用哪種策略;只看網頁能否載入,無法分辨流量走的是 DIRECT 還是 PROXY。
步驟 05 · 排查
依伺服器、模式、DNS 與規則找出故障點
開始排查前,記下發生問題時的網路、伺服器項目、Global Routing 模式與情況。先分辨是列表未匯入、開關無法維持開啟、測試失敗,還是只有某個網頁無法開啟。每次只變更一個條件,修改後使用同一網頁或同一種測試再次確認;若沒有改善,請還原該項原設定,再繼續檢查下一項。
先確認伺服器與基礎網路
列表空白時,請返回新增步驟,檢查訂閱連結是否完整、訂閱是否成功取得內容。列表有項目但所選項目反覆測試失敗時,請核對 Type、Host、Port 及該協定所需的驗證參數。如果自己的列表中還有另一台已知可用的伺服器,可在模式和網路不變的情況下進行一次對照。若切換到 Direct 後,連平時能開啟的網頁也無法存取,請先處理目前的 Wi-Fi 或行動網路,例如確認 Wi-Fi 是否需要登入,再測試代理。
再檢查模式、DNS 與規則
若 Direct 正常、代理測試也有回應,但特定網頁在 Config 下無法開啟,請先確認目前使用的是哪一份設定檔。多個網域都無法解析時,可優先確認 DNS 設定最近是否變更;只有特定網域受影響時,則檢查 Rule 中是否符合非預期的策略,例如先遇到 REJECT,或沒有符合特定規則而套用 FINAL。這些情況只是排查線索,不能直接作為結論。編輯前請保留原設定檔,不要為了測試一個網頁而整段刪除規則。
最後查看 Settings 中的相關項目
若測試結果前後難以比較,可前往 Settings 核對 Test Method,確認不是更換測試方式後直接比較兩次結果。若關閉開關後又自動連線,可檢查 On Demand 是否啟用了符合目前網路的條件。若要進一步找出問題,請查看 Diagnostics;若要轉述錯誤訊息,請只摘錄與問題相關的內容,並先移除伺服器位址、密碼和訂閱連結。更多復原方式請參閱常見問題。