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

先確認內容類型：訂閱網址不等於設定檔

Shadowrocket（小火箭）的匯入入口各自處理不同內容。節點訂閱用於批次取得及更新伺服器資料；遠端設定檔通常包含分流規則與全域參數；單一分享連結則描述一台伺服器。即使三者看起來都是一段文字，也不能使用同一個匯入入口。

訂閱連結請向自己的服務商取得。不要把帳號登入頁面、購買紀錄頁面或網頁上的說明文字當成訂閱網址。HTTP 或 HTTPS 僅表示網址使用的傳輸方式，不代表回傳內容一定能識別；也要確認服務商提供的內容類型。

以 https://example.com/sub?token=xxxx 為例，整行內容才是完整網址，包含問號後的參數。這只是網址格式示意，不能用來連線。真實訂閱中的 token 是存取憑證，請勿放在公開截圖、聊天紀錄或問題回報中。

Subscribe：分清 Home 與 Config 的訂閱用途

批次新增伺服器時，請使用 Home 的新增入口，在 Type 中選擇 Subscribe，再輸入服務商提供的訂閱 URL。儲存後確認訂閱群組是否建立，以及群組中是否出現伺服器資料。若只有群組名稱、沒有伺服器資料，通常表示訂閱尚未成功取得，或回傳內容無法解析，不能視為匯入完成。

Config 頁面的 Subscribe 用於遠端設定檔訂閱，與 Home 中用來匯入伺服器的 Subscribe 處理的不是同一類內容。匯入遠端設定檔時，請在 Config 的新增入口輸入設定檔 URL，下載後再選取該設定檔；Subscribe 則用於查看或管理這類設定檔訂閱。不要把任意節點訂閱 URL 輸入 Config，並期待它自動產生完整的規則設定檔。

1. 確認網址

   向自己的服務商取得節點訂閱 URL，確認它不是登入頁面；複製時保留 ?、&、= 及其後的參數。

2. 選擇類型

   前往 Home → +，在 Add Server 編輯畫面的 Type 中選擇 Subscribe，不要沿用上次手動新增時的協定類型。

3. 輸入網址

   將完整網址貼到 URL，填寫方便辨識的備註後儲存。名稱只會影響顯示，不會變更網址或驗證資訊。

4. 確認伺服器資料

   返回 Home，等待首次取得完成；必要時向下滑動重新整理，確認該訂閱下是否出現伺服器，並核對資料筆數是否符合服務商說明。

5. 保留訂閱

   之後請更新現有訂閱群組，不要每次都重複新增相同的 URL。更新時可能會取代伺服器欄位，單筆資料的暫時修改不一定會保留。

Add Server：依協定手動輸入連線參數

只有伺服器參數、沒有訂閱 URL 時，請前往 Home → + 開啟 Add Server，先選擇 Type，再逐項輸入位址、連接埠與驗證資訊。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各不相同；即使都能建立代理連線，也不能將同一組欄位照搬到不同 Type。

例如，VLESS 通常使用 UUID 作為使用者識別碼，Trojan 則使用 Password；啟用 TLS 時，也要確認服務商提供的伺服器名稱、憑證及傳輸設定。位址可以是網域名稱，連接埠則須填入服務商指定的整數。範例中的 443 僅供連接埠示意，並非所有協定的固定預設值。

手動儲存的伺服器資料只會保留目前參數，不會自動追蹤服務商之後的變更。若伺服器網域、連接埠或驗證資訊有變動，必須重新編輯；若現有訂閱能提供同一筆資料，建議優先更新訂閱，避免長期維護兩筆內容不一致的資料。

掃描 QR Code：依照內容解析

掃描入口位於 Home 頂端的掃描圖示。首次使用時須允許相機存取；若無法開啟相機，請在系統設定中檢查 Shadowrocket 的相機權限。掃描時讓完整 QR Code 位於取景範圍內，避免遮住邊緣或只掃描中央圖案。

QR Code 只是文字載體，不一定代表訂閱。內容可能是單一 ss://、vmess://、vless:// 或 trojan:// 分享連結，也可能是 HTTPS 網址。識別後仍須確認匯入提示，判斷解析出的是一筆伺服器資料，還是應作為訂閱處理的 URL。

• 沒有識別結果：先檢查影像是否清晰、有無反光及 QR Code 是否完整；調高螢幕亮度後重新掃描，或請服務商提供原始文字連結。
• 辨識結果是一般網頁：QR Code 內容可能是說明頁或帳號頁面，不應直接儲存為節點訂閱。
• 已新增資料但欄位不完整：確認 QR Code 是否完整、連結是否遭截斷，以及目前協定參數是否能正確解析。
• QR Code 顯示在同一台裝置上：使用掃描介面提供的相簿入口（若有），或複製原始連結，改用剪貼簿匯入，不必重複拍攝螢幕。

服務商更換 QR Code 後，先前手動匯入的資料不會自動更新。若要持續同步伺服器清單，請使用服務商提供的訂閱 URL，不要把掃描一次 QR Code 當成長期更新方式。

剪貼簿：複製完整連結，而非整段說明

複製協定分享連結後返回 Home，查看是否出現剪貼簿匯入提示；也可以使用新增選單中的剪貼簿匯入項目。系統詢問是否允許貼上時，請允許本次讀取。若沒有提示，先確認剪貼簿中仍是連結文字，再重新開啟對應的匯入入口。

分享連結通常以協定前綴開頭，例如 ss://、vmess://、vless://、trojan://。其中的編碼內容、百分比編碼及查詢參數都是連結的一部分，請勿自行解碼、刪除或改用中文標點符號。只複製伺服器網域名稱並不是完整的分享連結。

若複製的是 HTTPS 訂閱網址，建議直接前往 Home → + → Type → Subscribe，較容易確認內容類型。一次複製多條分享連結時，每行只放一條，並移除項目符號、引號和說明文字；匯入後逐筆確認名稱與參數。剪貼簿讀取失敗屬於匯入階段問題，與代理連線是否成功無關。

匯入後檢查：先更新，再測試連線與分流

匯入成功只表示內容已儲存或解析完成，不保證遠端服務可連線。返回 Home 選取一筆資料，先執行 Connectivity Test，再開啟連線。首次連線時，依系統提示允許新增 VPN 設定。測試有回應，只能表示相應的測試路徑可用，仍須以實際目標確認連線。

1. 確認選取項目：確認選取的伺服器來自剛匯入的群組，而非先前儲存的舊資料。
2. 確認 Global Routing：Proxy 會以代理方式處理流量；Direct 會直接連線；Config 依所選設定檔進行分流；Scene 則依已設定的情境運作。不要因為在 Direct 模式下能開啟網頁，就認為代理已通過驗證。
3. 確認 Config：使用 Config 模式時，請確認已選取預期的設定檔。規則會依序比對，例如 DOMAIN-SUFFIX,example.com,DIRECT 會將相符網域交由 DIRECT 處理，FINAL 則用於最後兜底。
4. 確認自動連線：Settings → On Demand 用於管理依條件觸發的連線行為，不負責下載訂閱，也無法修正錯誤的伺服器參數。手動排查時，請先確認目前的連線狀態。

更新訂閱與連線至伺服器，是兩次不同的網路請求。前者可能因訂閱網址過期而失敗；後者也可能因單一伺服器無法連線而失敗。排查時請記下錯誤訊息、發生階段及目前網路類型，避免只留下「匯入失敗」或「不能用」等無法判斷原因的描述。

常見錯誤：依失敗階段排查