URL 结构与编码

VLESS 链接由协议、UUID、服务器地址、端口、查询参数与备注组成。端口范围是 1–65535；IPv6 地址应置于方括号内，国际化域名使用 Punycode。

查询参数名区分大小写，同一参数不要重复。参数值与备注需要 URL 编码，例如 /example 编为 %2Fexample，空格编为 %20。以下是结构示意，不是可用节点。

VLESS URL复制
vless://<uuid>@<host>:<port>?type=<transport>&security=<security>#<label>

协议与传输字段

encryption 与 security 不是同一个设置：前者是协议加密，后者是传输安全。新扩展要求客户端和核心同时支持，无法仅凭链接存在某字段就判断可用。

字段含义与取值
encryptionVLESS 常见为 none；较新提案也包含 mlkem768x25519… 形式，须完整保留服务端参数
flow如 xtls-rprx-vision，与服务端一致
typetcp、kcp、ws、http、grpc、httpupgrade、xhttp
securitynone、tls、reality
host / pathWS、HTTPUpgrade、XHTTP 等的 Host 与路径
serviceName / authoritygRPC 服务名 / Authority
modegRPC 的 gun、multi、guna，或对应 XHTTP 模式
mtu / ttimKCP 传输参数
extra / fmXHTTP 扩展 / Finalmask 的 URL 编码 JSON

TLS 与 REALITY 字段

使用 TLS 时核对服务名与证书；使用 REALITY 时保留提供方给出的认证参数。fp 是 TLS ClientHello 指纹，不是证书 SHA-256 指纹。

字段含义
sniTLS / REALITY 的 serverName，省略时通常沿用服务器域名
fpTLS 客户端指纹；REALITY 需要该项
alpn逗号分隔的协议列表，值需 URL 编码
echECH 配置列表
pcs / vcn证书 SHA-256 固定值 / 验证名称
pbkREALITY password 参数，旧界面可能称公钥
sidREALITY shortId
pqvREALITY ML-DSA-65 验证公钥
spxREALITY spiderX，值需 URL 编码

导入与核对示例

以下示例使用保留域名和占位 UUID。复制自己的完整链接到客户端导入后，分别检查地址、端口、传输、SNI 和 flow。不要把 VLESS 的 encryption=none 理解为关闭 TLS；是否使用 TLS 由 security 决定。

VLESS · illustrative URL复制
vless://00000000-0000-4000-8000-000000000000@proxy.example.com:443?encryption=none&type=ws&security=tls&sni=proxy.example.com&host=proxy.example.com&path=%2Fexample#Example%20TLS

旧链接与新核心的差异

VMessAEAD / VLESS 分享提案持续演进，早期示例里的旧 flow 或 xtls 字段不能直接套用到当前版本。导入后连接失败时，先确认客户端实际保留了哪些字段，再检查核心日志。

证书验证失败应修正信任或服务名配置；7.25.6 使用的新 Xray 格式不再以 allowInsecure 作为解决方式。

当前更新与兼容性证书设置