有訂閱網址就用 Subscribe；需要逐項核對連線參數，就用 Add Server；已有 QR Code 或分享文字，則可透過掃描或剪貼簿匯入。本文以你已備妥服務商提供的資料與訂閱為前提，說明四種方式所需資料、儲存後的檢查方法，以及更新失敗時的排查順序。操作畫面以 iPhone / iPad 為例，其他平台請依對應欄位核對；匯入成功不代表連線成功。
一、先分清訂閱網址、單一連線與設定檔
Shadowrocket（小火箭）的匯入入口各自處理不同類型的資料。Subscribe 是訂閱：用戶端從一個網址讀取伺服器清單，之後也透過同一網址取得更新。Add Server 是新增伺服器：直接儲存一筆連線所需的協定與參數。掃描和剪貼簿則只是讀取資料的方式，讀取後仍須先判斷內容屬於哪種類型。
Config 是管理設定檔的頁面，遠端設定檔網址不可與伺服器訂閱混為一談。設定檔可能包含規則、DNS 等設定；伺服器訂閱則主要提供連線項目。查看 Config 頁面的 Subscribe 相關內容時，請先確認操作對象是伺服器訂閱，還是設定檔中的訂閱參照。常見的直接新增路徑是 Home → 右上角「+」→ Add Server → Type → Subscribe。
| 已有資料 | 辨認方式 | 處理方式 |
|---|---|---|
| 伺服器訂閱網址 | 通常是含有存取憑證的 HTTPS 網址，開啟後會回傳清單內容 | 在 Type 選擇 Subscribe，並填入 URL |
| 單一分享連結 | 常見開頭為 ss://、vmess://、vless://、trojan:// | 掃描或從剪貼簿讀取，再核對匯入欄位 |
| 個別連線參數 | 分別提供伺服器位址、連接埠、密碼或 UUID 等資料 | 在 Add Server 選擇對應的 Type 後手動填寫 |
| 遠端設定檔 | 內文包含設定區段、規則等內容，不只是伺服器清單 | 在 Config 管理，不要當成伺服器訂閱網址 |
以 https:// 開頭的網址也可能只是帳戶登入頁，不能只看開頭就判定為訂閱。請先從自己的服務資料確認用途，再匯入。以下是無法用來連線的格式範例，其中 example.com 是說明用網域，token=xxxx 是虛構值：
https://example.com/sub?token=xxxx二、Subscribe：新增訂閱並保留更新來源
已有訂閱網址時，建議儲存為 Subscribe，不要把其中的伺服器逐筆複製出來。這樣後續更新才能繼續從原始來源取得資料。匯入前請複製完整網址，不要連同「訂閱網址：」等說明文字，也不要把訊息中的換行或空格一起複製。
-
準備網址
從自己的服務資料複製訂閱 URL。檢查開頭、查詢參數與最後一個字元，保留原有大小寫與編碼，不要自行刪除問號後的內容。
-
開啟新增頁面
開啟 Home，點選右上角「+」進入 Add Server；在 Type 選擇 Subscribe。請勿為了貼上訂閱網址而選擇 Shadowsocks 等單一伺服器類型。
-
填寫訂閱資料
將完整網址填入 URL，並在備註欄輸入方便辨識的名稱，例如「個人訂閱」。備註僅供辨識來源，不會變更訂閱回傳的伺服器參數。
-
儲存並更新
儲存後返回 Home，確認訂閱群組是否出現；向下滑動以重新整理訂閱清單，並等待本次請求完成。第一次讀取失敗時，先保留錯誤訊息，不要連續重複新增。
-
核對項目
展開對應群組，確認其中有伺服器項目，並檢查名稱與協定是否符合自己的資料。接著選擇其中一筆進行連線測試，不要只因群組名稱出現就判定完成。
訂閱更新與連線測試是兩件事。前者確認用戶端能否下載並解析清單；後者確認清單中的特定伺服器是否可用。若訂閱更新成功但所有連線都失敗，請檢查伺服器參數與服務狀態；若訂閱更新本身失敗，應先檢查 URL、網路與回應內容。
同一個網址通常只需儲存一份。重複新增會產生難以辨識的重複來源，之後更新或刪除時容易選錯。需要更換網址時，先確認舊群組與目前選取的伺服器之間的關係，再編輯對應訂閱；手動修改過的訂閱項目也可能在之後更新時被來源資料覆蓋。
三、Add Server：依協定手動填寫連線參數
只有伺服器位址、連接埠與驗證資料，沒有可用訂閱時，請使用 Home →「+」→ Add Server。先選擇 Type，再填寫欄位。協定類型會決定驗證資料的格式，不能把 VMess 的 UUID 填入 Shadowsocks 的密碼欄，也不能把一般 TLS 設定當成所有協定共用的開關。
Shadowsocks 欄位
- Type
- Shadowsocks
- Address
- 填入自己的伺服器網域或 IP
- Port
- 填入資料指定的連接埠，例如 443
- Method
- 必須與伺服器端的加密方式完全一致
- Password
- 填入對應密碼，並保留大小寫
443 僅為連接埠格式範例，不代表預設連接埠，也不表示該連線一定使用 TLS。
VMess 欄位
- Type
- VMess
- Address / Port
- 分別填入伺服器位址與連接埠
- UUID
- 使用資料中提供的完整識別碼
- Transport
- 依伺服器端要求選擇傳輸方式
- TLS
- 依資料核對開關與伺服器名稱
啟用 WebSocket 等傳輸方式時，還須核對 Host、Path 等相關欄位，不能只填 UUID。
VLESS、Trojan、Hysteria2、WireGuard 也必須選擇各自對應的 Type。VLESS 通常需要核對 UUID 與傳輸設定；Trojan 則須核對密碼及 TLS 相關參數。Hysteria2 與 WireGuard 的欄位結構不同，不能套用前面兩張卡片的設定方式。請以自己的連線資料及 App 顯示的對應欄位為準；缺少參數時不要依名稱猜填。
- Address 填入主機名稱或 IP，不要填入整個以 https:// 開頭的訂閱 URL。
- Port 只填連接埠數字，有效範圍為 1–65535；不要把「網域:連接埠」整段填入連接埠欄。
- 需要 TLS 時，伺服器名稱與憑證驗證有關；連線失敗時，不應以略過憑證驗證取代參數核對。
- 儲存前再次檢查空格、全形冒號與換行。密碼或 UUID 最後多一個字元也會導致驗證失敗。
四、掃描與剪貼簿：讀取後先檢查辨識結果
QR Code 不一定是訂閱，它只是文字的圖形編碼。QR Code 中可能是一條 ss:// 分享連結、訂閱 URL，也可能是一般網頁。開啟 Home 的掃描入口，依提示允許存取相機，並將完整 QR Code 放在取景範圍內；辨識後核對目標類型與欄位，再確認儲存。
- 先確認 QR Code 完整、清晰且沒有遮蔽。若邊緣遭到裁切，請重新取得完整圖片，不要反覆掃描試圖補救。
- 若辨識結果是伺服器連線，請檢查協定、位址、連接埠與備註；不要預期它會自動建立可更新的訂閱群組。
- 若辨識結果是訂閱網址，請依 Subscribe 流程儲存來源；若只是帳戶網頁，請返回自己的服務資料頁尋找真正的訂閱入口。
- QR Code 若顯示在同一台裝置上，可使用掃描頁提供的圖片讀取功能；若沒有相關選項，請改為複製原始文字，避免將 QR Code 轉傳到不可信的管道。
剪貼簿匯入適用於已取得分享文字的情況。先複製完整的一條連結，返回 Home 後依剪貼簿匯入提示操作；若系統要求授權讀取剪貼簿，僅在這次明確執行匯入時允許。如果沒有出現提示，可重新複製一次，並檢查 Home 的新增入口是否提供從剪貼簿讀取的功能。
常見的單一分享格式包括 ss://、vmess://、vless://、trojan://，但有這些開頭不代表內容一定完整，或與目前的協定設定相容。複製時不要附上引號、聊天編號、Markdown 標記或句尾句號。批次匯入文字後，請核對項目數量，避免重複儲存同一條連線。
五、依更新需求選擇匯入方式
不必使用全部四種入口。如果同一份資料同時有訂閱和單一分享連結，只要選擇一種符合管理需求的方式即可。以下只比較 Shadowrocket 內的匯入與更新方式；「推薦」是指適合需要持續同步清單的情況，並非代表伺服器品質。
Subscribe：保留來源
推薦儲存訂閱 URL，之後可從相同來源重新整理伺服器清單。來源中的項目新增、移除或參數變更後，必須完成更新才會同步到本機。
適用情況：已有訂閱網址，需要持續同步伺服器清單
Add Server：逐項填寫
依協定手動儲存連線參數，方便逐欄核對。外部訂閱變更時，這筆資料不會自動更新為新的位址或密碼。
適用情況：只有個別參數，需要單獨儲存一筆連線
掃描或剪貼簿：讀取文字
可減少輸入錯誤，最後儲存的項目類型則取決於文字內容。單一分享連結通常只會建立一筆伺服器記錄，不會自動具備訂閱更新功能。
適用情況：已有 QR Code 或完整分享連結，希望減少手動填寫
更新前若曾修改本機資料，請先記下修改的項目與用途。由訂閱來源管理的項目可能會在更新時重建；獨立手動新增的項目則不應誤當成訂閱備份。更換訂閱憑證後，編輯原有訂閱 URL 再更新，比不斷新增群組更容易核對結果。
六、匯入後的連線檢查與常見問題
返回 Home，選取剛匯入的伺服器，再開啟連線開關。第一次建立 VPN 設定時，依系統提示確認授權。接著檢查 Home → Global Routing：Proxy 表示使用代理模式，Direct 表示直連模式，Config 表示依目前設定檔的規則處理；匯入訂閱本身不會替你決定規則分流方式。
- 先確認已選取特定伺服器，而不只是展開訂閱群組。
- 使用 Home 中的 Connectivity Test 查看測試結果，再開啟實際需要瀏覽的頁面驗證；單次測試有回應，不代表所有目標都能連線。
- 若在 Config 模式下某個請求走直連，請核對目前設定檔與符合的規則，不要立刻刪除訂閱再重新匯入。
- Settings → On Demand 用來管理依條件觸發連線的行為，不負責下載訂閱。初次排查時請先手動連線，分開檢查自動觸發與匯入問題。
貼上後顯示不是有效連結，該怎麼辦？
重新複製原始文字，刪除開頭的說明文字與結尾標點。單一分享連結可用掃描或剪貼簿讀取；HTTPS 訂閱 URL 則填入 Type → Subscribe 的 URL 欄位，不要放進伺服器的 Address 欄位。
訂閱更新一直逾時，需要重新新增嗎？
先確認目前網路能否連線至訂閱網址。若已有可用連線，可先連線再重試；若需要透過代理更新，請至 Settings → Subscribe 檢查 Update via Proxy。沒有可用連線時，只啟用這個選項也無法建立可用通道，不必一再新增相同訂閱。
顯示更新完成，為什麼清單還是空的？
先展開對應群組，再確認 URL 是否誤填成登入頁或說明頁。若回應是網頁、空白內容，或用戶端無法解析的格式，請向自己的服務商確認訂閱回傳內容與帳戶狀態；不要只改幾個字元就反覆填入網頁網址測試。
清單有伺服器，但連線後無法開啟網頁？
檢查 Home 目前選取的項目，再查看 Global Routing 是否設為 Direct。使用 Connectivity Test 區分連線故障與規則問題；手動填寫的項目優先核對連接埠、驗證、TLS 與傳輸參數，訂閱項目則先完成一次來源更新。
把訂閱連結傳給別人協助排查，還能繼續使用嗎？
前往自己的服務管理頁面重設訂閱憑證，再編輯 Shadowrocket 中對應 Subscribe 的 URL 並更新。舊網址是否立即失效由伺服器端決定。之後截圖時請遮住完整 URL 與 QR Code，並另外記錄錯誤訊息。
完成狀態應分三個層次判斷：來源儲存成功、項目解析正確、實際連線可用。逐層檢查可以減少重複匯入，也能避免把伺服器故障、訂閱網址失效和規則分流問題混為一談。