官方手冊 首次連線 · 五步檢查

Shadowrocket 使用教學

從既有訂閱或伺服器資料開始,依序完成匯入、選擇 Global Routing、連線與驗證。

以下步驟依操作順序排列。若已完成匯入,可直接跳至 Global Routing;若連線開關已開啟但網頁無法瀏覽,請從驗證步驟開始檢查。

第一步:Add Server 與訂閱匯入

開啟 Shadowrocket,進入 Home。先確認手上的資料類型:可取得伺服器清單的訂閱連結,或包含位址、連接埠、協定與驗證參數的單一伺服器資料。兩種資料的填寫方式不同。請勿將訂閱連結填入伺服器位址欄,也不要將單一伺服器的分享內容當成 Subscribe 位址。開始時可先保持連線開關關閉,避免尚未檢查完參數就切換裝置網路。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的加號,進入 Add Server。開啟 Type,選擇 Subscribe,然後返回填寫頁面,將自己的完整訂閱連結貼到 URL。填入方便辨識的備註後儲存。連結中的查詢參數可能用於識別訂閱,請勿自行刪除問號後面的內容;複製時也要檢查開頭與結尾,避免包含聊天說明、換行或空格。

儲存並完成訂閱更新後,返回 Home 查看伺服器清單。正常情況下會顯示訂閱群組及其中的伺服器項目,而不只是留下名稱。點選其中一台伺服器,將其設為目前選取項目。如果只看到群組卻沒有伺服器,請先檢查訂閱更新是否顯示失敗;此時反覆切換連線開關無法補齊清單,應先解決訂閱讀取問題。

訂閱連結屬於敏感資料,請勿公開傳送完整連結,也不要將包含連結的頁面截圖交給無關人員。後續訂閱內容變更時,更新對應訂閱即可。手動修改訂閱產生的項目可能在下次更新時被覆蓋,因此不要將臨時調整視為已儲存的長期配置。

已有單一伺服器:選擇相應協定

如果手上的是單一伺服器參數,同樣從 Home 的加號進入 Add Server,但 Type 應選擇資料標示的協定,例如 Shadowsocks、VMess、VLESS 或 Trojan。依原始資料填寫位址、連接埠與驗證欄位。需要 TLS、傳輸方式或其他附加參數時,也應逐項對應;不要只憑連接埠數字推測協定,更不要將不同協定的驗證欄位互相替換。

若持有 QR Code,可使用 Scan QR Code 讀取既有伺服器資料。匯入後仍須開啟項目,檢查協定、位址與連接埠是否完整;QR Code 成功辨識不代表伺服器一定可連線。儲存後返回 Home,選取剛新增的項目。到這裡,應能明確確認目前選取的是哪台伺服器,再進入下一步決定哪些請求使用它。

訂閱與單一項目可以同時存在,但首次設定建議只使用一份已確認有效的資料完成驗證。不要一次匯入大量內容,再靠隨機切換判斷結果。關於訂閱更新、重複群組與參數欄位的更多說明,請參閱問答。

第二步:選擇 Global Routing

伺服器項目決定可使用哪條連線路徑,Global Routing 則決定請求如何選擇路徑。在 Home 點選 Global Routing,檢查目前模式。本教學統一使用配置(Config)/代理(Proxy)/直連(Direct)三種寫法,對應介面中的 Config、Proxy、Direct。切換後返回 Home,再確認顯示的是剛才選取的模式,避免記憶中的設定與實際狀態不一致。

配置(Config):依目前配置規則處理

配置(Config)適合依規則區分請求去向。使用前進入 Config,確認目前選取的是準備使用的配置,而不只是清單中有一份同名檔案。伺服器訂閱與規則配置並非同一件事:匯入伺服器清單不代表已匯入完整規則,也不代表所有網站都會自動使用所選伺服器。

規則通常依序比對,前面的命中結果會影響後續處理。PROXY、DIRECT 與 REJECT 代表不同動作,不能只看規則中是否出現某個網域。初次使用時先保留已了解用途的配置,確認正常瀏覽後再進行修改。若尚未弄清楚 Config 中的規則,不要藉由疊加多份配置來嘗試修復連線。

