官方手冊 · 入門指南

Shadowrocket 入門指南

依「匯入 → 選擇模式 → 連線 → 驗證 → 排除問題」的順序操作。本教學以 iPhone / iPad 介面為例,先完成一次可供檢查的連線,再調整規則與自動連線設定。

01 新增與匯入

開啟 Shadowrocket 後,先進入 Home。匯入方式取決於手上的資訊類型:包含多個伺服器、可更新的位址,通常屬於伺服器訂閱;只有單一伺服器的協定參數,則適合手動新增。兩種方式最後都需要在 Home 的 SERVER 清單中顯示可選取的伺服器。先判斷資訊類型再選擇入口,比反覆貼到不同頁面更容易找出問題。

Add Server:伺服器訂閱

在 Home 點選右上角的加號,進入 Add Server。開啟 Type,已有伺服器訂閱連結時選擇 Subscribe,並在 URL 貼上向服務商取得的完整連結。填入方便辨識的備註後儲存,返回 Home 等候取得結果。不要刪除連結中的問號、等號或參數,也不要連同聊天訊息中的引號與換行一起複製。

取得成功後,應該能在 Home 看到訂閱群組及其中的伺服器。展開群組,確認不是只有空白標題。出現伺服器清單,代表內容已解析完成,但不表示伺服器目前可用;下一步仍須選取伺服器並進行測試。如果取得失敗,請先保留錯誤提示,確認連結是否完整、是否過期,以及目前網路能否連線至訂閱位址;不要先修改路由規則。

Add Server:手動填寫

如果取得的是單一伺服器參數,同樣從 Home 的加號進入 Add Server,並在 Type 中選擇實際協定,例如 Shadowsocks、VMess、VLESS 或 Trojan。接著依服務商提供的資訊逐項填寫位址、連接埠、密碼或其他認證欄位;若有 TLS、SNI 或傳輸設定,也應依原始資料填寫。不同協定需要的欄位不同,不要因名稱相似就互換參數,也不要自行猜測缺少的值。

儲存後返回 Home,找到剛才新增的伺服器並點選。若提供的是 QR Code,可以使用 Scan QR Code 匯入;使用前請確認 QR Code 來自你自己的服務商,辨識後仍須檢查協定與位址。無論採用哪種方式,本步完成的標誌都是:SERVER 下有一個與你的資料相符、可供選取的項目。

確認匯入結果後,暫時保留一個明確的測試伺服器。先不要同時調整訂閱更新、規則與 On Demand,下一步只需決定請求應如何處理。

02 選擇路由模式

返回 Home,點開 Global Routing。這裡決定的是請求處理方式,不是伺服器清單,也不是連線開關。即使已選取伺服器,不同模式下的請求仍可能經由不同路徑。初次操作先記住三種模式:設定(Config)/代理(Proxy)/直連(Direct),選好後返回 Home,確認 Global Routing 顯示剛才選取的項目。

  • 設定(Config):依目前啟用的設定與規則,決定請求採用哪種策略,適合已備妥規則設定的日常使用。
  • 代理(Proxy):將通常可代理的請求交由所選代理路徑處理,適合短時間比對測試;不代表每一種系統流量都一定經過代理。
  • 直連(Direct):讓請求直接連線至目標,用於檢查本地網路或暫時直連;無法用來驗證代理伺服器是否正常運作。

準備使用 Config 時,先進入底部的 Config 頁面,確認已有一份已選取並啟用的設定。僅將設定下載至清單中,不代表它已成為目前使用的設定;請查看選取標記。若已有可信任的遠端設定位址,可透過該頁的 Subscribe 取得,再選用對應設定。不要為了建立連線而隨意貼上陌生規則,也不要以為伺服器訂閱會自動取代完整的規則設定。

如果目前只想確認伺服器參數能否建立有效連線,可以先選擇 Proxy,再完成後續連線與網頁測試。驗證成功後再切回 Config,使用同一個網頁重新測試,如此便能區分「伺服器連線問題」與「規則選擇問題」。若 Proxy 可用而 Config 下某個網頁無法開啟,應優先檢查設定與命中策略,而不是立刻刪除伺服器並重新匯入。

