如果已有自己的訂閱或伺服器資訊，請先確認取得的是訂閱 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，請先確認所在頁面與要匯入的內容，不要混用遠端設定網址和伺服器訂閱網址。
-
確認內容
準備自己的訂閱 URL，確認文字包含完整的協定標頭、路徑與查詢參數，且不含引號、換行或聊天訊息中的說明文字。
-
開啟匯入入口
依序進入 Home → 右上角「+」→ Add Server → Type → Subscribe，確認新增的是伺服器訂閱，而非 Config 中的遠端規則設定。
-
貼上網址
將完整網址填入 URL。名稱或備註僅供辨識群組，可填寫自己的用途標籤；請勿將整個訂閱網址當成公開備註。
-
儲存並更新
儲存後返回 Home，確認是否出現訂閱群組與伺服器項目。如果清單尚未載入，請更新該訂閱並查看結果。
-
檢查結果
展開群組，確認名稱、協定與項目數量是否符合既有資訊。如果群組是空的，請先排查連線或格式問題，不要連續重複新增相同網址。
初次儲存後取得清單，以及後續更新，都仰賴訂閱網址可連線並傳回相容內容。若已有群組，應更新原有群組，不必每次重新匯入。重複新增會出現多個名稱相近的群組，增加選錯項目的風險。
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。遇到第三階段的問題時，不要反覆刪除第一階段的訂閱記錄。
- 確認 Home 清單。訂閱群組內有項目，目標伺服器可選取，且協定符合預期；延遲測試有結果，也不代表所有網站都能連線。
- 確認 Global Routing。Proxy 用於代理路徑，Direct 用於直連路徑，Config 依目前設定處理，Scene 則依已設定的場景處理。選擇時應配合測試目標，不要只看連線開關。
- 確認系統授權。首次啟用連線時，請依系統提示新增 VPN 設定。完成授權後，再檢查連線狀態與請求結果。
- 確認 Config。使用 Config 模式時，請檢查目前實際啟用的設定。DOMAIN-SUFFIX、GEOIP、IP-CIDR 等規則會決定比對條件，FINAL 則處理先前未符合規則的請求；匯入伺服器訂閱不代表這些規則已設定完成。
- 先不要設定自動觸發。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 類型新增。匯入設定前，也應先了解它會如何處理請求。