先確認取得的是伺服器訂閱 URL、單一伺服器分享連結，還是遠端設定檔，再選擇合適的匯入方式。本文適合已經有自己的服務商與訂閱的使用者，說明 Subscribe、Add Server、掃描與剪貼簿的用途，並區分 Config 中的遠端設定與 Home 中的伺服器清單；匯入完成後，還要選取伺服器並測試連線。
一、先區分伺服器訂閱與遠端設定
Shadowrocket（小火箭）中的「訂閱」首先代表遠端更新關係，不表示所有訂閱內容都應加入同一個頁面。Home 主要管理伺服器與連線；Config 管理設定檔及規則；Settings 管理 App 設定。匯入後清單沒有變化時，先確認目前所在頁面，通常比反覆貼上更有效。
伺服器訂閱通常是 HTTPS URL，會傳回可識別的伺服器清單。遠端設定也可以使用 HTTPS URL，但內容可能包含 [General]、[Rule] 等設定區段。兩者外觀相似，不能只憑連結以 https:// 開頭就判斷用途；應以既有訂閱的用途說明及回傳內容為準。
| 已有內容 | 對應處理方式 | 匯入後確認項目 |
|---|---|---|
| 伺服器訂閱 URL | Home → + → Type → Subscribe | Home 中的訂閱群組與伺服器項目 |
| 伺服器參數 | Home → + → Add Server 編輯頁面，選擇實際的 Type | 伺服器位址、Port、驗證參數 |
| 伺服器分享 QR Code | Home 的掃描入口 | 辨識後的類型與目標位址 |
| 剪貼簿中的分享連結 | 複製完整文字後返回 App，確認辨識結果 | 匯入的是單一伺服器還是訂閱 |
| 遠端設定 URL | Config 中新增遠端設定與管理訂閱 | 設定是否已下載，以及是否已選取使用 |
二、Subscribe：分開處理伺服器訂閱與 Config
若要批次新增伺服器，請從 Home 進入新增頁面，將 Type 設為 Subscribe；不要把伺服器訂閱直接當成規則檔使用。範例 https://example.com/sub?token=xxxx 僅用於說明 URL 結構，並非可用的訂閱。實際操作時，請完整複製自己已有的網址，包括問號後的查詢參數。
-
確認內容
確認來源說明標示的是伺服器訂閱，並保留完整 URL。不要複製網頁標題、說明文字或連結外層的引號。
-
選擇類型
開啟 Home → 右上角 +，進入 Add Server 編輯頁面，並在 Type 中選擇 Subscribe。
-
填寫位址
將自己的訂閱 URL 貼到對應的位址欄，並填寫方便辨識的備註。儲存前請確認沒有混入換行、空格或中文標點。
-
儲存並更新
儲存後返回 Home，確認訂閱群組及其項目；若要重新取得內容，請執行該訂閱的更新操作，並等更新完成後再檢查清單。
如果目前看到的是 Config 頁面的 Subscribe 或遠端設定訂閱管理，請先確認操作對象是設定檔。設定檔中的 DOMAIN-SUFFIX、IP-CIDR、GEOIP 和 FINAL 屬於規則系統，不能與伺服器位址、密碼等參數混為一談。遠端設定下載成功，也不代表 Home 中已經出現可連線的伺服器。
三、Add Server：手動新增適用於參數完整時
Add Server 是新增伺服器的編輯入口，Subscribe 則是其中一種 Type。手動新增單一伺服器時，請選擇實際的協定類型，例如 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard；不要因為取得一個位址，就一律選擇 Subscribe。
手動新增的前提是參數完整。只有網域名稱和 Port 通常不足以建立連線；不同協定還可能需要密碼、UUID、金鑰、TLS 或傳輸層參數。各欄位之間有相應關係，不要依照另一台伺服器的設定來補上未知值。
- 位址與 Port：位址欄填寫伺服器網域名稱或 IP，Port 則填入對方提供的連接埠號碼。即使使用 TLS，連接埠也不一定是
443，請依照原始參數逐項填寫。 - 驗證欄位：請區分密碼、UUID 與金鑰，不要把訂閱 URL 中的 token 填入伺服器密碼欄。
- TLS 與名稱：若原始參數包含 SNI 或伺服器名稱，請依原值填寫；若憑證驗證失敗，先檢查名稱與裝置時間。
- 傳輸參數：Path、Host 等值可能區分大小寫，路徑中的斜線也是參數的一部分。若參數缺漏，請向既有設定來源確認。
- 儲存結果：儲存後返回 Home，確認出現的是預期的伺服器，而不是只有一個尚未取得內容的訂閱群組。
如果已取得完整的 ss://、vmess://、vless:// 或 trojan:// 分享連結，請優先讓 App 辨識整條連結，再確認解析結果。手動拆解編碼內容容易遺漏參數；辨識出項目只代表解析完成，仍須另外測試連線是否可用。
四、掃描與剪貼簿：改變輸入方式，不改變內容類型
掃描適用於 QR Code 顯示在另一個螢幕上的情況。開啟 Home 的掃描入口，首次使用時允許相機權限，並將完整 QR Code 放入取景範圍。辨識後，先確認結果是伺服器分享連結、訂閱 URL，還是一般網頁網址，再確認匯入。
剪貼簿適合在同一部 iPhone 或 iPad 上收到文字連結時使用。複製完整內容後返回 Shadowrocket；出現剪貼簿辨識或匯入提示時，先確認項目再繼續。系統詢問是否允許貼上時，請依照這次操作授權。若沒有自動提示，可在對應的新增頁面手動貼上，不能因此認定連結已失效。
輸入方式：另一個螢幕或目前裝置
另一個螢幕
- 使用 Home 的掃描入口讀取完整 QR Code。
- 避免反光、遮擋，以及 QR Code 邊緣遭到裁切。
- 若辨識結果是網頁，先確認它是否只是說明頁面。
目前裝置
- 複製完整分享文字，返回 App 確認辨識結果。
- 複製 URL 時，請保留
?、&與後續參數。 - 若沒有自動辨識提示，請在對應的新增頁面手動貼上。
掃描和剪貼簿只是輸入方式；最後加入伺服器清單或設定管理，取決於內容本身。
訂閱網址與 QR Code 可能包含存取憑證。排錯截圖請遮住完整 token、密碼和分享 QR Code；若要描述狀況，保留錯誤文字、操作入口及發生階段即可。不要為了檢查內容，把真實訂閱提交到不明的轉換頁面。
五、訂閱與手動新增的設定取捨
已有伺服器訂閱且需要持續更新清單時，保留 Subscribe 關係會比較方便維護；只有單一伺服器參數，或需要確認特定欄位時，手動新增更直接。以下比較 Shadowrocket 中的新增設定，不涉及服務品質判斷。
Subscribe 設定
建議使用對於已有伺服器訂閱的使用者，儲存訂閱 URL 後即可再次取得遠端清單。更新結果取決於遠端內容；更新前請留意是否需要保留手動修改的項目。
適用情況：已有完整訂閱 URL，需要管理一組伺服器。
單一伺服器設定
選擇實際協定並填寫參數，方便逐項檢查位址、Port 和驗證欄位。其他訂閱變更時，這裡不會自動取得新的參數。
適用情況：只有完整的單一伺服器參數，或需要單獨檢查某一台伺服器。
掃描匯入一台伺服器，不會自動建立訂閱更新關係；剪貼簿匯入也一樣。要判斷是否能更新，請確認儲存的是訂閱 URL 還是獨立的伺服器項目，而不是看最初使用哪種輸入方式新增。
六、匯入失敗：依發生階段檢查
請分開記錄「無法匯入」、「更新失敗」和「無法連線」。第一種通常發生在內容辨識階段，第二種發生在取得或解析遠端內容時，最後一種則發生在伺服器項目已存在之後。三者的檢查方向不同，反覆更換匯入方式不一定能解決問題。
| 觀察到的狀況 | 優先檢查項目 | 下一步 |
|---|---|---|
| 提示無法辨識文字 | 是否複製完整連結，以及協定前綴是否正確 | 移除外層說明文字，保留連結內的字元後重新貼上。 |
| 訂閱更新回傳 401 或 403 | URL 憑證是否完整，以及訂閱權限是否有效 | 向自己原有的設定來源確認，不要先修改伺服器協定參數。 |
| 訂閱更新回傳 404 | 路徑是否已失效或複製錯誤 | 確認完整路徑，不要只檢查網域是否能開啟。 |
| 更新顯示逾時 | 目前網路是否能連上訂閱網址 | 分別透過 Wi-Fi 與行動網路檢查，並記錄是否只有其中一種網路失敗。 |
| 請求成功但沒有伺服器 | 回傳內容是否為登入網頁、錯誤頁面或設定檔 | 確認訂閱格式與匯入入口，不要以 HTTP 請求成功取代格式檢查。 |
| 伺服器已出現但無法連線 | 是否已選取伺服器，以及參數與路由設定是否相符 | 改為進行連線診斷，不要重複匯入同一個項目。 |
匯入後的基本驗證
- 返回 Home，點選要使用的伺服器，確認左側出現選取標記。
- 檢查 Global Routing。Config 會依目前設定的規則處理，Proxy 使用代理路徑，Direct 使用直連路徑；Scene 涉及場景設定，測試時也要確認實際選取的項目。
- 開啟 Home 的連線開關；首次連線時，依系統提示允許加入 VPN 設定。
- 執行 Connectivity Test，並記錄測試結果。測試成功只表示當時可連線至相應的測試目標，不代表所有要求都正常。
- 若連線會自動恢復，請前往 Settings → On Demand 確認隨選連線設定，避免將自動重新連線誤判為匯入異常。
到這一步，訂閱取得、內容解析與連線測試已分別確認。繼續排查時，請保留錯誤提示和操作順序，先變更一個條件再重試，例如只切換目前網路，或只確認一項參數；避免同時修改訂閱、規則和連線設定，導致無法判斷原因。規則語法可參閱規則手冊。