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

說明在 Config 頁使用 Subscribe 匯入訂閱連結、透過 Add Server 手動新增、掃描 QR Code 或從剪貼簿匯入;逐一介紹入口位置與適用格式,範例皆為虛構。

本文重點

本文以 iPhone / iPad 上的 Shadowrocket(小火箭)介面為操作參考,適合已持有服務商提供的資料與訂閱連結者。先辨別伺服器訂閱和 Config 規則設定,再選擇 Subscribe、Add Server、掃描 QR Code 或剪貼簿入口;最後透過列表、更新結果和 Connectivity Test,分別確認匯入狀態與連線情形。其他平台請依實際介面尋找同名功能,不要直接套用行動版的按鈕位置。

先分清 Subscribe 訂閱與 Config 設定

在 iPhone / iPad 上,伺服器訂閱和規則設定是不同類型的資料。伺服器訂閱用來取得伺服器項目,Config 則用來管理規則設定檔;看到「設定連結」時,請先確認連結實際回傳的內容,不要只看名稱就決定匯入位置。本文不提供、不販售或推薦節點或訂閱,所有操作均以使用者已有資料為前提。

在 iPhone / iPad 上,新增伺服器訂閱通常從 Home 右上角的「+」進入 Add Server,再將 Type 設為 Subscribe;不要以為所有訂閱操作都是在 Config 頁貼上連結。Config 的遠端設定管理與伺服器訂閱用途不同,即使兩者都使用 HTTPS 網址,也不能互相替代。

4 種
本文介紹的入口:Subscribe、Add Server、掃描 QR Code、剪貼簿
2 類
先辨別伺服器訂閱與規則設定檔
443
HTTPS 預設連接埠不等於伺服器連線埠

Subscribe:匯入現有訂閱並確認列表

在 iPhone / iPad 上,若已有相容的伺服器訂閱,可使用 Subscribe 保留訂閱來源並取得項目。以下假網址僅供說明格式,無法用來連線;實際輸入時,請使用自己持有的完整連結,包括查詢參數,不要省略 token 或自行變更大小寫。

https://example.com/sub?token=xxxx
  1. 開啟新增頁面

    前往 Home → 右上角「+」,開啟 Add Server。請先確認這是新增伺服器的介面,而非 Config 中編輯規則檔案的頁面。

  2. 選擇訂閱

    在 Type 中選擇 Subscribe,並將自己的訂閱網址填入 URL。若頁面提供備註欄位,可填寫方便辨識的名稱,但不要把憑證寫進名稱。

  3. 儲存並讀取

    確認 URL 前後沒有空格、換行或遺漏查詢參數後再儲存。返回 Home,等待訂閱讀取完成;若要重試,請使用該訂閱的更新功能或下拉重新整理。

  4. 檢查項目

    展開對應的訂閱,確認是否出現伺服器項目,再選取其中一個已有項目。只看到訂閱名稱,不代表內容已成功讀取,也不代表 VPN 已連線。

Add Server:依協定逐項填寫,不要貼上整份訂閱

在 iPhone / iPad 上,若手邊只有伺服器位址、連接埠和驗證欄位,請使用 Home →「+」→ Add Server 手動填寫。Type 應與現有資料一致;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位意義各不相同,不能只更改 Type,就把同一組憑證轉成另一種協定。

Type:Subscribe

建議

已有相容訂閱時,優先使用此設定以保留來源,並透過更新取得列表變動。此處的建議僅適用於本文所述的「已有訂閱」操作情境,不涉及任何服務選擇。

適用情況:持有完整訂閱 URL,且需要日後更新列表

Type:特定協定

在 Add Server 中選擇資料指定的協定,逐項填寫位址、連接埠、驗證資訊與傳輸參數。手動新增的項目不會因原訂閱變更而自動取得新參數。

適用情況:持有完整的單一伺服器參數,需要逐欄核對

Trojan 教學用假資料

Type
Trojan
Address
example.com
Port
443
Password
example-password-not-valid
SNI
example.com

僅示範欄位之間的關係,無法用來連線。實際連接埠、SNI 和 TLS 要求,請依據已有資料填寫。

手動填寫檢查項目

Address
只填主機名稱或 IP,不要加上 https://
Port
填寫伺服器連接埠,不要照抄訂閱 URL 的連接埠
驗證欄位
依協定填寫 Password、UUID 或金鑰
傳輸參數
依據已有資料分別核對 Path、Host、SNI

欄位是否可以留空,取決於協定與伺服器端設定;不要以反覆切換協定代替核對資料。

在各平台手動填寫時,TLS 的 SNI 與傳輸層 Host 用途可能不同;即使已有資料提供相同值,也應分別填入對應欄位。若遇到憑證錯誤,請先確認主機名稱、裝置時間及資料是否仍有效,不要把關閉憑證驗證當成一般解法。

掃描 QR Code:先確認其中包含什麼內容