理解設定時,先掌握三個策略名稱即可:PROXY 表示交由代理策略處理,DIRECT 表示直接連線,REJECT 表示拒絕請求。Global Routing 的 Proxy 與規則中的 PROXY 有關聯,但前者是整體模式,後者是單條規則的策略值。此時不必編輯規則語法;若要深入了解比對順序、FINAL 與設定結構,再閱讀規則參考。

選好模式後,返回 Home 再確認一次選取的伺服器。接著開啟連線開關,讓系統建立 VPN 設定對應的網路處理通道。

03 開啟連線

在 Home 的 SERVER 清單中點選準備測試的伺服器,確認選取標記位於預期項目上,再開啟頁面頂端的連線開關。訂閱群組名稱只是管理入口,實際用於此次連線的是個別伺服器。同一群組中若有多個名稱相近的項目,請先記住目前的選擇,後續排查時保持一致,以免以為只變更了模式,實際上連伺服器也一併更換。

首次啟用時,iPhone / iPad 可能會顯示系統要求,詢問是否允許新增 VPN 設定。確認要求來自剛才操作的 Shadowrocket 後,依提示允許並完成裝置要求的認證。這個步驟是授予用戶端處理網路流量所需的系統權限,不是匯入訂閱,也不會替你補齊伺服器密碼。拒絕或取消後,連線可能無法繼續;請重新開啟開關並完成授權。

完成系統提示後返回 Home,觀察開關是否維持開啟,以及頁面是否出現連線狀態變化。不同裝置的狀態列中,VPN 標示位置可能不同,不必只憑某個角落有沒有圖示來判斷。更重要的是開關能否維持開啟、系統 VPN 狀態是否已連線,以及下一步的實際請求能否正常完成。

若開關剛開啟就立即關閉,先不要反覆快速點按。請檢查是否取消了系統授權、是否有另一個正在運作的 VPN 設定,或裝置管理政策是否限制新增 VPN。可以到系統 Settings 查看 VPN 相關狀態,確認沒有互相衝突的連線,再返回 Shadowrocket 重試一次。受管理的裝置應依裝置管理員允許的範圍處理,不要刪除不明的管理設定。

此次驗證期間先不要啟用新的 On Demand 條件。On Demand 用於依條件自動連線,與目前的手動連線不是同一個步驟;太早加入自動化條件,可能在測試時遇到自動重新連線或狀態變化,難以判斷原因。先完成手動連線與網頁驗證,之後再到術語手冊了解其用途。

開關開啟只是驗證的起點。這表示系統通道已嘗試建立,不代表伺服器認證、DNS 解析以及目標網站連線都已成功。請保持用戶端目前狀態,繼續下一步;看到 VPN 狀態後不要直接結束檢查。

04 驗證是否生效

先返回 Home,使用 Connectivity Test 檢查伺服器連線能力。測試會依其設定的方式與目標通訊,結果適合用來找出明顯失敗的項目,但只涵蓋此次測試路徑。出現延遲數值不代表所有網頁都能開啟;測試失敗也須一併考量測試方式、本地網路與伺服器狀態,不要只憑單一結果修改所有設定。

接著開啟瀏覽器,造訪一個你已知正常且符合目前用途的網頁,等待主要內容載入完成,再試著開啟其中一個一般連結。使用同一個網頁反覆比對,避免一次造訪甲網站、下一次造訪乙網站,將目標網站本身的問題誤認為用戶端問題。如果瀏覽器顯示的是先前快取的內容,請重新載入頁面再觀察。

如果目前使用 Proxy,先確認在所選伺服器下能否完成實際連線。接著切換至 Config,再造訪同一個網頁。如果兩次結果不同,就已縮小問題範圍:伺服器未必失效,可能是目前設定讓該網域走 DIRECT、命中 REJECT,或設定中的某項策略沒有可用目標。此時不要同時更換伺服器和修改 DNS,否則比對結果將失去意義。

