本文適合已持有服務商訂閱連結、節點參數或 QR Code 的使用者。先分辨可更新的訂閱、單一節點分享連結與規則設定檔,再透過 Subscribe、Add Server、掃描 QR Code 或剪貼簿匯入,最後確認項目、測試連線並保留更新來源。操作說明以 iPhone / iPad 的介面用語為準,其他平台請依相應功能確認,不假設按鈕位置完全相同。
匯入前:辨別連結內容
Shadowrocket(小火箭)的匯入方式不代表服務來源。本文假設使用者已有自己的服務商與訂閱;本站不提供、不販售、不推薦節點或訂閱。匯入只會將現有連線資料加入客戶端,不會建立伺服器帳號,也不會延長原有服務的有效期限。
首先確認收到的是「訂閱網址」、「單一節點分享連結」還是「設定檔網址」。訂閱網址通常使用 HTTPS,取得後可能會傳回多個節點;單一節點分享連結通常帶有協定前綴;設定檔則可能包含 DNS、規則和策略等內容。它們看起來都是一行文字,不代表可以輸入同一個欄位。
https://example.com/sub?token=xxxx:僅供辨認格式的虛構範例,無法用於匯入。不能只憑 HTTPS 前綴判斷傳回的內容格式。ss://、vmess://、vless://、trojan://:常見的節點分享連結前綴;匯入後仍須核對參數。- 包含
[Rule]、DOMAIN-SUFFIX、FINAL的文字:通常涉及規則設定,不能當作伺服器網址輸入。
Subscribe:分辨節點訂閱與 Config 設定
搜尋「Config 頁面的 Subscribe」時,請先確認訂閱內容。Config 用於管理設定檔;其中的 Subscribe 涉及設定檔訂閱,不應將所有節點訂閱網址都當成規則設定載入。若服務商明確提供的是節點訂閱,常見路徑為 Home → 右上角「+」→ Add Server → Type → Subscribe。兩者都可能讀取遠端網址,但儲存的內容與後續影響不同。
節點訂閱會保留遠端來源,之後更新時可取得服務商調整後的節點清單。手動新增的單一節點不會因此自動成為訂閱。首次匯入前,請保留目前可用的項目;不要只因一次排查失敗就清空 Home,也不要在不了解內容時以遠端設定檔覆蓋現有規則。
-
確認資料類型
核對服務商原有說明中的網址用途。標示為節點訂閱的網址請從 Home 操作;只有完整設定檔才在 Config 中依設定檔訂閱方式處理。
-
選擇 Subscribe
開啟 Home →「+」→ Add Server → Type → Subscribe,將類型切換為 Subscribe 後再輸入網址,避免把整段 URL 填入一般節點的 Address 欄位。
-
貼上完整網址
將原始訂閱 URL 輸入 URL 欄位,保留問號後的查詢參數;並為項目設定容易辨識的名稱。確認開頭與結尾沒有空格或換行。
-
儲存並確認
儲存後返回 Home,等待取得資料完成,並確認訂閱項目下方是否出現節點。需要重新取得資料時,請更新該訂閱,避免重複新增相同網址。
Add Server 手動設定:逐項核對協定參數
若只有伺服器位址、連接埠和憑證,沒有可用的分享連結,請使用 Home →「+」→ Add Server。先在 Type 選擇實際使用的協定,再依欄位填寫。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的驗證方式和傳輸參數各不相同,不能用某種協定的欄位勉強填入另一種協定的資料。
例如,Port 應填入服務商指定的連接埠,不要因為啟用 TLS 就自行改成 443;伺服器 Address 與 TLS 的 Server Name 也不一定相同。使用 WebSocket 連線時,Path 必須保留開頭的斜線;Host、Path 與 TLS 相關名稱各有用途,不能全部換成伺服器 IP。若缺少資料,請向原服務商確認,不要逐項猜測。
連線與驗證
- Type
- 與服務商提供的協定一致,例如 Shadowsocks 或 VLESS。
- Address
- 填入伺服器網域名稱或 IP,不要附加網頁路徑。
- Port
- 填入指定的整數連接埠;443 只是可能的數值,並非通用答案。
- 驗證欄位
- 依協定填入 Password、UUID 等實際欄位,並留意大小寫。
欄位名稱與必填項目會依 Type 改變,儲存成功不代表驗證已通過。
傳輸與 TLS
- 傳輸方式
- 請與伺服器端設定一致,不能只看協定名稱。
- Host
- 只有在相應傳輸方式需要時,才填入服務商提供的要求主機名稱。
- Path
- 使用 WebSocket 時,請保留原始路徑,包括開頭的斜線。
- Server Name
- 依 TLS 設定填寫,不要預設它與連線 IP 相同。
請勿以停用憑證驗證取代網域、憑證與系統時間的確認。
儲存後先確認項目詳情,再測試連線。手動設定的項目通常需要自行維護:服務商變更連接埠、密碼或傳輸設定後,舊參數不會因重新啟動 App 而自動修正。記錄資料來源時,請妥善保留私人備份,不要將密碼寫在公開備註中。
掃描 QR Code:辨別其中的內容
QR Code 只是文字的載體,不是另一種協定。內容可能是單一節點分享連結、訂閱網址,也可能只是服務商的說明網頁。開啟 Home 的掃描功能並授予所需的相機權限,將完整 QR Code 放入辨識範圍;辨識完成後先檢查結果,不要一看到掃描成功就立即連線。
依 QR Code 所在位置選擇讀取方式
QR Code 顯示在另一個螢幕上
- 在電腦或另一台裝置上開啟自己持有的 QR Code。
- 從 Home 開啟掃描功能,確認完整顯示 QR Code 的四周邊界。
- 辨識後核對協定、伺服器與連接埠,再儲存結果。
QR Code 位於目前裝置上
- 若掃描畫面提供相簿入口,請選擇儲存在裝置上的清晰原圖。
- 若目前畫面沒有讀取圖片的入口,請改用服務商提供的文字連結。
- 透過剪貼簿匯入文字,不要將圖片貼入 URL 欄位。
若辨識結果是一般網頁,請返回原服務商頁面確認用途;不要把任何網頁都當成訂閱。
無法辨識時,先排除反光、模糊、遮擋與裁切等問題,尤其要保留 QR Code 周圍的空白邊界。若辨識成功但匯入失敗,請檢查內含文字格式是否受支援;放大圖片無法補回缺少的驗證參數。含有完整憑證的 QR Code 和訂閱 URL 一樣需要保密。
剪貼簿匯入:複製原始文字再匯入
剪貼簿適合處理目前裝置上的文字連結。先從可信任的來源複製完整的一行,切回 Shadowrocket,使用 App 提供的剪貼簿匯入提示或相應操作;系統詢問貼上權限時,依本次操作需要允許。若沒有出現提示,不必反覆重新啟動 App;可依資料類型手動開啟 Subscribe 的 URL 欄位,或使用單一節點連結的匯入功能。
- 只複製連結本身:不要連同「點此匯入」等說明文字、中文引號或 Markdown 括號一起複製。網頁上顯示的文字與實際連結目標可能不同。
- 保留查詢參數:訂閱網址中
?後的 token 通常用於驗證,不可只保留網域和路徑;也不要截掉&後的參數。 - 分辨文字跳脫:如果複製的內容含有字面上的
&,可能是複製到網頁原始文字;請優先重新複製原始連結,不要未經確認就手動替換整段內容。 - 逐項確認匯入結果:多行節點文字可能會建立多個項目。先確認數量與協定,再決定是否保留,避免重複匯入同一組內容。
遇到「無法辨識」時,先將內容貼到裝置上可信任的文字編輯器,檢查開頭與結尾。不要上傳到線上解碼網頁。對於已編碼的分享連結,也不需要先自行解碼再填入一般節點欄位;客戶端應接收完整且受支援的原始分享格式。
匯入後:測試連線並保留更新來源
匯入完成、延遲測試有結果、網頁可以開啟,是三個不同的檢查項目。匯入完成只代表資料已解析並儲存;測試結果也只反映該測試方式下的連線情況。實際瀏覽還會受到驗證、DNS、TLS、路由規則與目標網站狀態影響。請先在 Home 選擇明確的項目,再測試連線;避免同時切換節點、修改規則和更新訂閱,以免失去比對依據。
- 檢查路由模式:在 Home → Global Routing 確認 Proxy、Direct、Config 或 Scene。Config 會依目前設定規則處理;Direct 不適合作為代理節點是否可用的判斷依據;使用 Scene 時,請確認目前場景實際採用的策略。
- 分開測試與日常設定:若要排除規則影響,可暫時使用 Proxy 進行比對;測試後請恢復原本的設定。不要因為一次測試成功就刪除原有設定。
- 檢查自動連線:在 Settings → On Demand 確認是否設有自動連線條件。On Demand 負責觸發連線,不會修復訂閱格式或帳號驗證問題。
- 管理訂閱來源:分開管理可更新的訂閱與手動設定項目。更新前請留意自己對訂閱項目的本機修改;遠端更新可能會變更節點清單與參數。
貼上訂閱後,為什麼一個節點都沒有?
先返回訂閱項目,確認 URL 是否完整,再確認取得的內容是節點訂閱,而非登入網頁或完整規則設定檔。若出現驗證失敗,請向原服務商確認網址是否有效;不要連續新增相同項目。
掃描成功了,為什麼還是無法連線?
開啟新項目的詳細資料,對照原始資料檢查 Type、Address、Port、驗證與 TLS 參數。若完全一致,再確認目前網路是否允許該傳輸方式,以及系統時間是否設為自動。
訂閱取得逾時,應先調整哪些設定?
先確認目前網路可以連上訂閱網域,再檢查 URL 拼寫與有效期限。若確實需要透過代理取得,必須先有一條已確認可用的連線;尚無可用連線時,單純啟用相關選項並不能建立連線。
重新匯入後出現兩組相同的節點?
先比較兩組項目的訂閱來源與名稱。保留正確來源,確認可以更新後再刪除重複項目;之後直接更新既有訂閱,不要每次更新都重新新增訂閱。