官方手冊 · 快速入門

Shadowrocket 首次連線教學

從現有訂閱或伺服器資訊開始,依序完成匯入、選擇 Global Routing、連線與驗證;先建立可用連線,再調整規則。

  • 匯入現有資訊
  • 確認預設伺服器
  • 連線後驗證

1. Add Server:新增與匯入

開啟 Shadowrocket,進入 Home。先查看 SERVER 清單:如果清單中已有準備使用的伺服器,不必重複新增,可直接核對資訊並選為預設伺服器。如果清單是空的,或現有項目不是這次要使用的連線,點選頁面右上方的新增入口,進入 Add Server。接著依手邊資訊的類型選擇一種匯入方式,請勿將訂閱連結當成伺服器位址填入。

已有訂閱連結:選擇 Subscribe

在 Add Server 中開啟 Type,選擇 Subscribe,再將向服務供應商取得的訂閱連結貼到 URL。請保留完整連結,尤其是末尾的參數;複製時避免一併選入說明文字、換行或前後空白。備註僅用來辨識這組訂閱,可填寫容易識別的名稱。核對後儲存,返回 Home,等待訂閱請求完成,再查看對應群組中是否出現伺服器項目。

儲存訂閱入口,不代表已成功取得伺服器清單。若只看到訂閱名稱,卻沒有可選擇的伺服器,請先檢查更新是否出錯,不要急著開啟連線開關。重新從原始來源複製連結,並確認訂閱仍有效;重複建立相同訂閱通常無法解決網址錯誤。之後需要更新時,對該訂閱執行更新,完成後再次檢查清單;不要只因點過更新按鈕就認定更新成功。

已有單台伺服器資訊:核對協定與欄位

如果取得的是單台伺服器參數,請在 Add Server 的 Type 中選擇與資料完全一致的協定,再填寫伺服器位址、連接埠及對應的驗證資訊。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各不相同,不能只更換協定名稱,卻沿用其他協定的欄位。加密方式、傳輸方式、TLS 與伺服器名稱等選項,都應依原始資料核對;若不確定,請向服務供應商確認。

已有可辨識的分享內容或 QR Code 時,可使用用戶端提供的匯入入口;也可透過 Scan QR Code 掃描。匯入後仍應開啟項目,核對協定與伺服器位址是否符合資料。掃描 QR Code 只是輸入方式,不能證明參數有效。請勿為了填滿欄位而自行猜測數值,也不要把原本應填在驗證欄位的內容放進備註或位址欄。

返回 SERVER:選擇預設伺服器

儲存後返回 Home,在 SERVER 清單中點選這次要使用的伺服器,確認該項目顯示預設選取標記 DOT。備註相近的項目可能屬於不同群組,選擇時也要核對所屬訂閱與協定。預設伺服器決定需要代理的請求使用哪個連線入口;清單中有項目,不代表它已成為目前的預設伺服器。此時先不要修改多組參數,下一步只需決定 Global Routing 的處理方式。

2. Global Routing:選擇路由模式

在 Home 點選 Global Routing,選擇目前需要的處理方式。三種模式分別是配置(Config)、代理(Proxy)、直連(Direct)。它們決定如何處理請求,不會補齊伺服器資料,也無法讓失效的訂閱恢復。初次使用時,先分開確認「伺服器是否可用」與「規則是否正確」,通常更容易找出問題。

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

代理(Proxy)會以代理方式處理由用戶端接管的請求,適合在首次連線時暫時確認預設伺服器是否可用。選定後返回 Home,再檢查一次預設伺服器標記。這不是額外的加速開關,也不保證裝置上的所有流量都會經過相同路徑;系統流量與 App 行為仍可能不同。此時不必先編輯規則,先完成連線與實際存取測試。

配置(Config):依目前配置處理請求

配置(Config)會依目前配置中的規則與策略處理請求。若要使用此模式,請先進入 Config,確認準備使用的配置已設為目前配置,而不只是保存在清單中。配置檔與伺服器訂閱的用途不同:前者描述路由、DNS 等行為,後者通常用於管理伺服器清單。成功匯入訂閱,不代表目前配置的規則一定符合你的使用需求。

如果已有可用配置,請先保持原樣,待連線成功後再逐項調整。規則依序比對,較前面的條件可能先決定請求的去向;即使預設伺服器正常,符合 DIRECT 的請求也不會依代理策略處理。本文不深入說明規則編輯,DOMAIN-SUFFIX、IP-CIDR、FINAL 的完整說明請參閱配置檔章節,避免首次連線時同時修改 DNS、規則與伺服器參數。

直連(Direct):確認直接存取路徑