若要進一步確認連線路徑,開啟 Data 中目前可用的連線紀錄,留意剛才造訪的網域、時間與策略資訊。紀錄中的欄位可能因介面而異,請依實際顯示內容判斷。在 Config 模式下,有些請求直連、有些請求代理,本來就是分流結果;不要直接把「並非所有連線都使用代理」當成故障。

若紀錄中顯示規則或策略,先確認採用的是 PROXY、DIRECT 還是 REJECT,再決定是否需要調整。規則通常依序比對,前面的規則命中後,後面的規則不會重新選擇。此處先記下實際情況即可,具體寫法與順序請參閱規則參考;初次使用不必立刻修改整份設定。

完成驗證後,記下三項結果:目前使用哪個伺服器、Global Routing 選擇了什麼,以及實際連線是否成功。如果以上都符合預期,再將模式恢復為你打算長期使用的狀態。暫時使用 Proxy 測試後,請依需求切回 Config;若尚未成功,則依照下方的失敗環節繼續檢查。

05 常見問題排除

排查原則:每次只變更一個條件,並使用同一個網頁重新測試。先確認問題發生在匯入、開啟連線或網頁連線階段,再檢查對應環節。直接重設所有設定會失去有效線索,也容易讓一個參數錯誤變成多個問題。以下順序適用於剛完成前述操作,但結果仍不如預期的情況。

先確認本地網路

暫時關閉 Shadowrocket 的連線開關,檢查裝置原本的網路能否正常連線。公共 Wi-Fi 若需要先登入認證頁面,請先完成該步驟。必要時可在 Wi-Fi 與行動網路之間比對一次;切換後保持伺服器與模式不變。如果本地網路本身無法使用,繼續更新訂閱或修改規則通常沒有幫助,應先恢復基本連線。

匯入失敗或清單空白

重新確認連結是否完整、是否誤複製了訊息說明文字,以及是否將伺服器訂閱填入 Config 的遠端設定入口。若先前正常、現在更新失敗,可能與連結失效、認證變更或伺服器回傳內容變動有關,請向服務商確認。不要為了驗證連結而將完整位址貼到不明的線上工具,連結可能包含身分認證參數。

有伺服器但連線失敗

確認選取的是實際伺服器,再核對協定、位址、連接埠、認證資訊,以及 TLS 和傳輸設定。手動填寫時,密碼前後的空格、錯誤的連接埠或遺漏 SNI 都可能造成失敗。若資訊來自訂閱,請先依服務商提供的方式更新一次,不要直接修改不理解的欄位。裝置日期與時間也應正確,否則某些憑證驗證可能受到影響。

測試正常但網頁無法開啟

此時分別檢查 Global Routing 與 DNS。先記下目前模式,暫時使用 Proxy 造訪同一個網頁;若恢復正常,再檢查 Config 中的規則與策略。若不同模式都無法開啟網頁,但 Connectivity Test 有結果,可能與網域解析、目標網站、伺服器轉送能力或傳輸條件有關,不能只憑延遲判定一定是 DNS 問題。請改用另一個已知正常的網頁比對,再參閱DNS 解析失敗排查。

整理可供檢查的結果

問題仍未解決時,記下失敗步驟、錯誤提示、使用的網路類型、協定、選取的模式,以及切換網路前後的差異。分享截圖或記錄前,請移除訂閱位址、伺服器密碼、認證識別資料及其他敏感資訊。向服務商確認伺服器端狀態時,只提供排查所需的資訊,不要公開完整訂閱內容。

手動連線穩定後,再逐步開啟訂閱自動更新、調整規則或設定 On Demand。每完成一項就重新進行一次網頁驗證,並保留可正常運作的設定。如此一來,後續發生問題時可以回復到上一個已驗證的狀態,不必從匯入步驟重新開始。