本文適合已有自己的訂閱網址或連線參數，準備匯入 Shadowrocket 的使用者。先分辨節點訂閱與遠端設定檔，再依輸入內容選擇 Subscribe、Add Server、掃描 QR Code 或剪貼簿；最後透過列表、更新結果與 Connectivity Test 分步確認，避免把「已儲存網址」誤認為「已取得可用連線」。
先分清楚：節點訂閱、單一節點連結與設定檔
Shadowrocket（小火箭）的匯入入口可接收不同類型的資料。節點訂閱網址通常是 HTTPS URL，取得後會回傳一組連線參數；單一節點分享連結則以 ss://、vmess://、vless:// 或 trojan:// 等協定前綴開頭；遠端設定檔則用於設定規則、DNS 等行為。這些資料都可能以連結形式提供，但不能因此互換匯入入口。
尤其要分清楚 Config 頁面的 Subscribe 與節點訂閱：Config 中訂閱及管理的是遠端設定檔，不能只因為這裡出現一個檔案，就認定 Home 已有節點。新增節點訂閱通常從 Home 右上角的「+」進入 Add Server，再將 Type 設為 Subscribe。介面排列可能隨 App 更新而調整，應以目前所在頁面及 Type 為判斷依據，而非只看見 Subscribe 這個字。
Subscribe：從 Home 新增節點訂閱，在 Config 管理設定檔訂閱
如果取得的是節點訂閱 URL，請先前往 Home →「+」→ Add Server。Type 會決定表單用途：選擇 Subscribe 後，應填入訂閱 URL，而不是把整個網址拆成伺服器位址、連接埠與密碼。訂閱網址中的查詢參數常用於身分驗證，複製時務必保留問號、等號及其後的內容。
-
辨識網址
確認取得的是節點訂閱網址，而不是帳戶網頁、訂單頁面或遠端規則檔案。範例
https://example.com/sub?token=xxxx僅用來說明 URL 結構。 -
開啟表單
前往 Home → 右上角「+」→ Add Server，將 Type 設為 Subscribe。不要在其他協定類型的表單中貼上訂閱網址。
-
填寫並儲存
在 URL 欄位貼上完整網址，並在 Remarks 填入方便辨識的名稱，再儲存。網址前後的空格、換行及聊天訊息中的引號都不屬於 URL。
-
檢查更新
返回 Home 查看訂閱群組與節點。若尚未取得內容，請使用訂閱的更新功能，或在 Home 列表向下滑動觸發重新整理；留意錯誤訊息，不要重複新增同一個網址。
-
選擇節點
展開訂閱群組，確認其中有實際節點，再選擇要使用的節點。若只看見訂閱名稱，仍須確認群組是否已展開、請求是否成功，以及回傳內容是否能解析。
如果網址實際指向遠端設定檔，請在 Config 的遠端設定檔訂閱區域管理。Config 頁面的 Subscribe 檔案更新，與 Home 的節點訂閱更新是兩套流程；選用某個設定檔，也不代表它引用的所有策略都已有連線參數。是否包含節點資訊，取決於檔案實際內容，不能只看副檔名判斷。
依更新內容選擇入口
節點訂閱
- 入口：Home →「+」→ Add Server → Type → Subscribe。
- 內容：一組伺服器位址、連接埠與協定參數。
- 確認方式：對應的 Home 群組中出現實際節點。
設定檔訂閱
- 位置：Config 頁面的 Subscribe 區域。
- 內容：遠端設定檔，可能包含規則及其他設定區段。
- 確認方式：檔案成功取得，並依需求選用及檢查內容。
先確認要更新的內容，再選擇入口；節點數量與設定檔數量不是同一項指標。
Add Server：依協定手動輸入，不要從訂閱 URL 猜參數
手動輸入適用於已取得完整且明確的單一節點參數時。路徑同樣是 Home →「+」→ Add Server，但 Type 應選擇與參數相符的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan。選擇 Type 後，表單欄位會隨之改變；填寫前先確認協定，再核對伺服器位址、連接埠、憑證與傳輸設定。
以下兩張卡片僅用於區分欄位層級，並非完整可用的設定。連接埠 443 只是範例值，不代表所有協定都必須使用，也不能只憑這個連接埠判斷已啟用 TLS。實際連接埠以及 TLS、SNI、傳輸路徑等設定，都應與既有參數一致。
節點訂閱欄位
- 入口
- Home → “+” → Add Server
- Type
- Subscribe
- URL
https://example.com/sub?token=xxxx- Remarks
- 測試訂閱，僅供辨識
URL 是用來取得節點列表的網址，不是某個節點的伺服器位址。
單一節點參數示意
- Type
- Trojan
- Address
gateway.example.com- Port
443，僅供示例- Password
- 虛構範例值
demo-not-a-secret - TLS
- 依完整原始參數逐項核對
這些虛構值無法連線；仍須核對實際所需的身分驗證與傳輸參數。
- Shadowsocks：重點核對加密方法與密碼，不要把訂閱 token 當成節點密碼。
- VMess：核對 UUID、alterId、加密方式與傳輸設定，不要自行套用其他節點的值。
- VLESS：核對 UUID、flow 及相應的傳輸與安全設定；欄位有值時應完整保留。
- Trojan：核對密碼、TLS 與伺服器名稱等參數；伺服器位址與 TLS 身分名稱不一定相同。
- Hysteria2、WireGuard：使用各自對應的 Type 與參數結構，不要套用 VMess 或 Trojan 的表單邏輯。
手動輸入儲存的是當時的參數快照。遠端更換連接埠或憑證後，本機不會因為 Remarks 相同而自動同步；應重新編輯，或依原始資料重新匯入。如果節點原本來自訂閱，直接修改訂閱產生的項目，還可能在下次更新時被覆蓋；排查問題前請先記錄原始值。
掃描 QR Code：讀取的是 QR Code 載荷，不保證內容就是節點
在 Home 點選頂端的掃描圖示進入掃描頁面，依系統提示允許相機存取，並將 QR Code 完整放入取景範圍。QR Code 只是資料載體：內容可能是單一節點分享連結、訂閱 URL，甚至只是一般網頁網址。掃描完成後務必檢查辨識結果，不能把「掃描到 QR Code」當成「匯入格式正確」。
- 先確認 QR Code 來自你已有的連線資料，避免掃描公開網頁中用途不明的圖碼。
- 辨識後檢查 Type 與欄位：單一節點通常會顯示協定參數，訂閱則應保留完整 URL。
- 如果取得的是 HTTPS 網址，請先確認它究竟是訂閱、遠端設定檔還是網頁，再選擇相應入口。
- 儲存後返回 Home 檢查新增的節點或群組；若匯入的是設定檔，則到 Config 確認。
如果 QR Code 顯示在同一台 iPhone 上，且掃描介面提供選取照片的入口，可以從照片讀取；若目前介面沒有該入口，可改用原始文字連結，或在另一個螢幕上顯示 QR Code。不要為了掃描而將含有憑證的截圖上傳到公開圖片服務。若 QR Code 邊緣遭裁切、圖像太小或有反光，請先改善圖像再試一次。
剪貼簿：複製完整內容，允許讀取後再核對
從訊息或自己的資料複製既有連結時，適合使用剪貼簿。先只複製連結本身，再返回 Shadowrocket；若 App 顯示辨識或匯入提示，請依提示確認並檢查匯入預覽。系統要求允許貼上時，只有允許讀取，App 才能處理這次剪貼簿內容。沒有跳出提示不代表連結無效，也不需要反覆關閉再開啟 App。
- 訂閱 URL：可直接前往 Home →「+」→ Add Server → Type → Subscribe，然後在 URL 欄位長按並貼上。
- 單一節點分享連結：使用 App 提供的剪貼簿匯入或辨識入口；若未能辨識，先確認協定前綴、編碼及完整連結是否正確。
- 手動參數文字：聊天訊息中含有「位址、連接埠、密碼」並不等於分享連結，應在 Add Server 中逐項填寫。
- 多筆連結：避免混入項目符號、網頁標題與說明文字；匯入後逐筆確認數量與協定，不要以複製的行數代替結果確認。
例如 https://example.com/sub?token=xxxx 中的 ?token=xxxx 是網址的一部分。訊息自動換行不一定會改變底層文字，但手動插入換行、使用中文標點，或複製因省略顯示而遭截斷的文字，都可能造成解析失敗。含編碼的分享連結也不宜自行解碼或重新組合；請優先重新複製完整原始內容。
訂閱網址、密碼與 UUID 都可能是存取憑證。排查問題時，請在截圖中遮住這些內容；分享錯誤訊息時，只保留錯誤類型與必要的欄位名稱。匯入完成後，可複製一段一般文字覆蓋目前剪貼簿內容，降低之後誤貼憑證的機會。
匯入後未顯示節點：依序檢查請求、解析與顯示
先保留現況：記下使用的入口、儲存類型與更新錯誤，再檢查網路及輸入內容。重複建立同名訂閱會讓結果更難辨識。看到空白群組時，先展開群組；只在 Config 看見檔案時，先確認匯入的是設定檔還是節點訂閱。這兩種情況都不應直接歸因於連線參數失效。
已儲存 Subscribe，為什麼還是沒有節點？
返回 Home 展開對應群組，再執行一次更新並查看結果。儲存 URL 只代表本機已留下記錄；網路請求失敗、回傳空白內容或無法解析，都可能導致群組中沒有節點。先確認 URL 完整，不要再次貼上網頁登入頁面的網址。
Config 明明有檔案，為什麼 Home 還是空的？
在 Config 檢查檔案內容與用途。只有規則或 DNS 的設定不會自動補上 Home 節點；請透過 Home →「+」→ Type → Subscribe 新增你已有的節點訂閱，再分別確認設定檔與節點。
更新時顯示逾時，需要先開啟連線嗎？
先確認目前網路能否連上訂閱網址。若已有可用節點，可在 Settings → Subscribe 檢查 Update via Proxy，並視需要啟用後重試；此功能需要已有可正常運作的代理連線。首次匯入且沒有可用節點時，這項設定無法憑空建立連線。
回傳 401 或 403，換個入口就能解決嗎？
這通常與請求授權或存取限制有關，和使用掃描、剪貼簿或手動輸入無關。請檢查訂閱 URL 是否漏了 token、網址是否遭替換，再依你已有帳戶的資料確認授權狀態。不要公開完整網址，也不要反覆修改無關的協定欄位。
節點已經出現，網頁卻還是無法開啟？
先選取節點，在 Home 執行 Connectivity Test，再檢查 Global Routing。Direct 使用直接連線，Proxy 使用代理連線，Config 依設定檔規則分流，Scene 則依所選情境設定運作；匯入成功不代表目前流量一定會使用剛新增的節點。
更新請求成功也不代表內容正確：伺服器可能回傳登入頁面、錯誤文字或不支援的資料。若錯誤與解析有關，應確認原始網址的用途及所需格式，而不是任意修改節點連接埠。自動更新相關選項可在 Settings → Subscribe 檢查；不要把背景重新整理視為一定會執行，重要變更後仍應手動更新並確認結果。
完成匯入後的驗收與維護
匯入、連線與路由是三個階段。Home 顯示節點，代表參數已加入列表；開啟連線並完成系統 VPN 設定授權，才進入連線階段；最後哪些請求會使用代理，則取決於 Global Routing 與實際生效的設定。Config 中的 DOMAIN-SUFFIX、GEOIP、IP-CIDR 和 FINAL 屬於規則層，不是訂閱網址的一部分。
- 列表確認：訂閱群組可展開，節點名稱與協定清楚可辨，且未因連續嘗試而留下多組重複記錄。
- 更新確認：手動更新後沒有請求或解析錯誤；遠端內容未變時，本機項目數量維持不變是正常情況。
- 連線確認：選取目標節點，依需求允許系統新增 VPN 設定，再查看 Home 狀態與 Connectivity Test 結果。
- 路由確認：檢查 Global Routing；使用 Config 時，確認目前選用的檔案及規則中的策略是否存在。
- 維護確認：透過訂閱更新訂閱節點；手動輸入與單一節點分享連結則依原始參數維護，不要混淆兩種更新方式。
Settings → On Demand 用於依條件觸發連線，不負責取得訂閱，也無法修正錯誤的 token 或缺少的 UUID。排查匯入問題時，先完成輸入、列表與連線驗證，再調整自動連線行為，可減少多項設定同時變動造成的誤判。
Shadowrocket 是 Apple 平台的閉源商業 App，主要供 iPhone、iPad 使用，透過 App Store 一次性購買取得。開發者為 Shadow Launch Technology Limited，App ID 為 932747118；系統需求、裝置相容性及是否支援通用購買，請以 App Store 頁面標示為準。App 購買狀態與既有訂閱的有效性應分別確認。