Shadowrocket 分享連結格式解析:ss://、vmess://、vless://、trojan:// 與訂閱連結的差異

單條分享連結只描述一個節點,訂閱連結則是可更新的節點清單。本文解析幾種常見連結的結構,並說明如何在 Shadowrocket 中匯入。

本文重點

如果手上已有服務提供者給的連結,先查看開頭,再選擇匯入方式:ss://、vmess://、vless://、trojan:// 以單條記錄匯入;服務提供者明確標示為訂閱的 HTTPS 網址,則使用 Subscribe 新增。匯入後,分別確認清單、連線與分流。

如何區分分享連結與訂閱連結

單條分享連結包含一組連線參數,匯入後會新增一筆本機記錄。訂閱連結則指向服務提供者維護的清單;更新時,客戶端會重新向該網址發出請求並解析回應。即使訂閱目前只傳回一個節點,它仍然是訂閱;反之,從清單中單獨複製出來的分享連結,也不會隨原清單自動更新。

匯入訂閱:保留清單來源

建議

如果服務提供者已提供訂閱並會維護清單,請儲存原始訂閱 URL。之後從訂閱群組更新即可,不必逐筆重新複製分享連結。

適用情況:已有訂閱,需要同步服務提供者更新的清單。

單條匯入:儲存一組連線參數

只會新增連結所描述的那筆記錄。服務提供者調整位址、連接埠或憑證後,需確認新參數並取代舊記錄。

適用情況:手上只有一條分享連結,或只想確認單筆記錄。

結論:不要將任意 HTTPS 網址填入 Subscribe

先確認服務提供者是否將該網址標示為適用於 Shadowrocket 的訂閱。登入頁、說明文件和訂閱網址都可能以 https:// 開頭,清單網址甚至可能沒有 /sub;單憑開頭、路徑或 token 參數,無法判斷回應內容。

解析 ss://、vmess://、vless://、trojan:// 欄位

以下的網域、密碼與識別碼僅供排版示範,無法用於連線。範例中的連接埠是示意值,並非這些協定的固定連接埠。實際匯入時,請保留服務提供者給的完整連結,包括 ? 後的參數及 # 後的備註。

4 種
本文解析的單條分享連結前綴
8388
下方 Shadowsocks 範例的伺服器連接埠
443
下方 TLS 範例使用的伺服器連接埠

Shadowsocks:ss://

ss://[email protected]:8388#demo-ss

這是將認證資訊放在 @ 前方的一種常見格式。此處以 Base64URL 編碼的內容為 aes-128-gcm:dummy,分別代表加密方式與示範密碼;@ 後方則是伺服器與連接埠。Base64URL 是編碼方式,並非密碼保護。舊格式的編碼範圍可能更大,因此不能只因看不到明文伺服器位址,就判定連結已損毀。

VMess:vmess://

常見格式會在 vmess:// 後方放置一段以 Base64 編碼的 JSON。下方展示的是解碼後的欄位範例,並非可直接貼上的分享連結。add 和 port 分別是連線位址與連接埠,id 是使用者識別碼,ps 是備註。此範例的 net 為 ws,因此也要確認 WebSocket 的 host 和 path,以及 TLS 使用的 sni。

{
  "ps": "demo-vmess",
  "add": "vmess.example.com",
  "port": "443",
  "id": "11111111-1111-4111-8111-111111111111",
  "net": "ws",
  "host": "vmess.example.com",
  "path": "/demo",
  "tls": "tls",
  "sni": "vmess.example.com"
}

VLESS 與 Trojan:vless://、trojan://

vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=vless.example.com#demo-vless
trojan://[email protected]:443?sni=trojan.example.com#demo-trojan

Shadowrocket 匯入步驟:複製單條連結或新增 Subscribe

以下以 iPhone / iPad 介面為例。複製時,從協定前綴或 https:// 開始,一直到連結末尾;不要包含引號、聊天軟體附加的說明或行尾標點。文中的範例僅供確認結構,請使用自己的完整連結。

從 Home 匯入:依手上的連結選擇操作

