官方手冊 · 初次設定
Shadowrocket 使用說明
先將現有伺服器或訂閱匯入用戶端,再選擇路由模式並開啟連線。最後分別檢查伺服器測試和實際連線,確認結果符合預期。
在 Add Server 新增伺服器或匯入訂閱
開啟 Shadowrocket,在 Home 的 SERVER 區域找到 Add Server。先確認手上的資料:若只有單台伺服器的位址、連接埠和驗證參數,請手動新增;若取得的是用來更新一組伺服器的訂閱連結,則使用 Subscribe。兩種方式擇一即可,不必先建立手動紀錄再匯入訂閱。
已有單台伺服器:先確認 Type
進入 Add Server 後,點選 Type,依資料上註明的協定選擇,例如 Shadowsocks 或 Trojan。接著確認 Host 和 Port:位址與連接埠分別填入對應欄位,不要將完整連結貼到 Host。下方欄位會隨 Type 改變,出現 Password 或 Method 時,依照已有參數填寫;未提供的選填參數不要套用其他紀錄。貼上後檢查前後空格,尤其不要連同聊天訊息中的引號、句號或換行一起貼入。
若收到明確用於匯入伺服器的 QR Code,可使用 Scan QR Code 掃描;出現相機權限提示時,再決定是否允許。辨識後仍須確認 Type 和位址,不要將掃描成功視為已連線。手上沒有對應的雲端資料時,不必點選 Import from Cloud JSON。確認後儲存,返回 Home,找到剛新增的項目。
已有訂閱連結:使用 Subscribe
在 Add Server 的 Type 清單中選擇 Subscribe,將原始訂閱連結完整貼到連結輸入欄位,再儲存。若連結帶有查詢參數,不要刪除問號後的內容,也不要使用聊天軟體顯示的省略版本。返回 Home,確認訂閱群組及其中的伺服器項目已出現;如果只看到群組而沒有項目,先依照介面提供的更新操作重新取得,再查看是否顯示錯誤。訂閱網址可能包含存取憑證,遇到錯誤時記下提示文字即可,不要公開完整連結。
項目出現表示用戶端已收到伺服器資訊,不代表伺服器一定可用。先在 SERVER 點選這次要使用的項目;若匯入了多個同名項目,請依群組和位址辨識,避免只看名稱而選錯。接下來決定哪些連線應經過這台伺服器。
在 Global Routing 選擇路由模式
返回 Home,點選 Global Routing。這裡決定連線如何分配,不負責匯入伺服器。已有明確的分流設定時,選擇設定(Config);若要暫時確認所選伺服器能否代理一般連線,可用代理(Proxy)進行比較;若要確認目前網路不經代理伺服器時能否連線,則用直連(Direct)作為基準。進行比較前,記下原本的選項。
- 設定(Config):由目前啟用的設定檔決定比對結果。同一次瀏覽中,主網站請求與圖片、登入介面等其他網域的請求可能採用不同路徑,這是依連線進行比對的結果。
- 代理(Proxy):由用戶端接管的流量會依代理模式處理,適合短時間比較。某個網站在此模式下可以連線,不代表它在設定(Config)下也一定符合代理規則。
- 直連(Direct):由用戶端接管的連線不經過代理伺服器。適合與代理結果比較,但不等同於關閉
Home頂部開關;若要停用連線,應返回Home關閉開關。
使用 Config 時,確認目前生效的檔案
Global Routing 中的 Config 是模式,底部的 Config 則是管理檔案的頁面。設定模式後,再開啟底部的 Config,確認目前啟用的是預期檔案。點開檔案看到編輯頁,只表示正在查看該檔案,不代表已將它設為目前設定。先確認啟用狀態,再進入檔案的 Rule 查看規則;初次連線不必修改 Hosts 或 HTTPS Decryption。
需要確認特定網域時,從清單前端往下查看,先找較早符合的規則,再看末尾的 FINAL 如何處理未符合前置規則的連線。例如網域雖然符合後面的 DOMAIN-SUFFIX,但前面已有符合的規則,就不能只根據後面的規則推斷結果。初次設定以檢視規則為主,不必點選 Add Rule。想進一步了解規則順序和動作,可參閱Shadowrocket 完整使用手冊。
離開設定後,重新查看 Home 上的 Global Routing 摘要,確認顯示的是剛選擇的模式。如果這次只是在測試連線,不要同時切換伺服器和設定檔;保留一個已知條件,之後才容易判斷是哪項設定造成結果改變。
開啟 Home 開關並確認 VPN 權限
在 Home 確認兩處:SERVER 中這次要使用的項目,以及 Global Routing 顯示的模式。若頂部仍顯示 Not Connected,請點選旁邊的連線開關。開啟前最好先確認裝置能正常使用目前的 Wi‑Fi 或行動網路;需要登入的公共 Wi‑Fi,請先完成網路本身的登入,再回來測試連線。
初次啟動:在系統提示中確認來源
如果 iPhone 或 iPad 顯示新增 VPN 設定的系統提示,先確認提示確實是剛才開啟開關所觸發,再依照系統指示允許;裝置可能要求透過生物辨識或解鎖密碼確認。授權應在系統提示中完成,伺服器資訊和裝置解鎖密碼是不同類型的資料。首次允許新增 VPN 設定,是為用戶端建立連線提供系統權限,不會驗證你的訂閱,也不會改變 Global Routing 的選擇。
若剛才選擇不允許,返回 Home 後發現開關沒有保持開啟,可以再次發起連線,讓系統重新顯示提示。若提示始終沒有出現,先到系統設定搜尋 VPN,查看是否已有設定,以及公司或學校的裝置管理政策是否限制修改。受管理的裝置應向管理員確認,不要刪除無法辨識的設定或裝置管理項目。
授權後返回 Home,等待狀態切換完成。開關保持開啟,表示用戶端已啟動連線;但這不能證明所選伺服器可連線,也不能表示某個網站是透過代理連線。如果開關一開啟就關閉,記下提示原文和當時的網路類型,直接依照失敗情況排查處理,不必反覆開關。狀態穩定後,再進行下一步驗證。
使用 Connectivity Test 和實際連線交叉驗證
驗證分為三個層次:開關是否保持開啟、所選伺服器是否通過本次測試、目標網站是否能依預期連線。前一層通過後才有必要檢查下一層,但不能用前一層的結果取代後一層。
- 確認測試對象。在
Home確認選取的伺服器後,點選Connectivity Test,等待本次測試完成,查看對應項目的結果。不要把其他項目留下的數值當成目前項目的結果。測試有回應,表示在目前網路和測試條件下收到回應;這不是實際下載速度,也不保證所有目標都能連線。 - 開啟實際要使用的網站。在瀏覽器開啟平常可正常連線的網站,重新載入頁面,確認看到的不是舊分頁中快取的內容。若日常使用設定(Config),再選一個能依目前規則判斷處理方式的網站,確認實際結果。只開啟一個平常就能直連的頁面,無法分辨連線究竟是直連還是經過代理。
- 結果不一致時進行單項比較。保持相同網路、相同伺服器和相同目標位址,只在需要時短暫切換設定(Config)、代理(Proxy)或直連(Direct),每次都以相同方式重試。若代理(Proxy)可以連線、設定(Config)不行,先檢查目前檔案和規則順序;若直連(Direct)也無法開啟平常可連線的頁面,先檢查目前網路或目標網站。測試完後恢復日常使用的模式。
依失敗階段檢查權限、伺服器和設定
先回到第一個未得到預期結果的步驟,不必重新安裝或清除設定。開關無法開啟,優先處理權限;開關穩定但沒有測試回應,優先檢查選取的伺服器;測試有回應但連線異常,再檢查路由和目標網站。每次只修改一項,完成後返回 Home,重新執行上一節的相同檢查。
開關關閉,或關閉後連線又重新出現
開關關閉時,先確認是否完成系統 VPN 授權,再檢查裝置上是否有其他正在使用的 VPN。個人裝置若確認可以暫時中斷另一條連線,可中斷後再試;不要直接刪除設定。反過來說,若手動關閉後更換網路時又自動連線,請開啟 Settings 查看 On Demand 是否設定了觸發條件。排查期間可暫時停用自己設定的隨選連線,確認完後再依原本需求恢復。
匯入後沒有項目,或測試一直沒有回應
訂閱群組為空時,返回訂閱紀錄確認原始連結是否完整,並確認更新時裝置本身可以連線;若更新顯示錯誤,請向既有服務提供者確認連結狀態。手動新增的項目若一直沒有測試回應,返回該項目逐一確認 Type、Host、Port 和驗證資訊。不要靠修改驗證參數碰運氣。若只有某筆紀錄失敗,而同一群組的另一筆在相同條件下通過,先處理該筆紀錄;若所有項目在同一網路都失敗,請換用已知可用的網路進行比較。
在 Settings 中確認 Test Method,比較測試結果時盡量使用相同方法。測試方式不同,結果可能不同,不能直接比較兩次顯示的數值。仍需進一步確認時,可在 Diagnostics 查看與重現時段相關的資訊;分享排查資料前,先遮蔽訂閱連結、密碼、帳號和不宜公開的位址。
測試有結果,但部分頁面仍無法開啟
先確認問題是否只出現在單一網域或頁面的一部分。頁面可以開啟但登入或圖片載入失敗時,主頁面和失敗資源可能屬於不同網域。返回 Config 查看目前檔案中是否有較早符合的規則,再檢查 FINAL;不要一看到異常就將所有連線改走代理。若切回原設定後恢復正常,請保留原設定,並記錄是哪項變更影響結果。關於規則細節、Data 和日常維護,可繼續閱讀完整使用手冊。