已有訂閱連結時，優先使用 Subscribe；只有單一伺服器參數時，則使用 Add Server。QR Code 與剪貼簿只是讀取資料的方式，無法保證匯入的一定是訂閱。本文主要說明 iPhone / iPad 上 Home、Config 的操作方式，以及如何辨識資料、儲存、更新與驗證。Mac（Apple 晶片與 Intel）、Windows、Android、Linux 使用者也可依相同欄位檢查原則操作，實際按鈕位置請以各平台介面為準。
先分清訂閱、單一伺服器與設定檔
Shadowrocket（小火箭）的匯入入口取決於手邊資料的內容，而不是連結看起來有多長。訂閱需向服務商取得，通常是會傳回伺服器清單的 HTTPS 網址；單一伺服器分享連結描述一條連線；設定檔則用來設定規則、DNS 與策略等行為。把三者都貼進同一個輸入欄位，是「匯入成功卻沒有伺服器」的常見原因。
Home 用來查看及選擇伺服器、控制連線；Config 管理設定檔及相關 Subscribe 操作；Settings 管理 App 設定。Subscribe 也可以在 Add Server 中以 Type 新增至 Home。操作時先確認頁面標題與 Type，不要把設定檔的遠端網址當成伺服器訂閱。
| 手邊的資料 | 辨識方式 | 適合的處理方式 |
|---|---|---|
| 伺服器訂閱連結 | 服務商標示為訂閱，取得後會傳回一組伺服器 | 透過 Subscribe 新增並更新 |
| 單一伺服器分享連結 | 常見前綴為 ss://、vmess://、vless://、trojan:// | 從剪貼簿匯入或掃碼，儲存後確認 Type |
| 伺服器參數表 | 分別列出位址、連接埠、憑證與傳輸參數 | 在 Add Server 中手動輸入 |
| 規則設定檔 | 包含 [General]、[Rule] 等設定區段 | 在 Config 中管理，不作為單一伺服器輸入 |
HTTPS 只表示連結使用加密傳輸，不能只憑此前綴就判定它是訂閱。服務商控制台的登入頁、說明頁與訂閱網址都可能以 HTTPS 開頭。請複製明確標示的訂閱網址，而不是瀏覽器目前顯示的頁面網址。
方式一：使用 Subscribe 新增並保留更新來源
需要定期同步伺服器清單時，適合使用 Subscribe。它會保留原始訂閱網址，之後可重新取得清單；逐筆手動輸入則不會自動取得服務商後續新增或修改的伺服器。首次操作前，可先在 Home 記下現有群組與目前選取的伺服器，避免誤把既有內容當成新匯入的結果。
-
複製連結
向服務商取得訂閱網址，並使用頁面上的複製功能。確認開頭和結尾沒有空格、換行或中文標點，也不要截掉問號後的查詢參數。
-
開啟入口
在 Config 頁使用 Subscribe 入口時，先確認目前操作的訂閱項目。若要將伺服器訂閱加入 Home，可直接前往 Home → 右上角「+」→ Add Server → Type → Subscribe。
-
輸入網址
將完整訂閱連結貼到 URL 欄位，並填寫方便辨識的備註。不要把連結中的 token 拆出來填入 Password，也不要將整個 HTTPS 網址填進一般伺服器的 Address 欄位。
-
儲存並更新
儲存後回到 Home，確認是否出現對應的訂閱群組與伺服器項目。需要重新取得清單時，請在 Home 下拉更新並查看結果，不要只確認輸入欄位仍保留網址。
-
選擇並驗證
在新群組中選取一台伺服器，再執行 Connectivity Test。清單成功顯示代表訂閱已完成解析；測試通過，才進一步表示所選伺服器在目前網路環境下有回應。
如果訂閱網址已外洩，請向服務商重設或更換訂閱憑證，再修改 Shadowrocket 中儲存的 URL 並重新更新。只刪除本機清單，無法讓舊連結失效。
方式二：在 Add Server 手動新增單一伺服器
手動輸入適合手邊只有參數表、需要核對特定連線，或想暫時建立獨立測試項目的情況。操作路徑為 Home → 右上角「+」→ Add Server，先選擇 Type，再填入對應欄位。Type 會決定憑證與傳輸參數的意義，不要為了成功儲存而任意切換。
以下兩張卡片僅供核對欄位，不是可用來連線的伺服器。連接埠 443 是本例指定值，不是所有協定的固定連接埠；實際操作請逐項使用服務商提供的資料。
Shadowsocks 欄位範例
- Type
- Shadowsocks
- Address
- ss.example.com（示範網域）
- Port
- 443（示範連接埠）
- Method
- aes-128-gcm（僅為格式範例）
- Password
- demo-only-not-valid（無效範例）
Method 和 Password 必須與伺服器端一致，不能只憑協定名稱推斷。
Trojan 欄位範例
- Type
- Trojan
- Address
- trojan.example.com（示範網域）
- Port
- 443（示範連接埠）
- Password
- demo-only-not-valid（無效範例）
- SNI
- tls.example.com（示範名稱）
SNI 用於 TLS 交握；是否需要單獨填寫及具體值，請依服務商提供的參數設定。
VMess、VLESS 通常需要 UUID，也可能使用 WebSocket 等額外傳輸設定。WebSocket 的 Host 和 Path 與伺服器 Address 並非相同欄位；Path 中的斜線與大小寫也應保留。Hysteria2、WireGuard 則有各自的驗證或金鑰欄位，不能套用 Shadowsocks 的 Method 和 Password 組合。
- Address 欄位只填指定的主機名稱或 IP，不要自行加上
https://。 - 請依服務商提供的數字填寫連接埠，不要因為使用 TLS 就一律改成 443。
- 若缺少 UUID、金鑰、SNI 或傳輸參數，請先回頭查閱服務商資料補齊，不要自行猜測。
- 儲存後確認備註與 Type，再選取該項目進行測試；修改獨立項目不會同步變更訂閱來源。
方式三：掃碼匯入，先確認 QR Code 內容
掃碼適合在另一台裝置上顯示資料，再用目前裝置讀取。QR Code 只是文字的載體，內容可能是單一伺服器連結、訂閱 URL，也可能只是網頁登入網址。成功辨識不代表伺服器已經新增完成。
- 在另一個螢幕上開啟服務商提供的 QR Code，讓整個 QR Code 完整顯示，避免放大後邊緣遭到裁切。
- 從 Home 左上角的掃描入口開啟相機，首次使用時請允許相機權限。若先前已拒絕，可到系統設定中的 Shadowrocket 權限頁面調整。
- 辨識後確認開啟的內容：若顯示 Add Server，請查看 Type、Address、Port；若讀取到訂閱網址，請確認以 Subscribe 儲存。
- 儲存後回到 Home，確認新增的是單一項目還是訂閱群組，再選取項目進行測試。
請勿為了排查掃碼問題而公開 QR Code 原圖。QR Code 可能直接包含密碼、UUID 或訂閱 token；遮住旁邊的文字，不代表 QR Code 本身已隱藏憑證。
方式四：從剪貼簿匯入並保留完整連結
剪貼簿適合在同一台裝置的瀏覽器、服務商頁面與 Shadowrocket 之間切換。先複製原始分享連結，再回到 Home 使用剪貼簿匯入入口，或確認 App 偵測到剪貼簿內容後顯示的匯入提示。若系統詢問是否允許貼上，請在這次主動匯入時允許。
複製時不要連同說明文字、引號或程式碼區塊一起複製。有些連結在聊天視窗中看起來被折成數行，但原始文字仍是一行；手動逐行選取容易漏字。請優先使用服務商提供的複製按鈕，保留編碼字元，不要自行將 %2F 等內容換成其他字元。
ss://、vmess://、vless://、trojan://常用於分享單一伺服器；是否能解析，仍取決於格式是否完整。- 一般 HTTPS 訂閱連結可直接貼到 Subscribe 的 URL 欄位；若未自動辨識，不必反覆切換 App。
- 若複製了多條連結，匯入後請逐一確認項目數量與 Type；首次排除問題時，建議先用單一項目測試。
- 匯入完成後，可複製一段一般文字覆寫剪貼簿，降低憑證不小心貼到其他地方的風險。
匯入後檢查更新、連線與 Global Routing
匯入、更新、連線與分流是不同階段。訂閱能取得清單，不代表清單中的每台伺服器都能連線；Connectivity Test 有回應，也不代表所有網站都會依預期策略連線。排查時請固定使用同一台伺服器與同一個測試網址，每次只變更一項設定。
- 檢查清單：在 Home 確認訂閱群組下方有伺服器，並選取要測試的項目。若只儲存了訂閱 URL，卻沒有伺服器，請先檢查更新結果。
- 檢查連線：執行 Connectivity Test，再開啟 Home 的連線開關。首次在 iPhone / iPad 建立連線時，請依系統提示允許新增 VPN 設定。
- 檢查路由：前往 Home → Global Routing。Proxy 會透過代理處理流量；Direct 用於直接連線；Config 依目前設定檔中的規則處理；Scene 則依已設定的情境處理，不能將它視為固定的全域代理模式。
- 檢查規則：使用 Config 時，請確認目前使用的設定檔與策略引用有效。規則會依序比對；更新伺服器訂閱不會自動修正錯誤的策略名稱。
- 最後再啟用自動連線：手動測試穩定後，再考慮使用 Settings → On Demand。On Demand 管理依條件連線的行為，不負責下載訂閱，也不能取代伺服器有效性檢查。
例如，DOMAIN-SUFFIX,example.com,DIRECT 會讓符合的網域及其子網域使用 DIRECT；IP-CIDR,192.0.2.0/24,DIRECT 是針對 IP 位址範圍的規則範例。GEOIP 依 IP 地理資訊比對，FINAL 則用於兜底。即使已選取伺服器，符合 DIRECT 的請求仍不會交由該伺服器處理。這是規則比對結果，不一定代表匯入失敗。
訂閱更新與匯入問題 FAQ
貼上後沒有新增伺服器，是連結有誤嗎？
先確認原始資料是訂閱還是單一分享連結。HTTPS 訂閱網址應貼到 Home →「+」→ Type → Subscribe 的 URL 欄位，儲存後再更新；登入頁網址不能當作訂閱使用。若更新結果是網頁內容，請向服務商重新取得訂閱網址。
訂閱更新逾時，需要刪除後重裝嗎？
先確認目前網路可以連線至訂閱網址，並檢查 URL 是否完整。若已有可用伺服器，可先建立連線，再到 Settings → Subscribe 查看 Update via Proxy，視需要開啟後回到 Home 更新。此方式必須有可用的現有代理，不適用於完全沒有可用連線時的首次匯入。
更新時顯示 401 或 403，該怎麼處理？
這類狀態通常表示訂閱伺服器拒絕了請求。請確認 token 是否遭截斷或重設，以及帳戶是否仍有相應權限；向服務商確認後再替換 URL。不要把完整訂閱連結交給陌生人代查，回報問題時只提供已移除憑證的錯誤資訊。
為什麼手動修改的項目更新後又變了？
訂閱更新會依伺服器傳回的內容重新同步，因此訂閱內項目的本機修改可能被覆蓋。若要保留測試參數，請另建獨立項目並清楚備註，再更新訂閱進行比對；不要將獨立項目仍存在，誤認為訂閱已成功更新。
已連線但網頁仍無法開啟，該怎麼辦？
先在 Home 確認目前實際選取的伺服器，執行 Connectivity Test，再查看 Global Routing 是否設為 Direct，或 Config 規則是否將請求導向其他策略。記下逾時、DNS 錯誤或憑證錯誤的具體訊息，分別檢查網路、解析與 TLS 參數，不要一次修改所有欄位。
更新前保留可用的獨立測試項目，有助於分辨「無法取得訂閱網址」與「伺服器本身無法連線」。如果只有某個項目失敗，先比較同一訂閱中的其他項目；如果整個訂閱都無法取得，請優先檢查 URL、存取權限與更新所使用的網路，而不是逐一修改伺服器連接埠。