本文適合已取得服務商提供的訂閱連結或連線參數的使用者。先分清 Subscribe 伺服器訂閱與 Config 規則設定，再依手上資料選擇貼上訂閱、透過 Add Server 手動填寫、掃描 QR Code 或從剪貼簿辨識，最後確認更新結果與 Global Routing。QR Code 和剪貼簿只是輸入方式，能否匯入仍取決於內容格式。
匯入前：分清伺服器訂閱與 Config 設定
開啟 Shadowrocket（小火箭）後，先在 Home 查看現有伺服器，再到 Config 查看目前的規則設定。Home 用來管理可連線的伺服器與訂閱群組；Config 用來管理規則設定檔。兩者都可能透過網址取得內容，但不能只因網址以 https:// 開頭，就認定用途相同。
尋找「Config 頁面的 Subscribe」時，先確認手上的連結實際提供什麼內容：伺服器清單應透過 Subscribe 匯入；包含分流規則的設定檔則由 Config 管理。新增伺服器訂閱通常從 Home 右上角的「+」進入 Add Server，並將 Type 設為 Subscribe。不要把 Config 的遠端設定新增功能當成伺服器訂閱入口。
| 已有資料 | 使用入口 | 確認結果 |
|---|---|---|
| 伺服器訂閱網址 | Home → + → Type → Subscribe | Home 顯示訂閱群組與伺服器項目 |
| 單一伺服器參數 | Home → + → Add Server | Home 顯示一筆手動新增的記錄 |
| 協定分享 QR Code | Home → 掃描入口 | 解析後顯示相應類型與參數 |
| 協定分享文字 | 複製後從剪貼簿辨識 | 出現新增提示或解析出的記錄 |
| 規則設定檔網址 | Config 的遠端設定入口 | Config 顯示設定檔，並非伺服器訂閱 |
請先確認資料來自自己的服務商，再進行以下操作。Shadowrocket 是閉源商業應用，主要供 iPhone 和 iPad 使用，唯一取得管道為 App Store。買斷用戶端 ≠ 購買連線方案；購買應用不會自動產生連線參數。系統需求請以 App Store 頁面標示為準。
入口一：使用 Subscribe 儲存並更新訂閱
在 Home 開啟新增表單後，將 Type 設為 Subscribe，把完整訂閱網址貼到 URL，再填寫方便辨識的名稱。儲存後，訂閱會保留來源網址；之後更新時會從該網址重新取得伺服器清單，因此適合服務商會調整伺服器資訊的情況。
-
複製完整網址
從自己的服務商頁面複製訂閱網址，保留
?後方的查詢參數。確認網址開頭和結尾沒有空格、換行或中文標點。 -
選擇訂閱類型
前往 Home → +，在 Add Server 表單中開啟 Type，選擇 Subscribe。不要沿用表單上次保留的其他協定類型。
-
貼上並儲存
在 URL 貼上完整網址，填寫容易辨識的備註後儲存。首次取得完成後，返回 Home 確認訂閱群組下是否出現伺服器。
-
確認更新結果
在 Home 的訂閱清單向下滑動以重新整理，確認訂閱是否更新完成。若出現錯誤，保留原項目，先檢查網址、網路與服務商狀態，不要反覆刪除後重新建立。
訂閱網址可能長這樣：https://example.com/sub?token=xxxx，此處僅為無法連線的虛構值。真實網址中的 token 常用於識別訂閱權限，分享錯誤截圖時應遮蔽完整 URL，而不只是備註名稱。
入口二：在 Add Server 手動填寫參數
在 Home → + 開啟 Add Server，先選擇 Type，再依服務商提供的資料填寫。Type 會決定後續需要哪些參數：Shadowsocks 的密碼與加密方式、VMess 或 VLESS 的身分資訊，以及 Trojan 的密碼與 TLS 設定都不能互相替代。若沒有明確參數，不要只憑協定名稱推測其他欄位。
基本連線欄位
- Type
- 與現有參數標示的協定一致
- Address
- 填寫伺服器網域名稱或 IP，不含網頁路徑
- Port
- 填寫提供的連接埠，例如 443；不代表所有服務都使用 443
- Password
- 僅在所選協定要求時填寫相應密碼
Address 不應直接填入完整訂閱網址，Port 也不能只憑網址外觀猜測。
確認其他參數
- TLS
- 依伺服器端要求啟用，不能只由連接埠號判斷
- SNI
- 使用服務商指定的 TLS 伺服器名稱
- Host
- 僅在相應傳輸設定要求時填寫
- Path
- 保留服務商提供的完整路徑與大小寫
Address、SNI 與 Host 用途不同，不能因內容相似就任意互換。
儲存後，在 Home 選取這筆記錄並嘗試連線。若基本欄位正確但 TLS 交握失敗，請接著確認伺服器名稱、憑證與裝置時間；不要把關閉憑證驗證當成通用解法。WireGuard 還需要金鑰與 Peer 設定，不能套用一般密碼表單；Hysteria2 等類型也需要填入相應的完整參數。
- 手動新增的記錄通常獨立於訂閱群組；重新整理訂閱不會自動更新這筆獨立記錄。
- 服務商修改密碼、連接埠或傳輸參數後，應重新編輯該記錄，或重新匯入服務商提供的有效分享內容。
- 如果已有完整的協定分享連結，建議先解析再逐項確認，減少輸入長密碼與路徑時出錯。
入口三與四：掃描 QR Code 與剪貼簿辨識
在 Home 開啟掃描入口，將鏡頭對準自己已有的協定分享 QR Code，並允許所需的相機存取權限。辨識後先確認 Type、Address、Port，再儲存。QR Code 可能包含單一伺服器分享資料，也可能只有網頁網址；掃到網頁不代表已取得可連線的伺服器設定。
在來源頁面複製完整分享文字，再返回 Shadowrocket，依照出現的剪貼簿辨識或新增提示繼續操作。若系統詢問是否允許貼上，確認來源後再允許本次操作。若沒有提示，請確認複製的是純文字連結，而不是圖片、標題或被聊天軟體截斷的內容。
| 內容開頭或格式 | 代表內容 | 匯入時注意事項 |
|---|---|---|
ss:// | Shadowsocks 分享連結 | 保留完整編碼內容、連接埠與附加參數 |
vmess:// | VMess 分享連結 | 編碼內容不可截斷或插入空格 |
vless:// | VLESS 分享連結 | 保留身分資訊與查詢參數 |
trojan:// | Trojan 分享連結 | 確認密碼、TLS 伺服器名稱與傳輸參數 |
https:// 網址 | 可能是訂閱、設定檔或一般網頁 | 先確認用途，再選擇 Subscribe 或 Config |
上述前綴僅供辨識格式，不是可直接連線的範例。QR Code 與剪貼簿都無法將任意文字轉成有效設定；連結中的傳輸擴充資訊能否完整解析，仍應以目前表單實際辨識出的欄位為準。匯入後若有欄位缺漏，請回到來源確認，不要自行猜測補上。
- 掃描沒有反應時，請檢查相機權限、QR Code 是否完整、螢幕反光與影像清晰度。
- 剪貼簿沒有反應時，請重新複製原始分享文字，移除連結前後的說明文字，但不要修改連結內容。
- 出現多筆待匯入記錄時，逐筆確認名稱與伺服器位址，避免重複匯入相同內容。
匯入後：選擇 Global Routing 並測試連線
在 Home 選取已匯入的伺服器，再開啟 Global Routing 檢查目前模式。匯入只解決「連線到哪裡」；Global Routing 則決定進入 Shadowrocket 的請求如何處理。若已有有效的規則設定，可選擇 Config；若規則引用了不存在的策略名稱，應先到 Config 檢查設定，而不是反覆匯入訂閱來取代修復。
Config
建議依目前啟用設定中的規則處理請求；實際路徑由命中的規則及其策略決定，並非固定讓某類網域走代理、其他流量全部直連。
適用情境：已確認規則與策略名稱，供日常使用
Proxy
讓進入通道且由應用程式處理的流量使用代理路徑，可用來比對是否因分流規則造成存取差異。
適用情境：短暫排查規則與代理路徑的差異
Direct
讓應用程式處理的請求走直連路徑；切換至此模式後，網頁能開啟並不能證明所選的代理伺服器可用。
適用情境：比對目前網路的直連狀況
首次連線時，請依系統提示允許新增 VPN 設定，接著在 Home 執行 Connectivity Test，並瀏覽自己需要使用的服務。測試結果只反映測試目標與當時的網路狀況，不能取代對所有實際服務請求的驗證。若測試有回應，但特定網域存取異常，可前往 使用手冊的連線疑難排解，檢查 DNS、規則命中狀況與 TLS 錯誤。
- Global Routing 中的 Scene 用來依已設定的場景選擇行為，並非匯入訂閱的入口。
- Settings → On Demand 用來管理依條件建立或中斷連線的行為，不能取代 Subscribe 更新伺服器清單。
- Config 中的
DOMAIN-SUFFIX、GEOIP、IP-CIDR與FINAL是規則關鍵字，不應填入 Add Server 的 Address。
訂閱更新與匯入失敗的處理方式
回到 Home 確認失敗發生在哪個步驟，再調整相應設定。訂閱下載失敗、內容解析失敗與伺服器連線失敗，分屬不同階段；前一階段尚未完成時，修改後續階段的 SNI 或 Global Routing 通常無法解決問題。
訂閱更新一直逾時，應該先檢查哪裡？
先在 Home 確認現有連線是否可用，再檢查訂閱 URL 是否完整。如果訂閱網址確實需要透過現有代理存取，可到 Settings → Subscribe 檢查 Update via Proxy。此選項須有可用的代理路徑才能運作，無法憑空建立第一條連線。
出現 401 或 403，還需要重新匯入嗎？
先確認 URL 中的 token 是否遭到截斷，再到自己的服務商帳戶查看訂閱權限，以及連結是否已重設。401、403 是伺服器回傳的存取狀態；反覆匯入同一個失效網址通常不會改變結果。
取得內容後，為什麼沒有伺服器項目？
確認複製的是否為帳戶網頁、登入頁面或規則設定網址。如果取得的是網頁而非可辨識的伺服器清單，請重新取得正確的訂閱網址；不要把網頁原始碼貼進 Add Server。
手動新增的記錄為什麼沒有隨訂閱更新？
在 Home 確認該記錄是否屬於訂閱群組。獨立手動新增或透過單一分享匯入的記錄通常不會隨訂閱更新，因此需要手動編輯，或重新匯入服務商提供的新參數。
更新後記錄變了，需要重新安裝應用程式嗎？
先確認訂閱群組與目前選取的記錄，再重新選擇有效的伺服器。訂閱內容可能由來源調整；重新安裝無法修正來源提供的錯誤參數。排查時記下錯誤訊息、發生步驟與網路環境，並遮蔽密碼、金鑰與訂閱 token。
排查完成後，保留清楚的設定來源，並選擇適合自己的更新方式。完整訂閱適合持續同步；手動填寫方便掌握單筆參數；掃描 QR Code 與剪貼簿則能減少輸入。四種方式可以並用，但請確認每筆記錄是否仍與訂閱來源關聯。