OFFICIAL MANUAL / QUICKSTART
Shadowrocket 使用教學 匯入、連線與驗證
先讓一份現有設定成功連線一次,確認結果可重現,再調整分流與自動連線。本篇官方手冊說明 iPhone、iPad 上的首次操作,請依序完成以下五個步驟。
操作原則:每完成一步就確認結果。成功匯入訂閱、開啟連線開關,以及確認實際請求走上預期路徑,是三個不同的檢查項目。
STEP 01 / IMPORT
Add Server / Subscribe:匯入現有資料
開啟 Shadowrocket 後,先進入 Home。此處可查看並選取伺服器;尚未新增資料前,先不要開啟連線開關。確認手上的資料類型:訂閱連結用於取得一組伺服器資料;單一分享連結通常只包含一台伺服器的資料;手動設定資料則包含協定、位址、連接埠與驗證資訊。這三類資料的匯入方式可能不同,請勿只憑連結外觀混用。
已有訂閱連結:選擇 Subscribe
在 Home 點選右上角的加號,進入 Add Server。開啟類型選單,選擇 Subscribe,將自己的完整訂閱連結貼到 URL 欄位,再儲存。若有備註欄位,可填寫方便辨識的名稱。貼上後請檢查連結開頭與結尾是否完整,尤其不要漏掉問號後的參數,也不要一併貼上聊天文字、引號或空格。
儲存後返回 Home,等待訂閱資料載入完成,並確認相應群組中已顯示可選的伺服器。只看到訂閱名稱、卻沒有伺服器,不代表匯入已完成:可能是目前網路無法取得資料,也可能是連結回傳網頁提示,而非有效的訂閱內容。此時請先檢查連結狀態與取得結果,不要連續重複新增相同網址。訂閱更新入口的顯示方式以目前介面為準;執行更新後,請再次確認清單內容。
已有伺服器參數:選擇相應協定
同樣透過加號進入 Add Server,在類型選單中選擇資料所用的協定,再逐項填入位址、連接埠與驗證參數。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等協定所需欄位各不相同;只填寫資料明確提供的項目,傳輸方式、TLS、伺服器名稱等附加參數也應與原始資料一致。不要為了填滿表單,任意輸入未提供的欄位內容。
如果取得的是單一伺服器分享連結,可以使用 App 提供的連結匯入功能;若資料是 QR Code,則可透過 Scan QR Code 掃描。無論使用哪種方式,儲存後都應返回 Home 確認項目已列出,再點選要使用的項目。訂閱網址可能包含個人存取憑證,請勿公開貼在留言、截圖或排查記錄中,也不要當作一般網頁連結分享。
此階段只確認「資料已加入清單且可以選取」,尚未證明伺服器可以連線。另外請留意:訂閱通常用來更新伺服器清單,Config 頁面管理的則是設定檔與規則;匯入訂閱後,不代表分流規則也已備妥。確認清單正常後,再進行下一步,選擇 Global Routing。
STEP 02 / ROUTING
Global Routing:選擇處理方式
返回 Home,開啟 Global Routing。此設定決定請求採用哪種整體處理方式,不會替你補齊伺服器資料。首次操作時,請先記錄目前選項;安裝狀態、現有設定檔及先前的修改都可能影響畫面顯示,本教學不預設統一的初始值。三種模式分別是設定檔(Config)、代理(Proxy)和直連(Direct),請依本次驗證目的選擇。
設定檔(Config):依目前設定檔處理
若已有可用的規則檔,並希望依規則分流,請選擇設定檔(Config)。先前往 Config 頁面,確認設定檔已存在,且已選取本次要使用的檔案。規則可能將不同請求交由 DIRECT、PROXY 或其他已定義的策略處理,因此連線後部分內容直接連線,可能是正常結果。選擇 Config 模式本身不代表已選好規則,也不代表所有請求都會使用 Home 中目前選取的伺服器。
代理(Proxy):確認代理連線路徑
如果目前的目標是確認剛匯入的伺服器能否使用,可在短時間測試中選擇代理(Proxy),並確認 Home 中選取的伺服器。這能減少設定檔規則對本次測試的影響,但不能據此推論裝置上的所有流量都一定經由相同路徑。測試結束後,若日常使用需要依規則分流,請恢復已備妥的設定檔(Config),再驗證實際需要的連線。
直連(Direct):直接連線與比較測試
直連(Direct)會直接連線,不能用來證明「所選代理伺服器已生效」。排查時可透過直連比較直接連線與代理路徑的差異,但切換前後應維持相同的測試目標與本地網路。如果一般連線原本就正常,單憑頁面能否開啟,無法分辨 Direct 和 Proxy;還須參考目前模式、設定檔規則與後續記錄。
首次驗證建議只選一個明確目標:先確認伺服器連線,再確認規則分流。不要在同一輪測試中同時切換 Global Routing、修改 DNS 並更換設定檔,否則結果改變時很難判斷原因。完成首次連線後,可閱讀Settings 設定手冊,了解規則順序、DNS 與策略之間的詳細關係。
STEP 03 / CONNECT
Home:啟用連線開關
返回 Home,先確認兩件事:選取的伺服器是否正確,以及 Global Routing 是否仍是剛才選定的模式。若訂閱中有名稱相近的項目,點選後請再次確認,不要只憑清單中的第一項判斷。確認目前 Wi-Fi 或行動網路本身可以連線後,再開啟 Home 頂端的連線開關。即使連線資料已儲存,仍須執行這一步才會嘗試建立連線。
首次建立連線時,系統可能會提示新增 VPN 設定。請確認提示是由剛才在 Shadowrocket 中啟動的操作所觸發,再依系統指示允許並完成裝置驗證。此提示是在要求系統網路設定權限,不是購買另一項服務。如果先前取消授權,請返回 App 再次啟動連線,並依實際提示操作;若裝置受管理或受到限制,也請檢查相關系統限制。
授權後返回 Home,確認開關與連線狀態是否維持開啟。系統的 VPN 圖示可協助確認網路延伸功能的狀態,但圖示出現不代表每台遠端伺服器、DNS 請求或目標頁面都已成功。反之,若開關剛開啟就關閉,或 App 立即顯示連線錯誤,請先檢查權限與參數,不必急著修改分流規則。
首次測試建議保持條件單純:選定一台伺服器、一種本地網路及一種 Global Routing 模式,暫時不要調整 On Demand 等自動連線條件。相關選項的初始值請以目前 App 顯示為準;若原本已啟用自動觸發條件,請先記錄,避免手動關閉後又自動連線,誤以為開關異常。排查時不要批次重設尚未了解的 Settings 項目。
iPad 的頁面配置可能與 iPhone 不同,但確認順序相同:在 Home 選取項目、確認 Global Routing、啟用連線並處理系統授權。完成後先不要立刻切換多個 App 或網路,讓這次連線維持至下一步驗證。若要主動中止連線,可返回 Home 關閉開關,再確認系統狀態;若已設定 On Demand 條件,也須一併檢查其觸發設定。
STEP 04 / VERIFY
Connectivity Test:確認實際結果
確認連線開關維持開啟後,在 Home 使用 Connectivity Test,查看清單項目的測試結果。測試方式與目標會受目前設定影響,因此數值適合在相同條件下比較,不宜直接視為實際下載速度。單次測試失敗也不必立刻刪除項目:先確認測試條件,再透過實際連線進行第二次判斷。
接著開啟準備使用的網頁或 App,執行一項明確操作,例如重新載入頁面或取得新內容。盡量不要只查看已快取的頁面,因為快取內容能顯示,並不能證明剛建立的連線已處理新的請求。請記錄能否載入、是否長時間等待,以及是否只有部分資源載入失敗;這些現象比一句「不能用」更有助於找出問題。
使用設定檔(Config)時,實際請求可能會依規則走不同路徑。某個頁面能開啟,不代表其他網域也會匹配相同策略;頁面主體載入成功但圖片失敗,也可能與多個網域或不同請求有關。若要確認具體處理路徑,可查看 App 內相關連線記錄或 Log,並配合目前設定檔判斷;不要只根據 VPN 圖示推斷所有流量的去向。
如果結果不明確,可以進行一組有限的比較:維持伺服器與本地網路不變,先記錄目前 Config 模式下的狀況,再短暫切換至 Proxy,測試相同目標,結束後恢復原模式。若 Proxy 正常、Config 異常,優先檢查設定檔、命中規則與策略;若兩者都失敗,則優先檢查伺服器參數與網路連通性。比較測試是為了縮小排查範圍,請勿反覆任意切換。
完成首次驗證後,保留一份不含敏感資訊的簡短記錄:使用的本地網路、伺服器備註、Global Routing、Connectivity Test 結果及實際連線狀況。日後修改設定時,以相同目標重新測試,才能比較前後差異。連線與存取都符合預期,即可完成入門流程;其他 Settings 項目可等到確有需要時再逐項了解。
STEP 05 / TROUBLESHOOT
常見問題:依發生順序排查
遇到問題時,先停在失敗的步驟,不要直接重做整個流程。以下依序檢查資料匯入、建立連線及實際連線狀況。每次只變更一個條件,重新測試後再決定下一步;已能正常運作的部分應盡量保留,避免讓單一問題增加更多變因。
儲存訂閱後沒有伺服器
先確認 URL 是否完整、是否含有多餘空格,以及這份資料確實是訂閱連結。再確認目前網路可以取得訂閱內容,並查看 App 顯示的更新提示。連結失效、憑證錯誤或回傳格式不符,都可能導致清單無法產生。請向原始資料提供者確認連結是否有效;不要把錯誤頁面當作訂閱再次匯入,也不要公開整條連結尋求協助。
連線開關無法維持開啟
先確認系統 VPN 設定授權已完成,再檢查 Home 中目前選取的項目。手動填寫的資料尤其要確認協定、連接埠、驗證欄位及 TLS 等附加參數,不能只確認位址正確。若裝置有管理限制或其他網路設定影響,請先確認系統提示。修改資料前請保留原始內容,避免排查時忘記一開始使用的參數。
連線已開啟,但無法連線
先確認本地網路可正常使用,再比較同一台伺服器在不同本地網路下的狀況。若只有一台伺服器失敗,請優先檢查該伺服器的資料與狀態;若所有現有項目都失敗,先檢查共同的本地網路條件與設定。不要同時變更多個 DNS、協定與傳輸欄位;只有在資料要求或診斷結果明確指出時,才修改相應項目並記錄結果。
部分網站正常,部分請求異常
記錄發生問題的目標與操作,並確認 Global Routing 是否為預期模式。在 Config 模式下,優先確認目前啟用的設定檔與命中策略,再以相同目標進行必要的比較。若問題只出現在某個網頁或 App,也應考慮目標服務狀態與快取的影響。規則分流的完整說明請參閱設定手冊;初次使用時不建議直接批次修改規則。
測試有結果,但速度不如預期
Connectivity Test 的回應結果與持續傳輸能力並非同一項指標。請先固定測試目標、比較本地網路狀態,再檢查所選伺服器與協定參數;每次只變更一個條件。若要進一步整理排查方向,可閱讀連線速度慢的分層檢查說明。單次結果不足以判斷長期表現,也不應因此反覆刪除有效設定。
需要查看 Log 時,請只重現一次相關問題,並聚焦於該時段,避免大量無關記錄影響判斷。向資料提供者說明問題時,可提供失敗步驟、目前模式、網路類型及已移除敏感資訊的錯誤內容;請刪除密碼、完整訂閱網址、驗證參數與個人瀏覽記錄。資料是否有效,請向原提供者確認;App 內操作則可返回本頁相應步驟重新檢查。
下一步:先保留可用狀態,再逐項調整設定。
本篇說明首次連線。DNS、On Demand、Ping、Log 等項目的用途與建議檢查順序,請接著查看Settings 設定手冊 →;若要重新匯入,從第一步 Add Server / Subscribe開始即可。