本文適用於已持有自己的服務商訂閱或連線參數的使用者。先區分 Home 的伺服器訂閱與 Config 的設定檔訂閱，再依連結、參數、QR Code 或剪貼簿選擇匯入方式；完成後檢查清單、更新結果與 Global Routing。掃描 QR Code 和使用剪貼簿只是傳遞內容的方式，不會自動將單一連線轉成可更新的訂閱。
匯入前：確認 App 與現有資料
Shadowrocket（小火箭）是 Apple 平台上的閉源商業 App，主要供 iPhone、iPad 使用，唯一取得管道是 App Store。購買前請確認產品名稱 Shadowrocket、開發者 Shadow Launch Technology Limited，以及產品頁網址中的 App ID 932747118。系統需求請以 App Store 頁面標示為準。
用戶端採一次性買斷；買斷用戶端 ≠ 購買連線方案。本文假設使用者已有自己的服務商與訂閱；本站不提供、不銷售，也不推薦節點或訂閱。成功購買 App 後，仍須匯入自己有權使用的連線資料。
- 訂閱 URL：通常是 HTTPS 網址，開啟後會回傳用戶端可辨識的伺服器清單，而非帳戶管理網頁。
- 單一分享連結：常見前綴包括
ss://、vmess://、vless://、trojan://，通常代表一條連線。 - 手動設定參數：至少確認 Type、Address、Port 及相應的驗證欄位；TLS、SNI、傳輸方式等也須與伺服器端一致。
- 設定檔 URL：用於載入規則、DNS 與策略等設定，不應只因網址以 HTTPS 開頭，就將它當成伺服器訂閱。
Subscribe：先釐清 Home 與 Config 的用途
最容易混淆的是 Subscribe 所指的內容。要批次匯入伺服器清單，請使用 Home → + → Add Server → Type → Subscribe；Config 頁面的 Subscribe 則用於訂閱遠端設定。兩者都可能接受 URL，但回傳內容與儲存位置不同。
如果拿到的是伺服器訂閱，別因為 Config 頁面也有 Subscribe 就直接貼上。反過來說，包含 [General]、[Rule] 等區段的完整設定檔，也不應當成一般伺服器清單匯入。先查看資料說明；若不清楚回傳內容，請向原服務商確認，不要反覆更換入口猜測。
-
前往新增頁面
開啟 Home，點選右上角的「+」進入 Add Server。這裡管理的是連線項目，不是在 Config 中選擇規則檔。
-
選擇類型
點選 Type，選擇 Subscribe。將自己已有的完整訂閱網址貼到 URL，保留查詢參數、大小寫與百分比編碼。
-
命名並儲存
填入方便辨識的名稱，點選右上角 Done。返回 Home，檢查訂閱群組及展開後的伺服器清單。
-
更新訂閱
在 Home 下拉重新整理，等待這次要求完成。若群組存在但內容空白，先檢查連線要求與解析結果，不要立刻重複新增相同 URL。
何時該使用 Config 頁面的 Subscribe？
只有在資料明確指出這是 Shadowrocket 遠端設定時，才進入 Config，開啟新增遠端設定的選單並選擇 Subscribe，再填入該設定的 URL。儲存後，在 Config 清單中確認並選用對應設定。不同介面版面的新增選單位置可能不同，請依 Subscribe 標籤辨認，而不是尋找 Home 中的 Type 表單。
- Config 清單新增了檔案，但 Home 沒有新增伺服器，不一定代表匯入失敗：匯入的內容可能原本就是只有規則的設定檔。
- 遠端設定可能包含 DNS、規則與策略引用，套用前請確認來源與內容，以免覆蓋已調整好的設定。
- 更新伺服器訂閱與更新遠端設定是兩項不同操作；完成其中一項，不代表另一項也已更新。
Add Server 手動新增：只有參數時逐項建立連線
如果只有 Address、Port、Password 等參數，沒有訂閱 URL，請在 Home → + → Add Server 中選擇實際使用的協定，再逐項填寫。手動新增的是獨立伺服器項目；伺服器端參數變更後，通常須自行修改，不會像訂閱清單一樣自動同步。
地址與驗證
- Type
- 依照現有資料選擇 Trojan 等實際使用的協定。
- Address
- 填入伺服器網域或 IP，不要附上 https:// 或網頁路徑。
- Port
- 填入伺服器端使用的連接埠；只有資料明確標示 443 時才填 443。
- Password
- 依原始內容填寫，避免在前後加入空格或換行。
443 只是常見連接埠的範例，不能取代伺服器端的實際參數。
協定附加設定
- SNI
- 依伺服器端要求，填入 TLS 握手使用的網域。
- UUID
- VMess、VLESS 等協定的身分欄位，不能當成通用的 Password。
- Method
- Shadowsocks 的加密方式必須與伺服器端一致。
- Transport
- 若指定 WebSocket 等方式，也要一併確認 Path 與 Host。
表單欄位會隨 Type 改變，請勿將一整套參數照搬到其他協定。
以 Trojan 為例，Address 可解析、Port 可建立連線，不代表驗證與 TLS 檢查都已成功。若資料指定 SNI，請填入指定值；不要把訂閱 URL 的網域誤當成伺服器 Address，也不要藉由放寬憑證檢查來掩蓋 SNI 或憑證不相符的問題。
- 先儲存一筆完整連線，再到 Home 確認名稱與 Type。
- 選取該項目，再開啟連線開關；首次使用時，依系統提示允許新增 VPN 設定。
- 若連線失敗，依序檢查 Address、Port、驗證欄位與 TLS／傳輸參數；每次只變更一項，方便找出原因。
掃描 QR Code 新增：匯入結果取決於 QR Code 內容
QR Code 是文字載體，不是獨立協定。在 Home 點選掃描入口，對準自己已有的連線 QR Code，並依系統提示允許使用相機。辨識後先檢查解析出的類型與名稱，再確認儲存。若掃描頁提供從照片讀取的入口，也可以讀取裝置中已有的 QR Code 圖片。
- QR Code 內含
trojan://等單一分享連結：通常會新增一筆伺服器紀錄，不會自動建立可更新的群組。 - QR Code 內含訂閱 URL：確認是否進入訂閱新增流程；若只辨識出一般文字網址，可先複製，再前往 Home → + → Type → Subscribe 填入。
- QR Code 內含帳戶網頁、付款頁面或其他一般網頁：無法據此取得伺服器參數，請回到原有資料中尋找實際連線資訊。
- 掃描結果缺少欄位或無法辨識：檢查 QR Code 是否完整、有反光或遭裁切，再試著使用原始文字；不要自行猜填 Password、UUID 或 SNI。
掃描自己的分享連結後仍須確認內容，尤其是從照片轉存或經聊天軟體壓縮過的 QR Code。建議保留原有項目，先確認新增項目可正常使用，再決定是否清除重複紀錄。
剪貼簿匯入：完整複製，URL 別貼錯欄位
剪貼簿適合匯入已取得的分享文字。複製時請從協定前綴開始，完整保留至連結結尾，不要連同說明文字、引號、項目符號或程式碼區塊一起複製。返回 Home 後，若出現匯入提示，請允許讀取並確認；若沒有提示，請開啟 Home 的新增入口，查看目前介面提供的剪貼簿匯入操作。
-
複製原始內容
複製完整的單一分享連結。若多筆連結無法批次辨識，請先複製一筆測試，避免整段說明文字也一併匯入。
-
允許讀取
切回 Shadowrocket；系統詢問是否允許貼上時，請選擇允許。若拒絕讀取而沒有匯入提示，不代表連結格式錯誤。
-
確認匯入結果
確認新增項目的協定、Address 與 Port。若複製的是 HTTPS 訂閱 URL，卻未自動辨識，請改用 Home → + → Type → Subscribe → URL。
請勿手動解碼或改寫連結中的 %2F、%3D 等字元，也不要刪除 & 後面的參數。分享連結中 # 後的片段標記通常用於名稱，但不同格式仍有各自的解析規則；最穩妥的做法是保留原文。
匯入後驗證：分開檢查清單、選取項目與 Global Routing
匯入成功只代表資料已儲存，不等於伺服器可連線，也不代表流量分流符合預期。先在 Home 展開訂閱群組，確認至少有一筆紀錄，再選取目標伺服器並執行 Connectivity Test。測試結果僅反映當下的連線狀況，不代表所有網站與 App 都能正常連線。
Global Routing → Config
設定說明依目前選用設定檔中的規則決定策略。符合 DIRECT 的要求會直接連線；符合代理策略的要求則使用相應出口。是否經由代理，取決於規則，而非只看 Home 選取了哪台伺服器。
適用情況：已檢查設定內容，日常使用時需要依規則分流
Global Routing → Proxy
由用戶端接管的流量會以 Proxy 方式處理，可暫時減少規則比對造成的變數。但不能因此推斷裝置上的所有流量都必定經過相同路徑。
適用情況：短時間比對伺服器連線與規則分流問題
Global Routing → Direct
由用戶端接管的流量會以 Direct 方式處理。即使已匯入並選取伺服器，也不能據此判定目前的連線正使用該伺服器。
適用情況：比對直接連線的結果，排除目標網站本身的連線問題
排查時也應檢查 Settings → On Demand。On Demand 用於依條件觸發連線，不負責匯入訂閱或補齊參數；若切換網路後連線自動變更，請先確認相關條件，再判斷是否需要重新匯入。
- Home 有伺服器、Config 沒有新檔案：對一般伺服器訂閱而言，這可能是正常結果。
- Config 有檔案但規則未生效：確認是否已選用該設定檔，以及 Global Routing 是否設為 Config。
- 使用 Scene 時：先確認對應的場景設定；排查單一問題時，記下原設定，再暫時切換至明確的模式進行測試，完成後還原。
常見問題：清單未顯示與訂閱更新失敗
已儲存訂閱，Home 還是空白？
先確認是否誤加到 Config；再檢查 Home 中是否已有可展開的訂閱群組，並下拉重新整理。若只有群組、沒有伺服器，請確認 URL 是否完整、token 是否有效，以及回傳內容是否為可辨識的訂閱資料。帳戶登入網頁不能取代訂閱回應。
訂閱更新一直逾時，需要重新安裝嗎？
先確認目前的網路能否連線至訂閱網址。若已有可用的代理連線，可先連線，再前往 Settings → Subscribe 確認 Update via Proxy，然後重試更新；若沒有可用代理，只開啟此選項無法解決問題。請勿先刪除最後一份可用清單。
更新後伺服器名稱變了，是匯入錯誤嗎？
訂閱更新會依遠端回傳內容重新整理，名稱變更不一定代表匯入錯誤。請確認群組對應的訂閱 URL，並重新檢查選取的項目；若原先選取的紀錄已移除，請改選現有項目再進行測試。手動新增的獨立項目不一定會隨訂閱更新。
掃描 QR Code 可以匯入，為什麼不能更新？
開啟項目確認它是單一伺服器還是 Subscribe。若 QR Code 只含單一分享連結，匯入後便沒有訂閱來源可供更新；若要更新清單，請使用自己原有的訂閱 URL 另行新增 Subscribe，不要反覆掃描同一個單一 QR Code。
清單有紀錄，開啟連線後網頁仍無法開啟？
先在 Home 執行 Connectivity Test，再檢查 Global Routing 與目前選用的設定檔。若伺服器測試正常，但只有部分網域異常，請繼續檢查規則與 DNS；若伺服器測試也失敗，先確認連線參數、服務是否有效及目前網路，不要將所有問題都歸因於訂閱匯入失敗。
完成排查後，保留一個來源明確的訂閱群組即可，避免同一個 URL 建立多個不同名稱的副本。若要進一步檢查規則、DNS 或連線狀態，請參閱排查手冊；若要確認術語含義，請查看術語手冊。