本文適合已備妥服務商提供的連線資料或訂閱連結，準備匯入 Shadowrocket（小火箭）的使用者。先區分伺服器訂閱與 Config 設定檔，再依資料形式選擇 Subscribe、Add Server、掃描 QR Code 或使用剪貼簿；最後確認項目、更新結果與連線狀態。本網站不提供、不販售也不推薦節點或訂閱。
一、先分清 Subscribe 與 Config 設定檔
這四種方式不是四種協定。Subscribe 用來儲存訂閱來源並取得伺服器項目；Add Server 可手動新增伺服器，也能將 Type 設為 Subscribe 以新增訂閱。掃描 QR Code 與使用剪貼簿只是讀取資料的方式；讀取後會建立單一伺服器還是訂閱，取決於原始內容。
Home 主要用來選擇伺服器及控制連線；Config 用來管理設定檔；Settings 用來調整 App 行為。查看 Config 頁面與 Subscribe 相關內容時，別把「遠端設定檔網址」和「伺服器訂閱網址」混為一談。前者可能包含規則、DNS 與策略引用，後者通常用來更新伺服器清單。即使兩者都是 HTTPS 網址，也不能只憑外觀互換。
依資料內容選擇匯入方式
伺服器與訂閱
- 完整訂閱網址：Home → + → Type → Subscribe。
- 分開提供的網址、連接埠、密碼等欄位：Home → +，選擇相應的 Type。
- 單一分享連結或 QR Code：辨識後確認協定與伺服器欄位。
Config 設定檔
- 先確認資料說明指的是設定檔，而不是伺服器清單。
- 在 Config 中管理、查看並選取要使用的設定檔。
- 檢查規則引用的策略是否對應現有伺服器或策略組。
匯入前先確認資料用途；Config 匯入成功，不代表伺服器訂閱也已更新。
二、Subscribe：保留來源並更新伺服器清單
已有完整訂閱連結時，建議保留 Subscribe 項目，不要只複製更新後的某一台伺服器。訂閱項目會記錄來源網址，之後可重新取得清單；手動新增的伺服器則不會因原訂閱變更而自動同步設定。訂閱內容與有效期限取決於使用者原有的服務，購買用戶端不會取得這些資料。
-
確認來源
從自己的服務管理頁面複製完整訂閱網址。確認複製的是訂閱連結，而不是登入頁面網址或單一伺服器的分享連結。
-
選擇類型
開啟 Home → 右上角 +，進入 Add Server，將 Type 設為 Subscribe。不要把訂閱網址填入 Trojan 或 Shadowsocks 的伺服器位址欄位。
-
輸入網址
將網址貼到 URL 欄位，並填入方便辨識的名稱。確認開頭的協定、結尾參數及中間字元都完整，再儲存。
-
重新整理並確認
返回 Home，向下滑動以重新整理訂閱，確認是否已產生伺服器項目。展開對應的群組，核對名稱、協定與數量是否符合來源說明；若出現錯誤，先記下原始提示。
以下僅為連結格式示例，並非可用訂閱。實際網址中的 token 常用來識別帳戶權限，應視為敏感憑證。請勿將完整連結貼到公開留言、截圖或問題回報中；排查時可遮蔽參數值，但不要直接修改目前使用的原始網址。
https://example.com/sub?token=xxxx三、Add Server：依協定逐項填寫參數
只有伺服器位址、連接埠與驗證欄位時，請使用 Add Server 手動設定。先選擇 Type，再依照服務商提供的欄位逐一輸入；不同協定的欄位各異，不可混填密碼、UUID、加密方式或傳輸參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 都應依各自的資料核對，不要用預設值補上未知參數。
Shadowsocks 欄位確認
- Type
- Shadowsocks
- Address
- 依據現有資料填入伺服器網域名稱或 IP 位址。
- Port
- 填入伺服器指定的監聽連接埠。
- Method
- 加密方式須與伺服器端設定一致。
- Password
- 保留完整大小寫與特殊字元。
位址欄不要填入訂閱 URL；Method 和 Password 必須分別填入對應資料。
Trojan 欄位確認
- Type
- Trojan
- Address / Port
- 使用現有資料指定的目標位址與連接埠。
- Password
- 填入驗證密碼，不是訂閱網址中的 token。
- SNI
- 依伺服器端要求填入 TLS 伺服器名稱。
- Allow Insecure
- 保留憑證驗證，不要略過驗證來掩蓋憑證錯誤。
連線位址與 SNI 用途不同；憑證名稱應符合實際 TLS 設定。
例如，只有資料明確標示 Port 為 443 時，才填入 443；使用 TLS 不代表所有服務都採用這個連接埠。儲存後重新開啟項目，確認欄位沒有填錯位置。若服務商之後更改密碼或連接埠，手動建立的項目須自行修改；重新整理另一個 Subscribe 項目不會替它更新。
四、掃描 QR Code 與使用剪貼簿：辨識後先確認內容
掃描適合讀取另一個螢幕上的 QR Code；剪貼簿則適合在同一台裝置上複製完整連結。這兩種方式只負責傳遞內容，不保證內容是伺服器、訂閱或有效設定。QR Code 可能編碼的是網頁網址，剪貼簿也可能包含說明文字；請先確認原始資料用途，再決定是否儲存。
- 掃描 QR Code：開啟 Home 的掃描入口，首次使用時允許相機權限，並將完整 QR Code 放入取景範圍。辨識後確認目標類型；如果開啟的只是網頁，請勿把網頁網址直接當成伺服器參數。
- 剪貼簿：複製一條完整的分享連結後，返回 Shadowrocket，依辨識提示匯入；若系統詢問是否允許貼上，請依本次操作需求授權。若沒有出現提示，可在相應的新增入口手動貼上；請勿反覆複製整篇說明。
- 辨識單一伺服器：
ss://、vmess://、vless://、trojan://等前綴可用來辨認分享格式。請勿自行改寫前綴，也不要將它們當成 HTTPS 訂閱網址。 - 辨識訂閱網址：對於 HTTPS 連結，先確認來源用途。即使是透過掃描或剪貼簿取得，也仍須確認已儲存為 Subscribe，且成功取得清單。
如果 QR Code 顯示在本機照片中，可使用掃描畫面提供的照片讀取入口；若目前畫面沒有此入口，請改用來源提供的文字連結。不要為了掃描而重新製作或公開含有密碼的 QR Code。同一份資料以不同方式重複匯入，可能產生多個相似項目；測試前請依名稱與來源加以區分。
五、匯入後分三個層面確認，別只看連線開關
「已儲存」、「訂閱已重新整理」與「VPN 已連線」代表不同狀態。儲存只表示 App 已接受輸入；訂閱更新成功表示已取得並解析來源內容；開啟連線後，實際請求仍會受到伺服器狀態、Global Routing 與目前 Config 影響。請依下列順序確認，避免將所有問題都歸因於匯入方式。
- 在 Home 確認選取的是剛匯入的目標，而不是舊項目；執行 Connectivity Test 並記錄結果。測試成功不代表所有網站與服務都能正常運作。
- 首次開啟連線時，請完成系統的 VPN 設定授權。若拒絕授權，應先處理授權問題，再判斷伺服器是否可用。
- 檢查 Global Routing：Proxy、Direct、Config、Scene 各有不同用途。選取伺服器後，Direct 不會自動改為透過該伺服器連線；Config 會依目前設定處理請求；Scene 則須確認所選情境。
- 使用 Config 時，請在 Config 頁面確認目前生效的檔案，並檢查規則與策略引用。
DOMAIN-SUFFIX依網域後綴比對，IP-CIDR依 IP 網段比對，GEOIP依 IP 地理資料庫比對，FINAL則在前面的規則都未符合時作為預設處理。
六、訂閱更新與常見匯入問題
更新訂閱是重新取得來源內容，不等於重新購買用戶端，也不等於更新 Config 中的所有規則。重新整理前請保留原有項目並記下錯誤提示；每次只調整一個條件，例如先確認 URL，再檢查網路連線路徑，最後核對服務權限。不要同時刪除設定、修改 DNS 並重建伺服器。
貼上網址後，為什麼清單還是空的？
前往 Home 中相應 Subscribe 項目的編輯頁，確認 Type 和 URL，再返回 Home 向下滑動以重新整理。如果網址實際回傳的是登入網頁、空白內容或不支援的格式，儲存本身不會建立伺服器。請向自己的服務商確認該網址是否適用於 Shadowrocket 訂閱匯入。
訂閱更新逾時，應先檢查哪裡？
先確認目前網路可以連線至訂閱來源。如果已有可用伺服器，可先建立連線再試一次；若需要透過代理取得，請檢查 Settings → Subscribe → Update via Proxy。沒有可用連線時，單是開啟這個選項無法解決來源無法連線的問題。
出現 401 或 403，是匯入方式選錯了嗎？
這類 HTTP 回應通常與驗證或存取限制有關。請從自己的管理頁面重新複製完整 URL，確認 token 沒有被截斷、連結仍有效，並核對服務狀態。不要反覆切換掃描與剪貼簿；使用它們讀取相同網址，不會改變伺服器的授權結果。
更新後找不到原本的伺服器名稱，該怎麼辦？
訂閱來源可能已調整清單或名稱。先展開該訂閱群組查看新內容，重新選取目前有效的項目，再檢查 Config 中是否有使用舊名稱的策略。手動項目與訂閱項目應分開確認，避免誤刪仍需保留的資料。
回報問題時，提供使用的匯入方式、Type、錯誤發生步驟，以及已隱藏敏感資訊的錯誤文字即可。請勿提交完整訂閱 URL、密碼、UUID、WireGuard 私鑰或包含這些資料的 QR Code。若敏感憑證已公開，請透過自己的服務管理管道重設，而不只是刪除本機項目。