Shadowrocket 訂閱匯入教學：Config 的 Subscribe、Add Server 手動新增、掃描 QR Code 與剪貼簿匯入

一、匯入前先分清訂閱、單一連結與設定檔

Shadowrocket（小火箭）是 Apple 平台上的付費用戶端，購買 App 與取得連線服務是兩回事。本文以使用者已擁有自己的服務提供者與訂閱為前提；本站不提供、不販售，也不推薦節點或訂閱。App 僅能透過 App Store 取得，正版核對與購買說明請見正版核對頁。

四種匯入方式並非四種協定，也不保證最後產生相同內容。訂閱網址通常指向可更新的伺服器列表；單一分享連結描述一條連線；遠端設定檔則可能包含規則、DNS 與策略等設定。應依據連結實際傳回的內容及提供者說明判斷，不能只看網址是否以 https:// 開頭。

訂閱 URL 的查詢參數常包含存取憑證。請勿將完整連結貼到公開討論區，也不要把 QR Code 當成不含敏感資訊的一般圖片。下方的 https://example.com/sub?token=xxxx 僅為格式示例，無法用於連線或測試。

二、Subscribe 入口：先確認 Config 與 Home 的用途

尋找「Config 頁面的 Subscribe」時，請先確認目前要處理的是哪一種資源。Config 主要管理設定檔，Home 主要顯示伺服器與連線狀態，Settings 則用來管理 App 設定。即使某個入口標示 Subscribe，也不代表任何伺服器訂閱都應貼到 Config。

一般伺服器訂閱可從 Home → + → Add Server → Type → Subscribe 新增，其中 Add Server 是新增頁面的標題。如果手上的資料明確是遠端設定檔，請使用 Config 中的遠端設定檔新增入口，匯入後再確認設定內容。不要只為了尋找某個文字標籤，就把伺服器列表網址反覆匯入設定檔列表。

1. 確認資料

   確認提供者提供的是伺服器訂閱網址，而不是帳戶管理網頁、付款頁面或遠端設定檔網址。

2. 開啟新增頁面

   前往 Home → +，在 Add Server → Type 中選擇 Subscribe。

3. 輸入網址

   將完整訂閱網址貼到 URL，並在 Remarks 填入容易辨識的名稱。保留網址中的路徑、問號及其後所有參數。

4. 儲存並更新

   點選 Done 返回 Home，等待列表載入完成；若要重新載入，請在 Home 下拉以重新整理訂閱列表。

5. 檢查群組

   展開對應的訂閱，確認是否出現伺服器項目。若只有群組名稱而沒有項目，請繼續檢查請求結果與訂閱格式。

三、Add Server 手動新增：適用於已有完整連線參數

若手上只有伺服器參數，沒有可辨識的分享連結，就適合手動新增。這會建立伺服器紀錄，不會自動產生可重新整理的訂閱。進入 Home → + → Add Server 後，先選擇 Type，再填寫該協定所需欄位；不同協定的驗證資料不可混用。

例如，伺服器位址與連接埠正確，但 TLS 伺服器名稱或 WebSocket 路徑錯誤，仍可能導致連線失敗。不要只憑一次延遲測試，就判定整組參數正確。VMess、Trojan、Hysteria2、WireGuard 也各有自己的驗證與傳輸要求，請逐項依據手上的資料填寫，不要套用其他協定的欄位。

• 先確認 Type，再核對位址、連接埠、驗證資料與傳輸參數。
• 數字連接埠中不要加入空格、中文標點或網域名稱。
• 修改紀錄後請重新測試；不要同時變更協定、DNS 與規則，否則難以找出原因。
• 若要長期跟隨提供者更新，請優先使用對方提供的有效訂閱，而非手動維護大量項目。

四、掃描 QR Code 與剪貼簿：入口不同，內容仍須確認

掃描 QR Code 與剪貼簿只是將文字傳入 App 的方式，不會改變文字的含義。同一個 QR Code 可能包含單一 ss:// 連結、訂閱 URL 或一般網頁網址。匯入後務必確認取得的是單一伺服器、訂閱群組，還是無法辨識的內容。

iPhone 或 iPad 可能會詢問是否允許從其他 App 貼上。拒絕後若未出現辨識結果，不能直接認定連結無效；請先確認是否完成必要授權，或回到 Subscribe 表單手動貼上。若同一份資料已匯入過，重複掃描或複製可能產生重複項目，不建議用反覆匯入取代故障排查。

訂閱 URL 虛構範例：
https://example.com/sub?token=xxxx

單一分享連結常見前綴：
ss://
vmess://
vless://
trojan://

前綴後的內容可能包含編碼過的驗證資料、伺服器資訊與傳輸參數。請勿任意刪除等號、斜線、百分比編碼或查詢參數，也不要只憑連結長短判斷是否完整。上述前綴僅用於辨識格式，並非可匯入的完整連線資料。

五、匯入完成後，分別確認列表、更新與路由

「儲存成功」、「更新成功」與「網頁可瀏覽」是三種不同的檢查結果。儲存成功只表示 App 已接收輸入；更新成功表示訂閱資源已取得並解析；網頁能否瀏覽，還取決於伺服器狀態、驗證資料、DNS 與目前的路由設定。請先在 Home 確認實際項目，再選擇自己已有的一台伺服器進行測試。

在 Home 的 Global Routing 中，Config、Proxy、Direct、Scene 是路由模式，不是訂閱協定。變更這裡的選項無法修正錯誤的訂閱 URL。以下僅比較排查時常用的三種模式；Scene 會依據所設定的場景運作，未查看場景內容前，無法判斷實際行為。

使用 Config 時，DOMAIN-SUFFIX 用來比對網域後綴，GEOIP 與 IP-CIDR 處理 IP 相關條件，FINAL 用於最後的兜底規則。這些規則應放在設定檔中，不可貼到訂閱 URL 欄位。設定自動連線則是另一項工作：入口為 Settings → On Demand，請先完成手動連線確認，再依自己的網路情境設定。

六、訂閱內容為空、更新失敗與重複項目的處理順序

更新失敗時，請先保留原本可用的項目，不要立即刪除所有設定。問題可能出在網址輸入、資源請求、內容解析或後續連線階段。逐階段縮小範圍，比不斷更換匯入方式更容易找出原因。

1. 確認完整 URL。 對照原始資料檢查通訊協定、網域、路徑及 token 等參數；聊天 App 顯示的省略文字不能視為完整網址。
2. 確認傳回內容。 若開啟網址後顯示登入頁面或錯誤訊息，而非預期的訂閱內容，代表取得的可能不是直接訂閱資源。請勿將帳戶密碼填入伺服器驗證欄位來補救。
3. 確認資源格式。 一般網頁可以開啟，不代表其內容能由 Subscribe 解析。請向現有服務的提供者確認所提供的格式是否適用於 Shadowrocket。
4. 確認目前網路。 區分網域無法解析、連線逾時與明確的驗證失敗。每次只調整一項條件，並記錄更新結果，避免同時修改 DNS、規則與伺服器資料。
5. 確認訂閱來源。 同一台伺服器可能同時來自手動新增的紀錄與訂閱群組。清除重複項目之前，先確認各自來源，避免刪除需要保留的整個訂閱。
6. 確認憑證是否有效。 若原網址已撤銷或更換，請使用自己的新網址更新原訂閱紀錄。不要繼續轉傳或反覆嘗試已失效的舊網址。