按层核对 VLESS 参数
先分清身份认证、流控、加密、承载方式和连接安全,再配置 proxies 中的 VLESS 出站;某一层的开关并不能说明其他层已经启用。
基础连接信息加上 uuid 即构成起点。是否另配 flow、encryption、Reality、TLS、UDP 或其他承载方式,须由远端设置决定。
name必填- 使用独立的出站标识,确保配置内没有同名项。
type必填- 类型取
vless,并确认所用内核具备该协议能力。 server必填- 指向 VLESS 远端,可填写主机域名或者 IP。
port必填- 将连接端口对齐远端实际监听项。
uuid必填- 使用远端给此用户指定的 ID,不能任意替换。
Vision 与流控的职责
flow 用于挑选子协议;这里列出的取值是 xtls-rprx-vision。留空则不启用这项流控。
flow可选- 取值
xtls-rprx-vision须与远端给用户设置的流控相符。 xtls-rprx-vision流控- 开启 Vision 后,仍须独立设置 TLS、Reality、
uuid及encryption中需要的项目。
协议加密如何配置
encryption 用于 VLESS 自身的协议层,和 VMess 的 cipher 分属不同协议。设置它不会顺带打开 TLS 或 Reality;不使用该加密方案时,示例以空字符串表示。
若远端开启这项能力,应完整接收其生成的配置字符串。算法、运行模式、握手模式、可选填充及密钥内容共同组成该值,不能拆开随意修改。
encryption按服务端- 未启用此加密方案时可留空字符串;启用后应换成与远端配对的完整值。
mlkem768x25519plus算法- 这是所列混合密钥交换方案的名称,勿擅改成没有列出的算法。
native / xorpub / random三选一- 这些运行模式互斥;与 Vision 配合时,
native或xorpub可使用 Splice。 1rtt / 0rtt二选一- 握手模式需择一,早期数据复用还依赖远端的 ticket 配置。
vless-x25519生成命令- X25519 内容通过生成入口
vless-x25519取得,勿手工伪造密钥。 vless-mlkem768生成命令- ML-KEM-768 内容通过生成入口
vless-mlkem768取得。 padding仅 1-RTT- 可选填充仅适用于完整往返的握手;若启用,首段的概率及长度也必须满足该方案要求。
UDP 放行与封装分别设置
udp 是流量开关;packet-encoding 则选择承载 UDP 数据的封装,二者各有职责。
udp可选- 默认
false表示未放行;改成true前,也要确认远端接受 UDP。 packet-encoding可选- 缺省采用
xudp;若需显式指定,可在packetaddr和xudp之间选择,对端须能接受相应封装。
安全连接与握手身份
Reality 与 TLS 都属于连接安全部分。填写非空 reality-opts 后,还须将 tls 置为 true,否则这里记录的内核逻辑无法创建出站。
tlsReality 时必填- 将其置为
true才启用 TLS;使用reality-opts时这一条件也必须满足。 servername可选- 此项指定 SNI。缺省取
server;若 WebSocket 带有 Host 请求头,所列实现会优先使用该 Host。 alpn可选- 应用协议协商列表应兼顾所选承载方式,并与远端一致。
client-fingerprint可选- 此处填写 uTLS 的握手特征,例如
chrome,所描述的并非证书摘要。 fingerprint可选- 此值约束服务端证书的 SHA-256 摘要,不能与
client-fingerprint混用。 reality-opts.public-keyReality- 填入同远端 Reality 私钥成对的公钥。
reality-opts.short-idReality- 使用远端认可的 short ID。
reality-opts.support-x25519mlkem768可选- 双方均能使用 X25519-MLKEM768 时,才声明这一交换能力。
skip-cert-verify谨慎- 略过检查会削弱对远端身份的确认,不能以此长期替代故障修复。
承载选项要成套填写
network 留空或取值无法识别时,将按 TCP 连接。附属的 *-opts 必须同所选 network 对应才会参与处理。
| network | 关联参数 | 用途提示 |
|---|---|---|
| tcp | 不另设专用 opts | 省略时采用 TCP,也可搭配 Vision |
| ws | ws-opts | 设置 WebSocket 的路径、Host 与 Early Data |
| http | http-opts | 设置请求方法、请求头及 HTTP 路径 |
| h2 | h2-opts | 配置 HTTP/2 的路径与 Host |
| grpc | grpc-opts | 填写 gRPC 的连接选项和服务名 |
| xhttp | xhttp-opts | 对应 VLESS 的 XHTTP 承载 |
xhttp-opts.path按服务端- 对照远端或反向代理的路由填写 XHTTP 路径。
xhttp-opts.host按服务端- 此处配置 XHTTP Host;它与
servername分工不同,应依据远端部署确定。 xhttp-opts.mode可选- 模式可从
auto、stream-one、stream-up与packet-up中择一,并按远端设置核对。
结合示例逐层排查
示例把 VLESS、Vision 和 Reality 分层列出。encryption 使用空字符串,对应没有启用该加密方案的情形。
- VLESS 不采用 VMess 的
alterId或cipher,不能跨协议直接搬用这些字段。 - 远端若已采用 VLESS Encryption,这里的空值应换为相应完整参数。
- 先核对
flow: xtls-rprx-vision,再分别检查 TLS 开关与 Reality 参数,三者不能互相推定。 - XHTTP 连不上时,对照远端逐项检查模式、路径、ALPN 和 Host。
proxies:
- name: vless-reality-vision
type: vless
server: 203.0.113.10
port: 443
uuid: 00000000-0000-0000-0000-000000000001
udp: true
packet-encoding: xudp
flow: xtls-rprx-vision
encryption: ""
tls: true
servername: cover.example.com
client-fingerprint: chrome
reality-opts:
public-key: your-public-key
short-id: your-short-id
network: tcp