先辨別內容,再選擇匯入方式:節點訂閱使用 Subscribe,獨立伺服器參數使用 Add Server;QR Code 和剪貼簿只是傳遞連結的方式,不能取代格式判斷。本文以 iPhone / iPad 上的 Home、Config、Settings 介面為操作基準;Mac、Windows、Android、Linux 使用者可沿用格式判斷與參數核對方式,實際按鈕位置請以目前平台介面為準。所有訂閱均向你的服務商取得。
一、先辨別節點訂閱、單一連結與 Config
Shadowrocket(小火箭)中的「訂閱」通常是可重複請求的遠端網址,App 會從該網址取得伺服器清單。單一節點連結則直接包含某一台伺服器的協定參數。兩者都能透過複製或掃描 QR Code 匯入 App,但儲存的內容不同:前者需要更新清單,後者通常只是獨立項目。
也要區分節點訂閱與 Config 設定檔。Config 用來管理包含規則、DNS 等內容的設定檔;其中可能包含 DOMAIN-SUFFIX、IP-CIDR、GEOIP、FINAL 等規則關鍵字。取得 HTTPS 網址後,不能只因為它以 HTTPS 開頭,就認定一定是節點訂閱。
節點訂閱網址
- 外觀範例
https://example.com/sub?token=xxxx- 內容來源
- 向你的服務商取得
- 匯入內容
- 訂閱群組及其伺服器清單
- 更新方式
- 重新請求原訂閱網址
範例內容為虛構值,無法用於連線;真實網址中的 token 應視為憑證。
單一節點連結
- 常見前綴
ss://、vmess://、vless://、trojan://- 內容代表的意義
- 一筆伺服器資料的編碼參數
- 匯入內容
- Home 中的獨立伺服器項目
- 變更方式
- 重新匯入或編輯對應欄位
前綴只能提示協定類別,無法證明參數有效,也不代表具備訂閱更新功能。
如果複製的內容以 [General]、[Rule] 等設定檔區段開頭,應視為設定檔處理,而不是貼到伺服器網址欄位。無法判斷時,先向服務商確認「這是節點訂閱、單一節點,還是完整的 Config」,比反覆更換匯入方式更有效。
二、Subscribe:先確認 Config 頁面與 Home 的匯入內容
搜尋「Config 頁面的 Subscribe」時,請先確認目前頁面處理的是遠端設定檔還是伺服器訂閱。Config 中新增、下載或更新遠端設定檔的功能,處理對象是設定檔;若要新增可供 Home 選用的節點訂閱,請前往 Home → 右上角「+」→ Add Server → Type → Subscribe。兩種內容都能透過 URL 更新,不代表它們是同一種資料。
-
取得網址
向你的服務商取得適用於 Shadowrocket 的節點訂閱連結。請複製完整 URL,不要複製服務商登入頁、說明頁標題或按鈕旁的文字。
-
選擇類型
前往 Home → 右上角「+」→ Add Server,將 Type 設為 Subscribe。這裡建立的是伺服器訂閱,不是 Config 規則檔。
-
輸入連結
將完整網址貼到 URL,並為訂閱填寫方便辨識的 Remarks,然後儲存。不要自行刪除問號後的查詢參數,也不要變更 token 的大小寫。
-
檢查清單
返回 Home,等待訂閱請求完成;需要重新請求時,使用訂閱更新功能或下拉重新整理。展開對應群組,確認其中出現伺服器項目,而不只是新增群組名稱。
如果匯入後出現遠端設定檔,但 Home 沒有新增伺服器,請先確認是否將連結新增到 Config。反之,將規則檔 URL 當成 Subscribe 節點訂閱新增,也可能造成格式錯誤或清單空白。判斷是否成功,要看目標內容是否出現且符合預期,而不是只看到「已儲存」。
保留 URL 原樣
訂閱 URL 中的
?、&、=和百分比編碼都有特定用途。不要手動解碼、插入換行,或將半形符號改成全形。若連結已失效,請向你的服務商重新取得,不要自行猜測參數。
三、Add Server:已有獨立參數時手動設定
Add Server 不代表「只能新增訂閱」,而是新增項目的入口;Type 會決定表單欄位與儲存內容。只有取得伺服器位址、連接埠、身分憑證及協定相關參數時,才適合手動設定;如果手上只有訂閱 URL,不要將整條 URL 填入 Address。
- 選擇協定:前往 Home →「+」→ Add Server → Type,選擇服務商明確提供的 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard 等類型,不要根據連接埠猜測協定。
- 確認位址與連接埠:Address 填入伺服器主機名稱或 IP,Port 填入服務商提供的連接埠。例如 Port 為
443只代表連接埠號碼,不表示已啟用 TLS,也不代表任何協定都能使用。 - 確認身分欄位:Shadowsocks 的密碼與加密方式、VMess / VLESS 的 UUID、Trojan 的密碼都必須正確對應。不要把登入服務商網站的密碼當成連線密碼。
- 確認傳輸欄位:依照服務商提供的資訊填寫 TLS、Server Name、WebSocket 的 Host 與 Path 等欄位。Address 與 Server Name 可能不同,不要為了「統一」而將兩者改成相同內容。
- 儲存並單獨測試:設定 Remarks 後儲存,在 Home 選取該項目再進行測試。先驗證一筆資料,避免一次新增多筆相似項目,難以判斷錯誤來源。
手動新增的項目通常不會隨訂閱更新而變更。若服務商更換連接埠或憑證,請編輯該項目或重新匯入。WireGuard 還需要金鑰、介面位址與對端等專用參數,不能套用其他協定的密碼表單;若缺少欄位,請索取完整參數,不要用空值嘗試連線。
四、掃描 QR Code 與剪貼簿:傳遞方式不會改變連結類型
QR Code 可以包含單一節點連結、訂閱 URL,甚至只是一般網頁網址。掃描只負責讀取內容;真正決定匯入結果的是 QR Code 內的文字。剪貼簿也是如此:如果複製到的是網頁標題或整段說明,App 無法據此還原連線參數。
掃描 QR Code 的檢查順序
- 在 Home 開啟掃描入口,首次使用時允許相機權限;將完整 QR Code 放入辨識範圍,避免裁掉四角或 QR Code 周圍必要的邊界。
- 辨識後先查看預覽或新增表單:內容是 Subscribe 類型的 URL,還是包含特定協定與伺服器位址的單一項目。
- 確認來源與匯入內容後再儲存。如果辨識結果只是說明網頁,不要硬把頁面網址當成伺服器 Address。
剪貼簿匯入的檢查順序
- 在來源頁面使用複製連結功能,或完整選取一條連結;不要連同引號、序號或句號一起複製。
- 切回 Shadowrocket,依照介面顯示的剪貼簿匯入提示操作;若系統詢問是否允許貼上,確認本次內容後再允許。
- 若沒有自動提示,節點訂閱可手動前往 Home →「+」→ Type → Subscribe → URL 貼上;單一協定連結則使用介面提供的剪貼簿匯入功能,不要貼到 Address 欄位並當成主機名稱。
不建議為了排查問題而將真實訂閱交給線上解碼工具。連結中的憑證可能允許他人讀取你的伺服器清單;QR Code 截圖也應以相同標準妥善保管。操作完成後,可將剪貼簿內容替換成不含憑證的一般文字,降低誤貼的風險。
五、匯入後:測試項目,再選擇 Global Routing
清單中出現項目,只代表資料已解析並儲存,不能證明伺服器可連線。先在 Home 選取要使用的項目,執行 Connectivity Test,再開啟連線並瀏覽已知可用的網頁。延遲測試有結果,不代表 DNS、TLS 與網頁請求都正常,仍須配合實際瀏覽結果判斷。
Global Routing 決定流量如何處理,不會決定訂閱是否正確儲存。日常使用時,確認 Config 內容後可選擇 Config;診斷問題時,可暫時切換至 Proxy,觀察問題是否只在規則分流時發生。Scene 會依照設定的情境選擇路由方式;尚未了解情境條件前,不建議用它增加排查變數。
Config
推薦依照目前選取的設定檔規則處理連線,符合條件的結果可能是代理、直連或拒絕;若前面的規則都未符合,則由 FINAL 負責處理。
適用情況:已確認規則與預設處理方式的日常使用。
Proxy
將納入代理處理範圍的連線交由所選代理處理,用來比對問題是否來自 Config 的分流規則。
適用情況:暫時驗證伺服器連線,並排查規則差異。
Direct
使用直連。不要把它當成「訂閱已啟用」的標誌;切換至此模式後,即使選取伺服器,也不代表請求會經由該伺服器轉送。
適用情況:比對確認本地網路能否直接連線至目標。
六、更新訂閱與常見匯入問題
更新訂閱會重新讀取遠端清單,並不會自動修復所有連線問題。更新前可先記下目前使用的伺服器名稱;更新後重新確認選取狀態,因為服務商可能新增、移除或重新命名項目。若要長期保留手動變更,不要預設它們會在遠端更新後繼續保留。
顯示儲存成功,為什麼一個節點都沒有?
先確認項目的類型是否為 Subscribe,再確認 URL 是節點訂閱,而非登入頁或 Config 網址。如果更新後清單空白或出現格式錯誤,請向你的服務商確認連結狀態與輸出格式;不要靠反覆新增相同訂閱來解決。
更新逾時,需要先開啟代理嗎?
先確認本地網路正常,且 URL 完整。如果已有可用伺服器,而訂閱網址需要透過代理存取,可先連線至該伺服器,再前往 Settings → Subscribe 確認 Update via Proxy 已啟用後重試。若沒有可用連線,啟用此選項也不會自動建立存取通道。
掃描能讀取內容,但匯入失敗怎麼辦?
檢查辨識結果是否為支援的協定連結或完整訂閱 URL。如果讀取到的是網頁、遭截斷的文字或含有空格的字串,請返回來源重新複製原始連結;不要自行拼接缺少的身分參數。
匯入後可以連線,網頁卻打不開?
先確認 Home 選取的是剛匯入的項目,再檢查 Global Routing 是否符合預期;可暫時以 Proxy 和 Config 交叉測試。若仍無法使用,請核對協定參數、系統時間及 DNS,不要直接刪除所有設定。測試結束後,請還原原本的路由設定。
首次驗證時,建議先不要加入自動連線條件。Settings → On Demand 用來依條件觸發連線,不負責匯入或更新訂閱;先完成「匯入 → 選取 → 測試 → 實際瀏覽」,再設定自動連線,才能清楚掌握每一步變更的內容。
- 重複群組:先核對 Remarks 與 URL,再刪除重複項目,以免誤刪正在使用的群組。
- 伺服器拒絕請求:向你的服務商重新取得有效連結,不要修改 token 或猜測存取參數。
- 尋求排查協助:只提供匯入方式、錯誤提示、協定類型與重現步驟;請遮蔽完整訂閱 URL、密碼、UUID 與金鑰。