Shadowrocket 訂閱匯入與連線教學
依照「新增 → 選擇模式 → 連線 → 驗證 → 排錯」完成首次設定。
以 iPhone / iPad 介面為例,先驗證既有伺服器,再檢查規則分流。
- 已有訂閱或伺服器資料
- 依英文介面用語操作
- 官方 App Store 截圖
開始前:確認已安裝並備妥連線資料
先確認手邊資料的類型:用於更新伺服器清單的連結,通常應透過 Subscribe 匯入;單一伺服器的位址、連接埠與驗證參數,則應依對應的 Type 新增。請依資料選擇其中一種方式,不必重複匯入相同內容。訂閱連結可能含有個人憑證,請勿張貼在公開頁面,也不要交由不明工具處理。
以下截圖用於辨認頁面與欄位,不是可照抄的連線資料。設定項目會因所選 Type 和應用程式介面而有所不同;填寫時請以服務商提供的參數為準。首次操作先完成一條可驗證的連線,再處理多個訂閱、複雜規則或自動連線;發生問題時會更容易確認原因。
新增伺服器或匯入 Subscribe
開啟 Shadowrocket,先停留在 Home。若目前已連線,請先關閉頂端開關,避免修改時同時保持連線。找到 Add Server,或點選頁面上的新增入口進入 Add Server。接著依資料類型選擇匯入訂閱或填寫單一伺服器;儲存後都應返回 Home 檢查結果。
已有訂閱連結:選擇 Subscribe
在 Add Server 的 Type 中選擇 Subscribe,將向服務商取得的完整訂閱連結填入 URL。貼上後檢查連結開頭與結尾,移除複製訊息時附帶的引號、說明文字或換行,請勿自行刪改連結中的查詢參數。為訂閱設定方便辨識的名稱,再儲存並等待清單讀取完成。返回 Home 後,檢查是否出現對應分組與伺服器項目。
儲存訂閱不代表已經連線。若分組出現但其中沒有伺服器,請先檢查連結是否仍有效、目前的基礎網路能否讀取訂閱,以及服務商是否要求重新產生連結。不要把「訂閱網址」和單一伺服器的 Host 混填:前者用於讀取清單,後者是單一連線目標。更新訂閱會影響清單,手動修改參數前應先保留原始資料,以免下次更新後無法辨識修改內容。
已有單一伺服器:依 Type 填寫
在 Type 中選擇與資料相符的協定,例如 Shadowsocks、VMess、VLESS 或 Trojan。接著核對 Host、Port,以及該類型要求的驗證和傳輸欄位。截圖中的 Password、Method 等欄位只適用於特定類型,不是每種協定都必須填寫的固定清單。Host 不要包含網頁路徑;Port 必須與服務商提供的資料完全一致;Password、識別碼與金鑰都要保留大小寫。
若取得的是 QR code,可使用 Scan QR Code,並在系統詢問時允許存取相機;Import from Cloud JSON 僅適用於相應格式的資料,不應任意填入一般訂閱連結。匯入後仍要開啟項目,檢查 Type 與重要欄位。最後返回 Home,確認 SERVER 下方可選取該項目。此時先不要判斷連線是否正常,下一步先決定流量應採用哪種模式。
選擇 Global Routing 的三種模式
伺服器出現在清單後,返回 Home,點選 Global Routing。這裡決定的是請求如何選擇目的地,不會補齊伺服器資料。三種模式分別是設定檔(Config)、代理(Proxy)、直連(Direct)。先確認測試目的,再選擇模式,避免把「伺服器能否連線」和「規則是否命中」混為一談。
設定檔(Config):依目前設定檔比對
日常需要區分代理與直連時,使用設定檔(Config)。接著進入 Config,確認目前選取的是準備使用的設定檔,而不是只看到檔案已下載就認為已啟用。開啟設定檔可檢查 General、Rule 等區段;規則部分會決定請求命中 PROXY、DIRECT 或 REJECT。首次設定不必逐項修改,先確認設定檔的來源與用途,並保留原始檔案以供還原。
例如以下兩行代表:符合 example.com 及其子網域的請求使用 PROXY,其他尚未命中的請求使用 DIRECT。這只是用來說明語法的片段,不是完整設定,也不是本教學要求直接匯入的範本。規則由上往下比對,較早命中的規則會決定結果,因此 FINAL 應放在規則末尾。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
代理(Proxy)與直連(Direct):分別驗證原因
短暫檢查所選伺服器能否處理代理請求時,可先使用代理(Proxy),減少規則分支對測試的干擾。直連(Direct)則用於檢查基礎網路直接連線至目標時的狀況,並不表示代理伺服器已通過驗證。這三種模式不是連線品質等級,也不保證裝置上的所有系統流量都以相同方式處理;系統路由與相關設定仍可能影響實際路徑。
切換後返回 Home,檢查 Global Routing 是否顯示預期選項。若使用 Proxy 時可以瀏覽,切回 Config 後某個目標卻失敗,排查重點應放在目前設定檔的規則與解析,不宜立即反覆更換伺服器。若要了解比對順序、策略或完整設定結構,請接著閱讀規則參考;若只想快速辨認名詞,可查看概念速查。
選取伺服器,再開啟連線開關
選擇模式後返回 Home。在 SERVER 分組中點選要使用的伺服器,確認選取標記確實位於目標項目上。訂閱分組名稱與個別伺服器名稱並不相同;展開分組不代表已切換目前伺服器。若清單中有多個相似名稱,可開啟項目核對位址與 Type,再返回選取。
確認 Global Routing 後,開啟 Home 頂端的連線開關。首次建立連線時,系統可能會提示允許新增 VPN 設定。請閱讀提示,確認這是剛才主動發起的操作,再允許並依系統要求完成裝置認證。這一步會授權應用程式建立相應的網路連線,不會替你建立伺服器、購買連線方案或修正錯誤參數。
完成系統提示後返回 Shadowrocket,觀察頂端狀態是否由 Not Connected 變為已連線。若先前取消過授權,再次開啟開關時請留意系統提示;若裝置由組織管理或受到系統限制,需依裝置管理要求處理,無法靠反覆點選開關解決。尚未看清提示內容時,請勿連續切換,以免無法判斷目前處於授權階段還是實際連線階段。
頂端顯示連線狀態,只能代表連線機制已啟用,無法單獨證明訂閱中的每台伺服器都可用,也無法證明每個目標都透過代理連線。請保持目前選取的伺服器與模式不變,接著進行下一步測試。若開關開啟後立即關閉,先記錄是否出現系統提示或錯誤訊息,再依最後一節逐項檢查授權、設定與網路。
首次手動驗證時,建議先不要同時調整 On Demand。按需連線可能在符合網路條件時重新觸發連線,讓手動中斷與重新連線的觀察變得複雜。先確認手動連線流程能重複成功,再依實際需求設定自動連線條件;On Demand 的意思可參閱概念速查。
透過測試、實際瀏覽與規則記錄確認是否生效
保持連線開關開啟後,先在 Home 執行 Connectivity Test。它可提供目前測試方法下的可連線線索,但不保證所有網站或協定都可使用。測試沒有回傳結果時,也不能立刻判定所有連線都失敗;測試目標、方法與目前網路環境都可能影響結果,後續仍須透過實際瀏覽驗證。
開啟瀏覽器,重新載入你實際需要瀏覽的目標頁面。不要只觀察已開啟的舊分頁,因為快取內容可能讓中斷連線時看起來仍可瀏覽。檢查頁面新內容能否載入,必要時改用另一個你有權瀏覽的目標交叉驗證。此時不要同時切換伺服器與模式,否則即使恢復瀏覽,也難以判斷是哪一項變更發揮作用。
Config 模式需檢查兩種連線去向
若使用設定檔(Config),請分別選擇一個依自己的規則應使用 PROXY 的目標,以及一個應使用 DIRECT 的目標進行測試。兩者都能開啟,不代表規則一定正確;還應查看應用程式中的連線記錄,核對請求目標、命中的規則與採用的策略。DIRECT 原本就應直接連線,不能因為此類頁面能開啟,就認定代理伺服器正常運作。
| 觀察結果 | 說明與下一步 |
|---|---|
| 顯示已連線,但目標無法開啟 | 繼續檢查所選伺服器、網域解析與規則,不要只看頂端狀態。 |
| Proxy 可瀏覽,Config 失敗 | 檢查目前生效的設定檔、規則順序,以及是否命中 REJECT 或非預期的 DIRECT。 |
| 測試沒有回傳結果,實際瀏覽正常 | 核對 Settings 中的 Test Method,不要只依單次測試結果下結論。 |
| 只有特定目標失敗 | 集中檢查該目標的規則、解析與服務狀態,先保留其他已成功的設定。 |
Data 中出現上傳或下載數據,可協助確認有流量傳輸,但統計數據本身不代表某條規則已命中。分別確認「開關已啟用」、「伺服器可用」與「規則去向正確」三個項目,判斷會更可靠。成功驗證一次後,記下目前的伺服器、Global Routing 與設定檔名稱,作為下次排錯的參考。
依失敗狀況檢查,避免同時修改多項設定
發生問題時,先保留剛才的觀察結果:是讀取不到訂閱、開關無法維持開啟、測試沒有回傳結果,還是只有特定目標無法開啟。進入 Settings 前,先關閉連線,確認基礎 Wi-Fi 或行動網路可正常瀏覽;若目前網路需要網頁認證,請先完成認證,再返回 Shadowrocket 重試。
訂閱清單空白或參數錯誤
若沒有可選取的伺服器,返回訂閱項目檢查連結是否完整、是否已失效,以及服務商是否已變更訂閱內容。重新更新前先確認處理的是哪個分組,不必為同一條連結連續建立多份訂閱。單一伺服器連線失敗時,逐項核對 Type、Host、Port、Password 與協定對應欄位;不要用其他類型的欄位拼湊看似完整的設定。
若只有某台伺服器異常,而自己已有的另一台可以正常連線,應優先核對異常項目的資料與可用狀態。需要重新取得資料時,請向你的服務商索取。描述問題時,除了「應用程式連線失敗」,也請提供目前模式、項目類型與基礎網路狀況;這些資訊會決定後續應檢查哪一層。
分別處理開關、測試與實際瀏覽問題
開關無法維持開啟時,先確認是否已完成系統新增 VPN 設定的授權,再檢查是否有其他 VPN 連線佔用或裝置管理限制。測試結果與實際瀏覽不一致時,進入 Settings 查看 Test Method,記下原本的選項後,再嘗試符合目前目的的測試方式。每次只修改一項,返回 Home 重新測試,再決定是否保留;不要為了讓測試顯示結果而同時修改 DNS、規則與伺服器。
若 Proxy 下正常、Config 下異常,返回 Config 核對生效中的檔案與 Rule 順序。優先檢查目標是否先命中 REJECT、是否被 DIRECT 規則接走,以及末尾的 FINAL 是否符合預期。不要直接清空所有規則;先儲存原始設定,再針對單一目標調整並驗證。更完整的排查方式請參閱規則與設定參考。
需要進一步回報時,整理最少必要資訊
可在 Settings 的 Diagnostics 中查看診斷入口,並依當次操作蒐集線索。記錄問題發生在 Wi-Fi 還是行動網路、使用的 Type、Global Routing、具體錯誤文字,以及切換到自己已有的其他項目後是否仍然失敗。對外分享前,請遮蔽完整訂閱連結、密碼、金鑰、個人位址與帳戶資訊;截圖只保留與問題相關的欄位和提示。
若某項變更沒有改善結果,請還原變更前的狀態,再檢查下一項。還原至最後一次成功的組合,比疊加多項不確定的設定更容易重現問題。關於授權、更新訂閱與常見介面疑問,可接著查看常見問答;本頁至此完成首次使用流程,不再延伸說明複雜設定。
完成後保留成功設定,再安排其他裝置
確認可以重複連線、實際瀏覽符合預期,並確認 Config 下的規則去向後,即可保留目前設定。之後更新訂閱或修改規則時,每次只變更一類內容;發生問題時先還原至已驗證的狀態。若要管理更多規則,請前往規則參考,不必在首次連線時一次完成所有進階設定。