Shadowrocket 訂閱匯入教學:Subscribe、Add Server、掃描 QR Code 與剪貼簿匯入

整理 Shadowrocket 訂閱與伺服器資料的 4 種匯入方式,說明各入口位置、支援的連結格式,以及匯入失敗時的檢查步驟。

本文重點

已有自己的服務商與訂閱時,先分辨訂閱網址和單一伺服器分享連結:需要持續更新清單就使用 Subscribe;手動輸入單一連線則用 Add Server;QR Code 與剪貼簿只是讀取內容的方式,不會決定匯入後能否更新。本文以 iPhone / iPad 的 Home 操作為主,依序說明入口、欄位確認、更新與連線測試;其他平台請以對應介面為準。

先辨別內容:訂閱網址不等於伺服器網址

Shadowrocket(小火箭)需要連線資料才能建立代理連線。訂閱請向自己的服務商取得;取得 App 與購買服務商的線路方案是兩回事。取得一段文字後,先別急著填入伺服器的 Address 欄位,應先判斷它是訂閱 URL、協定分享連結,還是包含登入資訊與說明文字的網頁網址。

訂閱 URL 通常透過 HTTPS 取得一組連線資料;單一分享連結則會將協定、驗證參數與伺服器資訊編碼在一段文字中。網址以 HTTPS 開頭,不代表它就是訂閱:服務商管理頁、說明頁與登入頁也可能使用 HTTPS。

4 種入口
Subscribe、Add Server、掃描 QR Code、剪貼簿
2 種內容
可更新的訂閱網址與單一伺服器資料
443
HTTPS 的預設連接埠,不代表伺服器的 Port 也必須相同
收到的內容辨識方式處理方式
訂閱 URL服務商明確標示為訂閱,通常含有驗證參數在 Add Server 中將 Type 設為 Subscribe
協定分享連結可能以 ss://、vmess://、vless://、trojan:// 開頭透過剪貼簿或 QR Code 讀取,匯入後確認協定欄位
伺服器參數表分別列出 Address、Port、密碼或 UUID 等資訊在 Add Server 中選擇實際使用的 Type,再逐項填寫
帳戶網頁開啟後要求登入,或顯示方案與說明回到服務商頁面尋找真正的訂閱網址

以下範例 https://example.com/sub?token=xxxx 是無法用來連線的示範網址。真實訂閱 URL 中的 token 等同存取憑證,不應出現在公開截圖、聊天群組或除錯記錄中;需要回報問題時,請先遮蔽整段驗證參數。

Subscribe:儲存訂閱並取得伺服器清單

Subscribe 不是與 Add Server 並列的獨立頁面,而是 Add Server 中的一種 Type。若要保留更新來源,應直接儲存訂閱,不要先將訂閱內容拆成多筆手動連線。以下步驟僅使用向自己的服務商取得的網址。

  1. 開啟新增頁面

    進入 Home,點選右上角的「+」,開啟 Add Server。先確認目前要新增的是連線資料,而不是在 Config 中匯入規則設定。

  2. 選擇類型

    進入 Type,選擇 Subscribe。選對類型後再填入網址,不要將訂閱 URL 填進 Shadowsocks 或其他協定的伺服器欄位。

  3. 貼上網址

    將完整的訂閱 URL 貼到 URL 欄位,確認開頭的協定、結尾的 token,並檢查是否混入空格、換行、引號或中文標點。

  4. 儲存並重新整理

    填寫方便辨識的備註並儲存,然後返回 Home。若尚未取得清單,請在 Home 下拉重新整理,等訂閱請求完成後再查看結果。

  5. 確認清單

    確認訂閱項目下方出現可選擇的伺服器,再選取其中一項。儲存訂閱項目但未取得伺服器,不代表已成功取得連線資料。

更新訂閱會重新讀取遠端清單。服務商可能更改名稱、增減伺服器或調整參數,因此不要把訂閱中某筆連線的手動修改當成永久設定。若確實需要暫時調整,請先記下原值,並在下次更新後再次確認。重複新增相同 URL 無法修正遠端回傳內容錯誤,反而容易產生難以辨識的重複群組。

Add Server:手動輸入單一連線參數

只有伺服器網址、連接埠與驗證參數時,請使用 Home →「+」→ Add Server。Type 必須與服務商提供的協定完全一致;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 使用不同欄位與驗證方式,不能只靠修改 Type 互相轉換。

連接埠不可憑習慣填寫

訂閱透過 HTTPS 的 443 連接埠下載,不代表訂閱中的伺服器也使用 443。伺服器的 Port 必須與服務商提供的值一致;也不能只根據連接埠號碼推斷是否啟用 TLS。

手動新增的單一連線通常沒有訂閱更新來源。日後服務商變更密碼、連接埠或傳輸設定時,必須同步修改該連線。若服務商同時提供訂閱與參數表,長期維護清單可優先儲存訂閱,參數表則可用來確認個別欄位。

掃描 QR Code:先確認其中實際承載的內容

在 Home 開啟頂端的掃描入口,首次使用時依系統提示允許存取相機,再對準服務商提供的 QR Code。QR Code 只是文字的另一種呈現方式:其中可能包含單一協定分享連結、訂閱 URL,甚至只是一般網頁網址。

  1. 確認 QR Code 來自自己的服務商,並保持畫面清晰、完整,避免反光或裁掉邊角。
  2. 掃描後查看辨識出的類型與預填內容。若顯示特定協定與伺服器欄位,請依單一連線方式確認;若內容是訂閱網址,請確認以 Subscribe 儲存。
  3. 如果 QR Code 顯示在目前使用的裝置上,而掃描介面提供從相簿讀取的入口,可選擇原始圖片;若沒有此入口,請改從服務商複製文字,不必反覆拍攝螢幕。
  4. 返回 Home 確認新增結果。訂閱應能取得清單;單一連線則應能開啟查看 Address、Port 與驗證設定。