直連(Direct)會以直連方式處理請求,不會透過所選的代理伺服器傳送。可用來比對目前網路的直接存取情況,但不能用來驗證代理伺服器的連線是否成功。選擇 Direct 後,即使連線狀態正常或頁面順利開啟,也不能據此判定代理伺服器可用。若要首次檢查已有的伺服器,請切回 Proxy,或確認 Config 中對應的請求確實符合代理策略。

選定後,請記下目前模式及選擇原因。測試期間不要連續切換三種模式,否則同一頁面的前後測試可能走不同路徑。下一步只需開啟連線開關;若之後需要更改模式,請在修改後重新連線並再次驗證,不要沿用先前的測試結果。

3. Home:開啟連線開關

返回 Home,依序檢查兩處:SERVER 中的預設伺服器是否正確,以及 Global Routing 是否為剛選定的模式。若訂閱包含多台伺服器,請先固定一台進行測試,連線期間不要同時切換項目。確認後開啟頁面上方的連線開關。尚未連線時可能會顯示 Not Connected;連線過程中請等待狀態更新,不要快速重複切換開關,以免混淆系統授權與實際連線流程。

首次授權:允許新增 VPN 配置

首次建立連線時,系統可能會要求新增 VPN 配置。此要求是讓 Shadowrocket 使用系統提供的網路功能處理流量,僅涉及系統權限,不代表伺服器已連線成功。確認要求由 Shadowrocket 發起後,選擇允許,並依裝置提示完成身分驗證。系統權限提示的文字可能隨系統語言而異,本教學保留用戶端中的英文介面名稱;系統提示也不會是固定不變的用戶端頁面。

如果先前取消授權,連線開關可能無法維持開啟。請返回用戶端重新發起連線,留意系統提示是否再次出現。若裝置受到管理或系統限制,可能無法新增或啟用 VPN 配置;請先確認裝置允許此操作,不要試圖透過重複匯入伺服器解決權限問題。完成授權後返回 Home,檢查連線開關與狀態,不要只留在系統設定頁面判斷結果。

連線狀態:先確認再離開頁面

連線開關維持開啟且用戶端顯示連線狀態,表示系統網路連線已建立至相應階段,但仍須測試實際請求。VPN 狀態標示也不能單獨證明伺服器驗證、DNS 解析和目標存取都正常。如果開關立即關閉,或用戶端顯示連線錯誤,請先記下錯誤訊息與目前協定,再依本文末尾的步驟排查。確認錯誤前不要啟用 On Demand,以免自動重新連線使觀察更複雜。

首次手動連線成功後,再視需要考慮 Settings 中的 On Demand。按需連線條件決定何時觸發連線,不是修復無法使用的伺服器的方法。也請避免讓多個 VPN 配置同時接管目前連線;先確認目前啟用的配置屬於 Shadowrocket,再繼續驗證。現在請維持預設伺服器與模式不變,進入 Connectivity Test 並檢查實際存取。

4. Connectivity Test:驗證是否生效

在 Home 點選 Connectivity Test,查看目前項目的測試結果。此功能可協助判斷連線狀況,但不是完整的網路品質報告。不同測試方式可能檢查不同目標或階段,因此某項測試有結果,不代表所有頁面都能存取;測試逾時也須搭配實際請求一併判斷。請先確認看到的是目前預設伺服器的結果,而不是先前測試其他項目留下的顯示。

綜合判斷測試結果與實際存取

完成測試後,開啟預計使用的頁面,或執行一次明確的 App 請求。選擇平時能辨識結果的目標,觀察是否載入完成,不要只看連線圖示。若要比較連線前後的差異,請維持相同網路、目標與操作,分別進行測試;每次只改變用戶端的連線狀態。頁面快取可能讓舊內容繼續顯示,必要時請重新整理並送出新請求,不要用已載入的頁面代替驗證。

若目前使用 Proxy,實際存取失敗時請優先檢查伺服器、DNS 與目前網路。若使用 Config,還需要確認請求應符合哪條規則。目標頁面能開啟,不代表請求經過代理:規則可能指定 DIRECT。反之,單一目標失敗也不能立即判定所有伺服器都失效;目標本身、驗證狀態與 App 內的連線方式都可能影響結果。

Data:協助確認請求路徑

返回用戶端,查看 Data 中可用的流量或請求紀錄。根據目標網域、發生時間與策略資訊,判斷剛才的請求是否有紀錄,以及是否依預期處理。紀錄中的 DIRECT、PROXY 等資訊,應搭配目前模式與配置解讀,不能只看總流量是否變動。部分請求可能沿用既有連線,或不會以預期的網域名稱顯示;若沒看到特定名稱,請重新送出請求,再檢查相關紀錄。

