OFFICIAL MANUAL / QUICKSTART
Shadowrocket
匯入與連線教學
五個步驟完成基本連線:先確認輸入資料,再選擇模式、連線並進行測試。適用於 iPhone 與 iPad 的初次操作。
本官方手冊的入門流程。建議預留約十分鐘操作與檢查;規則語法和系統化診斷請參閱疑難排解手冊。
STEP 01 / IMPORT
新增伺服器/匯入既有訂閱
先確認手上的資料類型,再選擇匯入方式。訂閱網址通常用來取得一組可更新的伺服器;單一分享連結描述一台伺服器;手動參數則由伺服器位址、連接埠、協定及驗證等欄位組成。三者並不相同,不能只因網址看起來以某種格式開頭,就填入任意輸入欄位。若不確定資料類型,請先核對原始說明,不要靠反覆嘗試不同協定來匯入。
使用 Subscribe 匯入既有訂閱
- 開啟 Shadowrocket,在
Home點選右上角的加號,進入Add Server。開啟Type,選擇Subscribe,再填入自己的訂閱網址。 - 為這筆訂閱設定容易辨識的名稱,並檢查網址是否缺字、前後是否有空格,或複製時是否帶入換行。訂閱網址可能含有驗證資料,請完整貼上,不要任意刪除問號後的內容。
- 儲存後返回
Home,等待訂閱內容載入完成。正常情況下,列表會顯示訂閱群組及其伺服器。若只看到訂閱名稱而沒有伺服器,先檢查是否出現載入失敗提示,不要立刻開啟連線開關。
Config 頁面用來管理設定檔;設定檔可能包含規則、DNS 和策略等內容,與伺服器訂閱不同。初次操作時,請先分清楚要新增哪一類資料:若只有伺服器訂閱,請依照上方的 Add Server → Subscribe 路徑匯入,不要把訂閱當成規則設定檔使用。已有完整設定檔的使用者,也應分別確認設定檔是否已啟用,以及伺服器列表是否已載入。
使用 Add Server 填入伺服器參數
如果手上的是手動設定參數,請在 Add Server 中將 Type 設為資料指定的協定,再依序填入位址、連接埠和驗證資料。選擇不同協定後,表單會顯示相應欄位;加密方式、傳輸設定、TLS 與伺服器名稱等內容都必須與原始資料相符。不要因為欄位有預設值就認定可以省略,也不要替不熟悉的欄位隨意填值。填寫完畢後儲存,返回 Home 確認名稱和伺服器是否出現在列表中。
若資料是單一分享連結,複製後請留意 App 顯示的匯入提示,並在確認前核對解析出的協定與位址;若資料是 QR Code,可使用 Scan QR Code。QR Code 仍可能包含敏感連線資料,請勿公開展示。無論使用哪種匯入方式,最後都應出現可選取的伺服器項目;看到名稱只能表示資料已匯入,不能證明參數正確或伺服器可用。
列表準備就緒後,下一步先決定流量處理方式,再開啟連線。
STEP 02 / GLOBAL ROUTING
認識 Global Routing 三種模式
在 Home 開啟 Global Routing,可選擇設定檔 (Config)、代理 (Proxy) 或直連 (Direct)。這裡控制的是整體路由模式,不是伺服器協定,也無法修正錯誤的連線參數。初次測試時,請記住選擇的模式,否則即使網頁能開啟,也難以判斷代理連線是否成功,或實際上走的是直連路徑。
| 模式 | 處理方式 | 入門用途 |
|---|---|---|
| 設定檔 (Config) | 依目前啟用的設定檔規則與策略處理。 | 確認設定檔無誤後,檢查分流結果。 |
| 代理 (Proxy) | 透過所選代理伺服器處理連線,實際行為仍會受到 App 與系統設定影響。 | 簡化初次測試,確認代理連線是否可用。 |
| 直連 (Direct) | 直接連線至目標,不透過目前的代理伺服器轉送。 | 檢查基礎網路,作為故障對照。 |
如果現在只是要確認剛匯入的伺服器能否使用,可以先選擇代理 (Proxy),並在 Home 選取準備測試的伺服器。這樣可暫時減少規則比對造成的變數。測試完成後再決定日常使用的模式;不要把「代理模式能開啟網頁」當成「設定檔規則也正確」。兩者檢查的是不同層面,必須分開驗證。
使用設定檔 (Config) 前,請前往 Config 確認目前啟用的是準備使用的設定檔,而不只是將檔案儲存在列表中。規則通常會依序比對,比對結果決定連線採用哪種策略。匯入伺服器不會自動產生符合個人需求的分流規則,因此不能根據伺服器名稱推斷某個網站一定會走代理。初學時不必同時修改規則、DNS 和策略群組,先建立一條可驗證的連線路徑即可。
直連 (Direct) 可用來比較連線開關開啟與關閉時的基礎存取情況,但不能證明伺服器可用。如果目標網頁原本就能直連,切換模式後仍可開啟,並不代表代理已生效。返回 Home 後,再確認一次目前的 Global Routing 模式和選取的伺服器;兩者都確認後,再進行連線授權。
本步檢查重點:能清楚說明目前使用的是 Config、Proxy 還是 Direct;使用 Config 時,知道啟用的是哪一份設定檔;使用 Proxy 時,知道選取的是哪一台伺服器。
STEP 03 / CONNECT
開啟開關,完成連線授權
返回 Home,選取一台資料已核對的伺服器,再開啟頂端的連線開關。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定。確認提示是由剛才主動發起的操作所觸發後,依照系統指示完成授權;系統可能要求驗證裝置身分。這個步驟是允許 App 在裝置上建立相應的網路連線設定,不是購買提示,也不會替你驗證伺服器資料。
- 先確認目前選取的項目,避免只展開訂閱群組,卻沒有選取實際伺服器。需要比較多台伺服器時,每次只測試一台,並記下名稱。
- 開啟連線開關後,依提示完成系統授權。若先前取消授權,請返回 App 再次發起連線,留意提示是否重新出現,不必先刪除 App。
- 完成授權後返回
Home,檢查開關是否維持開啟,以及 App 是否顯示連線狀態。狀態尚未穩定前,不要連續反覆切換。
系統 VPN 狀態表示相關連線設定正在使用中,但不保證遠端伺服器可連線,也不保證所有網站都能載入。有些參數錯誤要等到實際送出請求時才會顯現。因此,本步只需確認「App 能建立本機連線狀態」;下一步仍須結合測試結果與實際連線來驗證,不能只看狀態標示就結束操作。
如果開關立刻關閉,先確認是否忽略或取消了系統提示,再檢查裝置上是否有其他正在使用的 VPN 設定。由公司或學校管理的裝置也可能受到管理政策限制,此時請遵循裝置管理規定,不要刪除不熟悉的系統設定。iPad 與 iPhone 的頁面配置可能因螢幕空間而異,請依據 Home、已選取的伺服器與連線開關來操作,不要盲目點選固定的螢幕位置。
初次驗證期間,建議先維持目前的網路不變,也暫時不要啟用或調整 On Demand。按需連線可能影響之後的自動連線行為;若同時變更,容易把自動重新連線誤認為開關操作失敗。如果原本已設定 On Demand,請先記下目前狀態;測試結束後若發現連線自動恢復,應先檢查該設定,而不是反覆關閉同一個開關。
本步檢查重點:由本人主動確認授權,且連線開關維持預期狀態;不把系統 VPN 標示當成遠端連線成功的唯一依據。
STEP 04 / VALIDATE
Connectivity Test 與實際連線確認
開啟連線後,先執行 Connectivity Test,查看所選伺服器的測試結果。測試結果可作為排查線索:逾時時值得先檢查伺服器與基礎網路;有回應則表示該項測試已取得結果。但測試目標和方式與實際網頁請求並不完全相同,因此顯示時間數值不代表網頁一定能正常載入,也不代表所有協定功能都已驗證。不要只依數值大小判斷連線是否適合目前用途。
接著開啟瀏覽器,造訪一個熟悉且有權存取的網頁,確認頁面內容確實載入,而不只是顯示瀏覽器快取中的舊頁面。可手動重新整理,再測試另一個網站;若只測試單一網站,網站本身故障可能會被誤判為整條連線失效。檢查時也請記下目前的網路、所選伺服器和 Global Routing 模式,以便後續進行有效比較。
- 確認基礎網路。在可接受中斷連線的情況下關閉 Shadowrocket,確認原本應能直接存取的網頁仍可載入。若基礎網路本身異常,請先處理 Wi-Fi 登入、訊號或行動數據權限等問題。
- 確認代理路徑。返回 App,確認所選伺服器和代理 (Proxy),再次開啟連線並造訪目標網頁。若有可信任的出口資訊查詢方式,可將結果作為額外佐證;只看網頁能否開啟,並不足以證明流量經過預期路徑。
- 確認規則路徑。需要分流時,再切換為設定檔 (Config),重新送出請求,並查看 App 中可用的連線紀錄,確認採用的策略。保留切換前後的測試條件,避免將網路變化混入判斷。
如果 Proxy 下正常、Config 下異常,優先檢查啟用的設定檔和比對策略,不要立刻更換伺服器;如果所有模式下同一網頁都異常,也要考慮網站本身、基礎網路和 DNS 等因素。瀏覽器既有連線也可能影響切換後的觀察,必要時關閉相關頁面再重新造訪。每次只變更一個條件,才能判斷是哪個步驟造成變化。
驗證完成後,將 Global Routing 設為實際準備使用的模式。測試用的 Proxy 不必成為長期預設值;只有規則符合預期時,Config 才有意義。日常使用前,請再開啟常用 App 確認一次,因為網頁測試無法涵蓋每個 App 的連線需求。規則關鍵字與 DNS 的進一步說明,請參閱術語表;持續異常時的排查方式,請參閱疑難排解手冊。
本步檢查重點:已查看測試結果與實際網頁載入情況,且清楚目前使用的模式;若使用 Config,也已確認運作符合預期,而不只是確認開關已開啟。
STEP 05 / CHECKPOINTS
依失敗階段,一次檢查一項
發生異常時,先回想最後一個已完成的檢查點:資料尚未匯入、開關無法維持開啟、測試逾時,還是測試有結果但網頁無法開啟?這四種狀況分別對應不同環節。直接重新安裝或同時修改大量設定,會失去原始狀態,也難以判斷問題來源。先保存既有資料和設定檔名稱,再依照下列順序縮小範圍,最後再決定是否需要深入診斷。
匯入後沒有伺服器:先確認資料類型與載入結果
確認貼上的是訂閱網址還是設定檔網址,是否誤把網頁說明網址當成訂閱網址。接著檢查原始連結是否完整、是否包含複製時帶入的空格,以及 App 是否顯示載入失敗。訂閱網址能在瀏覽器開啟頁面,不代表回傳內容就是可匯入的伺服器列表。既有訂閱的有效期限或存取條件,請向原本的服務提供者確認;不要在公開討論中貼出完整網址、QR Code 或驗證欄位。若列表中已有資料,也不要為了排查而反覆刪除訂閱,請先保留目前可用的資訊。
開關無法維持開啟:先確認系統授權
返回第三步,確認是否取消了新增 VPN 設定的系統提示,以及裝置上是否有其他正在使用的 VPN 設定。受管理的裝置請依管理規定處理。若關閉後又自動連線,請檢查 On Demand 是否已啟用,並將自動連線行為與手動開關問題分開判斷。此階段尚未證明請求已送達伺服器,請優先檢查本機狀態,不要一開始就修改 DNS。
Connectivity Test 逾時:檢查伺服器與網路
先確認選取的確實是準備測試的伺服器,再檢查位址、連接埠、協定和驗證參數是否與原始資料一致。若是從訂閱匯入的項目,可在保留現有資料的前提下更新訂閱,確認內容是否有變動。接著可用自己已有的另一台伺服器進行對照,或在條件允許時切換 Wi-Fi 與行動網路測試;每次只更改一項條件。逾時本身無法判定是哪項參數出錯,也不能只憑一次結果判斷服務狀態。
測試有結果但網頁無法開啟:區分 DNS、規則與目標網站
先改測另一個正常的網頁,確認是單一網站還是普遍異常,再比較 Proxy 與 Config。如果只有 Config 失敗,請檢查目前啟用的設定檔和比對策略。如果多個目標都無法解析,再確認 DNS 設定是否曾變更,並記下原始值後一次調整一項。不要直接複製來源不明的整份設定檔覆蓋目前內容,因為這會同時改變多個變數。測試正常只表示相應測試已完成;網頁所涉及的網域解析、傳輸和網站回應仍可能各自失敗。
若以上步驟仍無法定位問題,請整理一份不含敏感資料的紀錄:裝置類型、目前網路、所選模式、是否完成授權、錯誤提示原文,以及已進行的單項對照。紀錄中不應包含伺服器密碼、完整訂閱網址或驗證資料。接著可依症狀查閱疑難排解手冊,或前往常見問題尋找相關說明,不必重新設定所有項目。