4.3 KiB
VLESS
::: danger 目前 VLESS 没有自带加密,请用于可靠信道,如 TLS。 :::
VLESS 是一个无状态的轻量传输协议,它分为入站和出站两部分,可以作为 Xray 客户端和服务器之间的桥梁。
与 VMess 不同,VLESS 不依赖于系统时间,认证方式同样为 UUID。
OutboundConfigurationObject
{
"vnext": [
{
"address": "example.com",
"port": 443,
"users": [
{
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
"encryption": "none",
"flow": "xtls-rprx-vision",
"level": 0
}
]
}
]
}
vnext
: [ ServerObject ]
一个数组, 表示 VLESS 服务器列表,包含一组指向服务端的配置, 其中每一项是一个服务器配置。
ServerObject
{
"address": "example.com",
"port": 443,
"users": [
{
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
"encryption": "none",
"flow": "xtls-rprx-vision",
"level": 0
}
]
}
address
: address
服务端地址,指向服务端,支持域名、IPv4、IPv6。
port
: number
服务端端口,通常与服务端监听的端口相同。
users
: [ UserObject ]
数组, 一组服务端认可的用户列表, 其中每一项是一个用户配置
UserObject
{
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
"encryption": "none",
"flow": "xtls-rprx-vision",
"level": 0
}
id
: string
VLESS 的用户 ID,可以是任意小于 30 字节的字符串, 也可以是一个合法的 UUID. 自定义字符串和其映射的 UUID 是等价的, 这意味着你将可以这样在配置文件中写 id 来标识同一用户,即
- 写
"id": "我爱🍉老师1314"
, - 或写
"id": "5783a3e7-e373-51cd-8642-c83782b807c5"
(此 UUID 是我爱🍉老师1314
的 UUID 映射)
其映射标准在 VLESS UUID 映射标准:将自定义字符串映射为一个 UUIDv5
你可以使用命令 xray uuid -i "自定义字符串"
生成自定义字符串所映射的的 UUID,也可以使用命令 xray uuid
生成随机的 UUID。
encryption
: "none"
需要填 "none"
,不能留空。
该要求是为了提醒使用者没有加密,也为了以后出加密方式时,防止使用者填错属性名或填错位置导致裸奔。
若未正确设置 encryption 的值,使用 Xray 或 -test 时会收到错误信息。
flow
: string
流控模式,用于选择 XTLS 的算法。
目前出站协议中有以下流控模式可选:
- 无
flow
,空字符或者none
:使用普通 TLS 代理 xtls-rprx-vision
:使用新 XTLS 模式 包含内层握手随机填充 支持 uTLS 模拟客户端指纹xtls-rprx-vision-udp443
:同xtls-rprx-vision
, 但是放行了目标为 443 端口的 UDP 流量
此外,目前 XTLS 仅支持 TCP、mKCP、DomainSocket 这三种传输方式。
::: tip 关于 xtls-rprx-*-udp443 流控模式
启用了 Xray-core 的 XTLS 时,通往 UDP 443 端口的流量默认会被拦截(一般情况下为 QUIC),这样应用就不会使用 QUIC 而会使用 TLS,XTLS 才会真正生效。实际上,QUIC 本身也不适合被代理,因为 QUIC 自带了 TCP 的功能,它作为 UDP 流量在通过 VLESS 协议传输时,底层协议为 TCP,就相当于两层 TCP 了。
若不需要拦截,请在客户端填写 xtls-rprx-*-udp443
,服务端不变。
:::
::: tip 关于 Splice 模式 Splice 是 Linux Kernel 提供的函数,系统内核直接转发 TCP,不再经过 Xray 的内存,大大减少了数据拷贝、CPU 上下文切换的次数。
Splice 模式的的使用限制:
- Linux 环境
- 入站协议为
Dokodemo door
、Socks
、HTTP
等纯净的 TCP 连接, 或其它使用了 XTLS 的入站协议 - 出站协议为 VLESS + XTLS
- 需要注意的是,使用 mKCP 协议时不会使用 Splice(是的,虽然没有报错,但实际上根本没用到)
此外,使用 Splice 时网速显示会滞后,这是特性,不是 bug。
使用 Vision 模式 如果满足上述条件 会自动启用 Splice :::
level
: number
用户等级,连接会使用这个用户等级对应的 本地策略。
level 的值, 对应 policy 中 level
的值。 如不指定, 默认为 0。