代理(Proxy):檢查所選伺服器連線

代理(Proxy)可用於暫時減少規則差異,觀察所選伺服器能否完成實際請求。這適合用來定位問題,不代表必須長期使用此模式。如果代理(Proxy)下目標頁面可以開啟,但配置(Config)下失敗,應優先檢查目前配置與規則,而不是立即重新輸入伺服器密碼。測試結束後,應依實際需求切回準備使用的模式。

直連(Direct):檢查裝置基本網路

直連(Direct)用於檢查不經過代理伺服器時的網路狀況。選擇此模式不能驗證伺服器是否可用;即使用戶端開關處於開啟狀態,請求也可能依直連方式處理。若要檢查代理連線,請勿停留在直連(Direct)模式,僅根據開關顏色下結論。

首次驗證時可先檢查基本網路,再用代理(Proxy)驗證伺服器,最後回到配置(Config)檢查規則。此順序將問題拆分為三個層次,每次只變更一個條件。規則順序、FINAL 與 DNS 的詳細關係,待基本連線成功後再閱讀疑難排解手冊,不必在首次連線前逐項調整。

第三步:開啟開關並完成授權

返回 Home,依序確認已選取伺服器項目、Global Routing 符合測試目的,且訂閱清單沒有尚待處理的錯誤。接著開啟 Home 頂端的連線開關。首次連線時,系統可能顯示新增 VPN 配置的提示。閱讀提示並確認是由目前操作觸發後,選擇允許,再依系統要求完成裝置驗證。

系統授權是讓用戶端建立網路連線配置,不是填寫訂閱帳號的地方。請勿將伺服器密碼輸入裝置解鎖驗證,也不要因為出現系統提示就反覆刪除並重新安裝 App。完成授權後返回 Shadowrocket,等待連線狀態穩定。若取消系統提示,App 可能回到未連線狀態;重新發起連線並完成授權即可繼續檢查。

開關保持開啟只代表連線流程進入相應狀態,不表示所有目標都能瀏覽。狀態列中的 VPN 標記也不能取代網頁驗證,部分裝置版面上的標記顯示位置可能不同。下一步仍須同時檢查伺服器測試與實際請求,不能把單一標記當成全部完成的依據。

如果開關剛開啟就立即關閉,先確認是否已完成系統授權,再檢查裝置是否有其他正在執行的 VPN 配置或裝置管理限制。暫時停止其他連線後再測試,避免多個配置同時嘗試接管網路。受管理裝置若限制新增 VPN 配置,應依裝置管理要求處理,不要用連續重試掩蓋系統限制。

首次手動連線尚未驗證成功時,先不要同時調整 On Demand。自動觸發連線的條件會增加觀察變因,例如中斷後又自動連線,容易被誤認為開關失效。先分別驗證手動連線與中斷,再依需求設定 On Demand。iPad 上的操作順序相同;橫向或分割畫面只會影響頁面呈現,不會改變先確認項目、再選擇模式、最後連線的順序。

第四步:驗證連線與規則結果

連線後先在 Home 執行 Connectivity Test,觀察目前伺服器是否回傳測試結果。測試可提供連線狀況的線索,但不保證連線品質。某項測試失敗可能與測試目標或伺服器設定有關;某次測試有回應,也不能證明所有網站都正常。因此應繼續開啟瀏覽器,造訪實際需要使用的頁面,確認是否能載入新內容。

先檢查基本網路,再檢查伺服器

如果結果不明確,先中斷用戶端連線,造訪平時可直接開啟的頁面。若基本網路本身無法使用,請先處理 Wi-Fi 登入驗證、行動網路或路由器連線,再返回用戶端。如果基本網路可用,重新選取原本的伺服器,使用代理(Proxy)完成一次連線,再次造訪目標頁面。檢查時保持網路環境不變,避免同時切換 Wi-Fi、伺服器與模式。