在 iPhone / iPad 上,Home 頂端的掃描入口可讀取 QR Code 內容;QR Code 只是承載文字的方式,不保證內容一定是伺服器參數。掃描結果可能是單一分享連結、訂閱網址,也可能只是說明網頁;請先查看辨識內容,再決定是否儲存。

  1. 在另一台裝置上開啟自己已有的 QR Code 資料,確保影像清晰且四角完整;不要裁切到只剩中間部分。
  2. 前往 Home 的掃描入口,首次使用時依系統提示授予相機權限。若相機無法使用,請到系統設定確認 Shadowrocket 的相機權限。
  3. 讀取後檢查協定類型或 URL。單一連結應進入對應的伺服器資料確認流程;HTTPS 網址則需進一步確認是訂閱還是一般網頁。
  4. 儲存後返回 Home,確認是否新增內容。若掃描只開啟網頁,沒有建立項目,請勿反覆掃描;應回到原始資料說明,確認 QR Code 的用途。

剪貼簿:複製完整連結,再確認辨識結果

在 iPhone / iPad 上,剪貼簿匯入適用於已取得文字格式分享連結的情況。先複製純文字,再開啟 Shadowrocket;出現讀取或匯入提示時,請確認內容後再操作。系統是否詢問貼上權限、應用程式是否自動辨識,取決於系統權限與實際介面;開啟後沒有彈出提示,不代表連結失效。

  1. 複製完整文字:不要只複製聊天軟體中縮短顯示的半截網址;可使用系統的文字選取功能確認末尾參數沒有遺失,但不要交給外部網頁檢查。
  2. 處理貼上權限:若系統詢問是否允許貼上,確認來源後再允許。若先前已拒絕,可到系統設定確認該應用程式的貼上權限選項。
  3. 確認類型:單一協定連結請核對產生的伺服器欄位;若一般 HTTPS 訂閱網址沒有自動辨識,請前往 Home →「+」→ Type → Subscribe,再手動貼到 URL。
  4. 儲存後確認:對照 Home 列表確認項目是否存在,不要只看提示是否消失。重複匯入前先檢查現有項目,避免同一來源新增多次。

在各平台複製資料時,行尾換行、全形標點符號,以及聊天軟體附加的說明文字都可能影響解析。請重新複製原始連結,不要隨意刪除連結中看似複雜的編碼字元;百分比編碼、斜線和等號都可能是有效內容的一部分。

匯入後分三層確認:列表、連線與規則

在 iPhone / iPad 上,「匯入完成」只代表資料已儲存或解析,不等於連線成功。請先確認 Home 列表,再執行 Connectivity Test,最後檢查實際請求的路由;首次連線時若系統要求新增 VPN 設定,請了解並授予所需權限,才能建立連線。

驗證層級查看位置可得出的結論
資料解析Home 中的訂閱群組與伺服器項目有項目表示已完成解析,無法證明伺服器目前可連線。
連線測試Home → Connectivity Test測試結果取決於所選方法,不能取代實際業務請求。
路由選擇Home → Global RoutingConfig、Proxy、Direct、Scene 是路由模式,不是訂閱格式。

在 iPhone / iPad 上,Global Routing 選擇 Config 時,請求會依目前啟用設定中的規則處理;選擇 Proxy 通常會讓可接管的流量依代理策略處理;Direct 用於直連,Scene 則依已設定的情境處理。排查時先記錄原設定,一次只修改一項,驗證後再還原;不要同時更換訂閱、規則和路由模式。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

在使用 Config 的平台上,以上僅為規則語法示意,不能直接取代現有的完整設定檔。規則由上而下比對:DOMAIN-SUFFIX 依網域後綴比對,IP-CIDR 依 IP 位址範圍比對,GEOIP 依 IP 位址歸屬比對,FINAL 則放在最後作為預設規則。更新訂閱不會自動修正錯誤的規則順序;規則未命中也不代表訂閱 URL 有問題。

更新失敗與常見狀況的排查順序

在各平台上,更新訂閱會重新向來源提出請求並解析回應;伺服器連線則使用已儲存的項目,兩者是不同流程。更新失敗時,舊項目可能仍然保留,因此請先記錄目前列表與錯誤訊息,不要立刻刪除整個訂閱,也不要只靠連續點擊更新來排查原因。

已儲存 Subscribe,但列表中沒有伺服器項目,怎麼辦?

先確認 URL 完整,再檢查更新結果。若回傳的是登入頁面、HTML 錯誤頁或不相容格式,即使 HTTPS 請求成功,也無法建立項目。若看到 HTTP 401 或 403,優先確認存取憑證與授權狀態;若為 404,則檢查路徑。實際原因請以回應內容及原始資料說明為準。

訂閱可以更新,但 Connectivity Test 失敗,怎麼辦?

這表示應分開排查訂閱讀取與伺服器連線。先確認所選項目、連接埠、協定參數、裝置時間及目前網路,再查看其他已有項目的測試結果。訂閱 URL 使用 HTTPS 的 443 連接埠,不代表所有伺服器也使用 443。

更新後項目改變或手動修改消失,怎麼辦?

訂閱內容取決於來源回傳結果,更新時可能會重新建立項目。需要保留的個人調整,請先記錄下來,並區分訂閱產生的項目與獨立手動新增的項目。不要假設手動修改的參數會永久覆蓋後續更新,也不要只因項目數量變化就認定應用程式遺失資料。

匯入後連線會自動恢復嗎?如何確認?

在 iPhone / iPad 上,先檢查 Settings → On Demand,再確認系統 VPN 中的隨選連線狀態。On Demand 會影響符合條件時是否建立連線,不會修正訂閱內容。測試匯入時若需暫時關閉,請先記錄原本的條件,測試完成後再依需求恢復。

下載 Shadowrocket