本文重點

如果已有自己的訂閱或伺服器資訊，請先確認取得的是訂閱 URL、單一伺服器 URI，還是遠端設定檔，再選擇 Subscribe、Add Server、掃描或剪貼簿匯入。本文說明 Shadowrocket（小火箭）各入口的適用範圍，以及匯入後的檢查順序；成功儲存只代表內容已寫入，不表示伺服器已可使用。

先分清訂閱、單一伺服器與設定檔

訂閱通常是一個可更新的 URL，App 會從該網址讀取伺服器清單。單一伺服器 URI 則會將一台伺服器的協定與連線參數編碼成一段文字，通常只會新增一個項目。兩者都可能透過 QR Code 或剪貼簿傳送，因此「掃描」和「複製」只是輸入方式，並非內容類型。

Config 用來管理設定檔，Home 顯示伺服器與訂閱群組，Settings 則管理 App 設定。遠端設定檔也可能使用 HTTPS 網址，但其內容是規則、DNS 與策略等設定；不能因為網址看起來像一般連結，就把它當成伺服器訂閱匯入。

訂閱 URL

範例網址
https://example.com/sub?token=xxxx
匯入類型
Subscribe
儲存內容
可透過原始網址更新的伺服器群組
敏感資訊
路徑、查詢參數與存取權杖

以上是假資料範例，並非可用訂閱；請填入自己持有的完整網址。

單一伺服器 URI

常見前綴
ss://、vmess://、vless://、trojan://
儲存內容
單一伺服器的連線參數
匯入方式
掃描、剪貼簿，或依參數手動填寫
更新方式
一般獨立項目不會自動變成可更新的訂閱

協定前綴有助於辨識內容，但不代表 URI 欄位一定完整或正確。

取得連結時，先確認提供者對內容類型的說明。如果只拿到一個網頁入口，請取得其中明確標示的訂閱網址或伺服器參數，不要直接將登入頁、訂單頁或說明頁貼到 Subscribe。也不要使用公開的線上轉換工具測試含有權杖的私人連結。

Subscribe：新增可更新的伺服器清單

若要新增伺服器訂閱，請從 Home 右上角的「+」進入 Add Server，並在 Type 中選擇 Subscribe。搜尋「Config 頁面的 Subscribe」時，請特別留意：Config 的遠端設定操作與 Home 的伺服器訂閱並非同一種內容。若目前畫面顯示 Subscribe，請先確認所在頁面與要匯入的內容，不要混用遠端設定網址和伺服器訂閱網址。

  1. 確認內容

    準備自己的訂閱 URL，確認文字包含完整的協定標頭、路徑與查詢參數，且不含引號、換行或聊天訊息中的說明文字。

  2. 開啟匯入入口

    依序進入 Home → 右上角「+」→ Add Server → Type → Subscribe，確認新增的是伺服器訂閱，而非 Config 中的遠端規則設定。

  3. 貼上網址

    將完整網址填入 URL。名稱或備註僅供辨識群組，可填寫自己的用途標籤；請勿將整個訂閱網址當成公開備註。

  4. 儲存並更新

    儲存後返回 Home，確認是否出現訂閱群組與伺服器項目。如果清單尚未載入，請更新該訂閱並查看結果。

  5. 檢查結果

    展開群組，確認名稱、協定與項目數量是否符合既有資訊。如果群組是空的，請先排查連線或格式問題，不要連續重複新增相同網址。

初次儲存後取得清單，以及後續更新，都仰賴訂閱網址可連線並傳回相容內容。若已有群組，應更新原有群組，不必每次重新匯入。重複新增會出現多個名稱相近的群組，增加選錯項目的風險。

Add Server：手動新增單一伺服器

如果只有伺服器位址、連接埠、密碼或 UUID 等欄位，請從 Home →「+」→ Add Server 手動新增。Type 應選擇實際使用的協定，不要只因手上有網域名稱就選 Subscribe。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位結構各不相同，不能套用同一份參數表。

欄位類別檢查項目常見錯誤
Type與現有服務說明中的協定一致把 VLESS 參數填入 VMess 項目
Address伺服器網域名稱或 IP 位址把完整網頁 URL（含路徑）填入位址欄位
Port服務實際監聽的連接埠，數值範圍為 1–65535看到 TLS 就自行改成 443
身分憑證依協定填寫密碼、UUID 或金鑰複製時帶入空格，或把備註當成密碼
TLS 與傳輸方式逐項確認 TLS、SNI、傳輸類型與路徑等適用欄位以為網域名稱相同，就可以忽略 SNI 或路徑差異

443 是常見服務連接埠之一，並非通用答案。TLS 是否啟用、伺服器名稱如何填寫，以及是否使用 WebSocket 等傳輸方式，都應以現有設定為準。WireGuard 還涉及金鑰、位址與 Peer 等專用參數，不宜從一般代理的密碼欄位推測。

掃描與剪貼簿：依內容選擇匯入方式

可從 Home 的掃描圖示開啟掃描入口；使用相機時，請依系統提示授予權限。QR Code 可能包含單一伺服器 URI、訂閱 URL，也可能只是一般網頁網址。掃描後先查看辨識結果與確認畫面，再決定是否儲存；辨識到 QR Code 不代表伺服器已新增。

QR Code 與剪貼簿匯入檢查

QR Code 顯示在另一個螢幕上
  • 在 Home 開啟掃描入口，讓 QR Code 完整顯示在取景範圍內。
  • 確認辨識內容是訂閱 URL 還是單一伺服器 URI。
  • 確認儲存後返回 Home，查看新增的群組或項目。
  • 若顯示一般網頁網址，請先取得真正的設定內容。