瀏覽器已開啟的頁面可能來自快取,現有 App 連線也可能沿用切換前的路徑。重新測試時重新載入頁面,必要時關閉原頁面後再開啟,確保產生新的請求。不要只憑頁面仍停留在螢幕上,就認為新配置已生效;也不要只憑某個 App 短暫轉圈,就判斷所有連線都失敗。

回到配置(Config)驗證分流

代理(Proxy)下可以瀏覽後,切換到配置(Config),使用相同伺服器與相同目標再測一次。若只有此時失敗,請進入 Config 檢查選取的配置與規則順序;在可查看連線記錄的位置,留意目標網域對應的比對動作與實際去向。應確認請求是否依預期使用 PROXY 或 DIRECT,而不是只看規則文字是否包含目標名稱。

若只有特定網域失敗,還需要區分網域解析、規則動作與遠端連線。首次排查時先記錄錯誤網域、目前模式與錯誤狀況,不要立刻改寫所有 DNS 設定。伺服器可連線、網域可解析、目標服務正常是不同條件,單獨完成其中一項不能取代其他檢查。進一步判斷方式請參閱DNS 疑難排解。

完成後進行最後檢查:保留預計使用的伺服器與模式,中斷後重新連線,確認結果可以重現。記下有效組合,之後更新訂閱或修改 Config 時才有可比較的基準。記錄中不要包含完整訂閱連結、密碼或其他驗證資料。

第五步:依現象檢查常見問題

遇到問題時,先確認停在哪個步驟:資料未匯入、伺服器無法測試、開關無法保持開啟,或連線後特定頁面異常。每輪只修改一個項目,重新測試相同目標,並保留錯誤提示原文。直接清除配置會失去比對資訊,反而難以判斷問題出自訂閱、規則或裝置網路。

Subscribe 更新失敗或清單空白

返回訂閱編輯頁面,檢查 URL 是否完整,有沒有誤用網頁位址、複製到已過期的連結,或遺漏驗證參數。再確認裝置本身可以連線。訂閱回傳的內容格式也必須能讓用戶端辨識,網頁說明或錯誤頁面不能當成伺服器清單匯入。若涉及連結期限、存取權限或伺服器回傳異常,請向原本的服務提供者確認,不要公開個人訂閱連結尋求協助。

Connectivity Test 逾時

先檢查目前網路是否能正常瀏覽,再核對伺服器位址、連接埠、協定與驗證參數。手動新增的項目應逐項比對原始資料,特別留意 TLS 與傳輸參數。可在同一訂閱中選擇另一個既有項目作為比較,但不要每次測試都同時更換網路與配置。如果只有測試逾時而實際頁面可以瀏覽,應繼續檢查測試目標,不能僅憑單一測試就刪除伺服器。

開關已開啟,但網頁無法瀏覽

先檢查 Global Routing 是否停留在直連(Direct),再確認目前選取的是預期伺服器。如果代理(Proxy)可用、配置(Config)不可用,優先檢查規則與目前 Config;兩種模式都失敗,則繼續檢查伺服器連線與網路。只有部分網域失敗時,再進一步查看 DNS 與目標請求記錄。不要一開始就更換所有設定,也不要把訂閱匯入成功當成伺服器一定可用的證明。

切換網路或返回前景後出現異常

從 Wi-Fi 切換到行動網路後,先確認新網路可獨立瀏覽,再中斷並重新連線。若裝置從休眠恢復後狀況不同,留意是否有 On Demand 條件重新觸發,以及所選伺服器是否仍相同。iPad 分割畫面時可將瀏覽器與用戶端並排比對,但每次切換都應記錄清楚先後順序,避免把舊頁面的快取誤認為新的連線結果。

仍無法定位時,整理裝置類型、系統版本、目前網路、Global Routing、是否所有伺服器都失敗,以及已去除敏感資訊的錯誤原文。不要提交完整訂閱、密碼或 QR Code。概念性問題可繼續查看問答;需要依開關、訂閱、逾時、DNS 或耗電狀況逐層檢查時,請參閱疑難排解手冊。本教學到能穩定重現一次正常連線為止,後續再逐項調整規則與自動連線條件。

其他裝置的取得方式

下載 Shadowrocket