成功辨識 QR Code,只能表示已讀取圖片中的內容,不能證明該內容可供 Shadowrocket 使用,也不能證明遠端連線正常。若掃描後只開啟登入頁,請回到服務商頁面取得連線資料;若顯示無法辨識連結,請向服務商確認分享格式,不要把整段 QR Code 文字直接填入 Address。

剪貼簿:只複製完整連結,不要連同說明文字

剪貼簿適合在同一部裝置上傳送文字。先在服務商頁面使用複製功能,或完整選取一條連結,再切回 Shadowrocket。若出現匯入提示,先確認辨識內容再予以確認;若系統詢問是否允許貼上,必須允許才能讀取相應文字。提示是否出現也會受系統權限與目前內容影響,不要因為沒有跳出視窗就判定連結失效。

支援某種協定,不代表一定能解析該協定的分享格式。即使 Type 中可以選擇某種協定,也不能據此認定所有以該協定名稱開頭的自訂文字都能直接匯入。分享連結解析失敗時,可參考服務商提供的參數表,在 Add Server 中逐項確認,但不要自行猜測缺少的驗證或傳輸參數。

匯入後驗證:區分訂閱請求與代理連線

「訂閱更新成功」與「伺服器連線成功」是兩個不同階段。前者代表取得資料,後者才是使用資料建立連線。建議先確認 Home 中有伺服器,再選取一筆執行 Connectivity Test,接著開啟連線;首次啟動連線時,請依系統提示允許新增 VPN 設定。

接著檢查 Home → Global Routing。除錯時先確認路由模式,避免把規則造成的直連誤判為伺服器無法使用。以下僅比較 Config、Proxy、Direct 三項;Scene 涉及情境選擇,本節不將它視為排除規則影響的測試模式。

Config

建議

依目前啟用的設定比對規則,實際連線路徑取決於命中的策略與 FINAL,不是未命中網域規則就一定會直連。

適用情境:設定確認無誤後的日常規則分流

Proxy

讓進入代理通道的請求使用代理路徑,方便暫時排除 Config 中規則策略的影響;這無法修正錯誤的伺服器驗證參數。

適用情境:短時間檢查所選伺服器的連線路徑

Direct

使用直連路徑,不能以此狀態下的網頁瀏覽結果證明所選代理伺服器正常。

適用情境:比對目前網路的直連狀況

結論:先找出失敗階段

清單為空時先檢查訂閱取得狀況;清單存在但測試失敗時先檢查伺服器參數;測試成功但目標請求的路徑不符時,再檢查 Global Routing 和 Config。每次只變更一項條件,並記錄變更前後的結果。

Connectivity Test 的單次結果不能代表所有目標、所有協定或持續傳輸的表現。驗證時保留具體錯誤訊息,區分逾時、驗證失敗與解析失敗,再以相同網路和伺服器重複測試。不要為了重新整理訂閱而修改 DOMAIN-SUFFIX、GEOIP、IP-CIDR 或 FINAL;這些是路由規則,不是修復訂閱 URL 的選項。

匯入與更新失敗:依狀況逐項檢查

「已儲存 Subscribe,為什麼還是沒有伺服器?」

返回 Home 下拉重新整理,確認訂閱是否確實完成取得。接著開啟該訂閱檢查 URL,確認不是服務商登入頁、重新導向頁,或複製不完整的網址。若回傳的是 HTML 網頁而非可辨識的訂閱內容,請向自己的服務商重新取得正確網址。

「更新一直逾時,需要先開啟連線嗎?」

先確認裝置能否連上訂閱網域;若已有可用伺服器,可先建立連線再重試。若需要讓訂閱請求經由代理傳送,請檢查 Settings → Subscribe → Update via Proxy。尚未有可用連線時,開啟此選項本身並不會建立代理,應先檢查目前網路,或向服務商確認訂閱是否可連線。

「出現 401 或 403,是用戶端設定錯誤嗎?」

這類 HTTP 狀態表示伺服器拒絕了請求,可能與 token 失效、帳戶狀態或存取限制有關。先確認完整 URL,再向服務商確認權限;不要把 HTTP 錯誤誤認為伺服器 Port 錯誤,也不要反覆新增相同訂閱。

「複製了連結,卻沒有匯入提示怎麼辦?」

先確認複製的是純文字連結,並檢查系統是否阻止貼上。若是訂閱網址,直接使用 Home →「+」→ Type → Subscribe 手動貼上;若是單一分享連結,請確認協定前綴與內容完整,仍無法辨識時改用服務商提供的參數表逐項確認。

「已經看到伺服器,為什麼網頁還是打不開?」

先選取目標伺服器並執行 Connectivity Test,確認連線開關已開啟,再檢查 Global Routing 是否符合預期。若連線正常但部分網域失敗,接著檢查 DNS 與 Config 中命中的規則。Settings → On Demand 用來管理按需連線條件,無法修復訂閱解析問題或錯誤密碼。

除錯完成後,刪除不再需要的重複項目,保留容易辨識的訂閱備註。向服務商回報時,可提供失敗階段、錯誤文字、使用的網路,以及是否啟用 Update via Proxy;請勿附上完整訂閱 URL、密碼、UUID 或私鑰。

下載各平台版 Shadowrocket