Base64 JSON 分享格式

本格式先把 JSON 配置編碼爲 Base64,再加 vmess:// 前綴。客戶端可讀取單條鏈接或訂閱中的多條鏈接。它與 VMessAEAD 的 URL 查詢參數格式是兩種不同表示,不能把字段直接混用。

導入失敗時,檢查鏈接是否被換行、引號、網頁轉義符或截斷破壞。不要把 Base64 當作加密,也不要公開實際 UUID 和服務器信息。

Format複製
vmess://<Base64(JSON)>

基礎字段

字段值需與服務端一致。下表保留分享格式中的字段名,填寫端口和 alterId 時應保持客戶端導出的類型。

字段含義
v分享格式版本,常見爲 2
ps配置備註
add / port服務器地址 / 端口
id認證 UUID
aidalterId;現代 AEAD 配置通常爲 0
scyVMess 加密方式,缺省爲 auto
net傳輸類型,如 tcp、ws、h2、grpc
type傳輸的僞裝類型,未使用時常見爲 none

host 與 path 隨傳輸改變

不要僅憑字段名推斷含義。WebSocket 路徑需要與服務端一致,gRPC 的 path 在該分享格式中表示 serviceName。

傳輸hostpath
TCP HTTP 僞裝HTTP Host,可有多個按服務端僞裝設置
WebSocket請求 Host請求路徑
HTTP/2Host路徑
QUIC加密方式密鑰
mKCP依配置而定seed
gRPC依配置而定serviceName

TLS 與證書字段

tls 表示 TLS 設置,sni 對應服務器名稱,alpn 爲協商協議列表,fp 爲客戶端 TLS 指紋。vcn 用於證書名稱驗證,pcs 用於固定證書指紋。

舊鏈接可能包含 insecure。新版本 Xray 已移除 allowInsecure,不能認爲保留舊字段就會繼續跳過證書校驗。遇到證書錯誤,應覈對系統時間、SNI、證書鏈和固定證書設置。

證書固定

一個不含真實憑據的示例

這是編碼前的 JSON,用於說明字段組合,不能直接建立連接。將自己的有效參數填入客戶端後導出分享鏈接,通常比手動拼接更可靠。

JSON · format example複製
{
  "v": "2",
  "ps": "Example WS TLS",
  "add": "proxy.example.com",
  "port": "443",
  "id": "00000000-0000-4000-8000-000000000000",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "proxy.example.com",
  "path": "/example",
  "tls": "tls",
  "sni": "proxy.example.com",
  "alpn": "h2,http/1.1",
  "fp": "chrome"
}