驗證成功至少應符合三項結果:Home 的連線狀態穩定、選定伺服器能完成相關測試,以及預期頁面或 App 請求正常完成。若需要規則分流,還要確認該請求符合配置中的策略。網路圖示、測試數值與流量計數反映不同層面,不要將任何一項單獨視為最終結論,也不要只因一次測試就頻繁更換所有參數。

完成驗證後,保留這組可用設定:目前伺服器、Global Routing 模式與目前配置。日後調整設定時,以此作為比較基準,每次修改後重複相同的驗證操作。若要進一步了解路由紀錄與 DNS 的關係,請參閱Settings 常用項目說明;若結果不一致,請依下一步順序排查。

5. 首次連線失敗:依序檢查

先確認問題發生在哪個步驟:沒有伺服器項目、連線開關無法維持開啟、Connectivity Test 逾時,還是連線後只有部分請求失敗。這四種情況的檢查方向不同。請保留錯誤訊息,記下目前網路、預設伺服器與 Global Routing。每次只改變一個條件,測試後再決定下一步;同時更新訂閱、切換伺服器、更改模式與 DNS,會讓有效線索消失。

清單空白:先檢查匯入結果

若 SERVER 中沒有可選項目,請返回訂閱入口確認 URL 完整,並檢查這次更新是否成功。訂閱網址可能包含驗證參數,末尾內容缺漏就可能無法取得清單。先在目前網路下更新一次,分辨是請求失敗還是回傳內容無法辨識;若有明確錯誤,請依錯誤訊息處理。訂閱效期、存取權限與回傳格式應向服務供應商確認,不要不斷建立同名訂閱來代替檢查。

無法連線:檢查選取項目、權限與協定參數

若已有伺服器項目但連線失敗,請先確認預設標記,再檢查 VPN 配置權限。接著開啟伺服器項目,逐項比對原始資料:位址、連接埠、協定、驗證資訊,以及該協定所需的傳輸與 TLS 參數。連接埠有回應不代表驗證資訊正確;協定選對也不代表附加欄位符合要求。請勿為了通過測試而隨意關閉憑證驗證或修改伺服器名稱,應依正確參數恢復連線。

也請確認裝置日期與時間正確。系統時間有誤可能影響憑證與驗證流程,尤其是啟用 TLS 的連線。確認時間後重新連線並測試。若同一訂閱中另有一台已知可用的伺服器,可只切換預設伺服器進行比對,其他設定保持不變;若一台失敗、另一台正常,請優先檢查失敗項目的資訊與服務狀態。

已連線但無法存取:釐清規則與網路因素

在 Config 模式下失敗時,可暫時切換到 Proxy,使用相同伺服器與目標重新測試。若 Proxy 正常而 Config 異常,請優先檢查目前配置中的規則比對、策略引用與 DNS 設定;這不是要你長期使用 Proxy,而是縮小問題範圍至配置層。若兩種模式都失敗,請先核對伺服器參數與目前網路,再檢查配置細節,不必急著重寫整份規則。

必要時,在裝置允許的情況下,比較 Wi-Fi 與行動網路。每次只切換網路,維持相同伺服器、模式與目標;結果不同表示網路環境可能是影響因素,但不能直接證明問題出在哪個環節。有些 Wi-Fi 必須先完成網路登入,否則訂閱更新和伺服器連線都可能失敗。請確認一般網頁能直接存取後,再測試用戶端。

保留可用狀態,再處理進階設定

如果只有某個 App 或目標失敗,請先檢查該目標的請求紀錄,不要刪除所有伺服器或重設全部設定。若問題在訂閱更新後出現,請重新確認預設伺服器仍指向有效項目;更新可能改變清單內容,名稱相同也不代表參數完全一致。若更新配置後出現異常,請優先比對備份,確認目前的 Config 是否仍為原本可用的配置。

若要繼續排查,請整理不含敏感資訊的問題描述:失敗步驟、錯誤訊息、使用的協定、Global Routing 模式,以及不同網路下的結果是否一致。請勿公開密碼、金鑰或完整訂閱網址。常見原因與處理方式請參閱故障排查;日常更新、備份與長期維護請參閱使用手冊的維護章節。

延伸閱讀

首次連線確認可用後,再依需求深入設定。進階設定並非連線前必須完成的步驟。

完整使用手冊

從 Config、協定參數到 Settings 與日常維護,依章節檢查各項設定。

閱讀官方手冊 →

故障排查

依匯入、連線與存取狀況尋找原因,再返回原步驟驗證處理結果。

查看常見問題 →
Shadowrocket 正版下載