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"
}