單條分享連結
  • 複製完整的協定連結,返回 Shadowrocket 的 Home。若系統詢問是否允許貼上,確認來源無誤後再允許;若 App 辨識出連結,依提示新增。
  • 若沒有出現匯入提示,先檢查剪貼簿中的前綴與結尾。若服務提供者另有提供同一筆記錄的 QR Code,可使用 Home 的掃描入口匯入;也可以點選右上角的 +,依實際的 Type 手動填入服務提供者給的欄位。
  • 新增後,在 Home 確認是否多出一筆記錄,並開啟記錄核對協定、位址與連接埠。提示框消失不代表記錄已儲存。
訂閱連結
  • 前往 Home → + → Type → Subscribe,在 URL 欄位貼上服務提供者給的完整網址。範例:https://example.com/sub?token=xxxx。
  • 儲存後返回 Home,確認相應的訂閱群組是否出現,以及群組內是否已載入節點。只看到群組名稱,還不能確認清單已成功解析。
  • 若要同步服務提供者的更新,請在 Home 使用該訂閱群組的更新功能,再檢查群組內的記錄;不必為了更新而重複新增相同的 URL。

單條連結的驗收對象是一筆記錄;訂閱則要確認對應的群組及群組內清單。兩者都還需要另行測試連線。

匯入成功後,如何區分連線問題與分流問題

  1. 先確認記錄。 開啟目標節點,確認協定類型、伺服器與連接埠都符合原始連結。同名記錄不一定是同一個節點;若有舊記錄,不要只憑備註判斷選取的是哪一筆。
  2. 再確認連線。 在 Home 選取已確認的記錄,開啟連線開關。若無法建立連線,請檢查憑證是否仍有效,以及 TLS、sni、傳輸方式與路徑是否符合服務提供者給的設定。App 接受連結,只代表能解析該記錄,不代表遠端服務可用。
  3. 最後確認分流。 前往 Home → Global Routing 查看目前模式。Direct 不會使用已選取的代理節點,因此不能用來確認節點是否接管目標請求;Config 會依目前設定比對規則,即使請求成功,也可能命中 DIRECT。若只想判斷問題是否與規則有關,可暫時選擇 Proxy,重試相同請求後再還原原設定。

匯入失敗與訂閱更新常見問題

複製了 vmess://,返回 Home 後為什麼沒有新增記錄?

先確認複製的是從 vmess:// 開始的完整字串,而不是解碼後的 JSON,或聊天視窗中被截斷的預覽。再確認是否曾出現系統貼上提示。若仍無法辨識,請向原服務提供者確認連結格式,並使用對方提供的 QR Code 或原始參數;不要自行修改編碼來嘗試。

訂閱群組已出現,為什麼裡面是空的?

先對該群組執行一次更新,再確認儲存的 URL 是否完整,尤其是 ? 後方的驗證參數。如果服務提供者回傳登入頁或錯誤頁,即使網址能在瀏覽器中開啟,也無法作為清單匯入。此時應向原服務提供者確認訂閱是否有效、格式是否正確。

訂閱已更新,為什麼先前單獨匯入的同名節點沒有變更?

更新只會套用到對應的訂閱群組,不會依備註名稱覆蓋手動匯入的獨立記錄。在 Home 展開對應群組,選用群組內的新記錄並確認;若打算刪除舊項目,請先確認它確實是獨立記錄,而非群組內的項目。

排查問題時,可以傳送原始連結或 QR Code 嗎?

請勿公開原始內容。單條連結可能包含密碼或 UUID,訂閱 URL 可能含有存取憑證,QR Code 也可能編碼相同資訊。回報問題時,提供協定前綴、匯入步驟、錯誤訊息,以及已遮蔽敏感欄位的截圖即可。

Shadowrocket 下載與匯入教學

iPhone / iPad 版可從 App Store 下載,價格為 $2.99 一次性付費;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版免費。下載頁依裝置列出取得方式,快速入門內容則說明新增記錄後的連線步驟。

下載 Shadowrocket