文字位於目前使用的裝置上
  • 只複製完整連結，不要連同標題、項目符號或說明段落一起複製。
  • 返回 Shadowrocket；若出現剪貼簿匯入提示，請先確認辨識內容。
  • 系統詢問貼上權限時，請依本次匯入需求允許讀取。
  • 若沒有出現辨識提示，可將訂閱 URL 直接貼到 Subscribe 的 URL 欄位。

掃描與剪貼簿改變的是輸入方式；能否建立可更新的群組，仍取決於匯入內容是訂閱還是獨立伺服器。

若 QR Code 儲存在目前裝置上，而掃描畫面提供從照片讀取的入口，可選擇原始圖片；否則建議使用內容提供者一併提供的文字連結。裁切、縮放與圖片壓縮都可能造成辨識失敗，不應透過公開網頁重新編碼私人連結來解決。

剪貼簿沒有跳出提示，不一定代表格式錯誤，也可能與系統貼上權限或目前畫面有關。請先確認複製的是完整原文。單一伺服器 URI 不要硬貼到 Subscribe 的 URL 欄位；應使用可辨識 URI 的匯入入口，或依已知的完整參數手動填寫。

如何選擇 Subscribe 或獨立伺服器項目

選擇依據是是否需要透過原始網址維護伺服器清單，而不是哪種操作步驟較少。若已有可用訂閱，保留訂閱關係較方便日後更新；若只有固定單一伺服器的參數，獨立項目更直接。以下比較的是 Shadowrocket 內兩種不同的儲存方式。

Subscribe 訂閱群組

適用

儲存訂閱來源，並透過更新重新讀取清單。更新可能會變更伺服器名稱、數量或參數，因此訂閱應視為由原始來源維護的集合。

適用情況：已有訂閱 URL，且需要持續接收清單更新。

Add Server 獨立項目

儲存單一伺服器的參數，方便逐項核對。一般獨立項目不會依訂閱網址更新；參數變更時，需重新匯入或手動修改。

適用情況：已有單一伺服器的完整參數，或需要獨立檢查一條連線。

如果同一台伺服器同時出現在訂閱群組與獨立清單中，兩者是不同的儲存項目。修改其中一個時，不要假設另一個也會同步變更。刪除重複項目前，先確認目前選取的是哪一個，並保留原始資訊以便還原。

匯入後：先檢查清單，再測試連線

完整檢查可分為儲存、取得清單與連線三個階段。儲存失敗時檢查輸入內容；取得訂閱失敗時檢查 URL 與回應；清單已載入但網頁無法開啟時，則檢查伺服器參數、路由模式與 DNS。遇到第三階段的問題時，不要反覆刪除第一階段的訂閱記錄。

4 種
本文介紹的入口：Subscribe、Add Server、掃描、剪貼簿
4 項
Global Routing：Proxy、Direct、Config、Scene
1–65535
手動填寫 Port 的有效數值範圍，實際數值依服務設定而定
  1. 確認 Home 清單。訂閱群組內有項目，目標伺服器可選取，且協定符合預期；延遲測試有結果，也不代表所有網站都能連線。
  2. 確認 Global Routing。Proxy 用於代理路徑，Direct 用於直連路徑，Config 依目前設定處理，Scene 則依已設定的場景處理。選擇時應配合測試目標，不要只看連線開關。
  3. 確認系統授權。首次啟用連線時，請依系統提示新增 VPN 設定。完成授權後，再檢查連線狀態與請求結果。
  4. 確認 Config。使用 Config 模式時，請檢查目前實際啟用的設定。DOMAIN-SUFFIX、GEOIP、IP-CIDR 等規則會決定比對條件，FINAL 則處理先前未符合規則的請求；匯入伺服器訂閱不代表這些規則已設定完成。
  5. 先不要設定自動觸發。Settings → On Demand 用於設定隨選連線條件，無法修正錯誤憑證或失效連結。請先手動測試連線，再調整自動觸發設定。

常見匯入問題與排查順序

儲存訂閱後只有群組，沒有伺服器，該怎麼辦？

先更新原有群組，再查看錯誤訊息。確認 URL 沒有漏掉 token、沒有多餘空格，也不是登入頁面。若請求傳回網頁、空白內容或不相容格式，網址本身仍可能成功儲存，但無法產生有效清單。重複新增相同網址無法修正回應內容。

出現 HTTP 401、403 或 404 時，分別要檢查什麼？

401 通常表示驗證未通過，403 表示請求遭拒，404 表示找不到要求的資源；這些狀態碼只能協助判斷問題，無法單獨證明確切原因。請檢查完整連結是否變更、權杖是否仍有效，以及目前網路能否連線至訂閱來源。尋求協助時可提供狀態碼，但不要公開完整 URL。

QR Code 可以掃描，為什麼沒有匯入多台伺服器？

先查看辨識到的內容。單一伺服器 URI 通常只對應一個項目；只有指向伺服器清單的訂閱網址，才可能建立訂閱群組。如果 QR Code 內容是說明網頁，請從自己的原始資料取得實際訂閱或參數；掃描網頁並不會將其轉換成訂閱。

可以把 Config 中的遠端檔案網址貼到 Subscribe 嗎？

不要只看網址外觀就決定。遠端設定包含路由、DNS 等設定，伺服器訂閱則主要提供伺服器清單；兩者都可能使用 HTTPS 網址。請先確認內容用途：設定檔由 Config 管理，伺服器訂閱則從 Home 的 Subscribe 類型新增。匯入設定前，也應先了解它會如何處理請求。