代理协议 · 配置文档

VLESS 怎样分层检查连接安全与数据包封装

VLESS 的身份、流控、协议加密与连接安全各有职责;先分清字段层级,再对照远端设置承载和数据包封装。

  • uuid
  • encryption
  • Vision
  • Reality
  • UDP
章节索引

按层核对 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
wsws-opts设置 WebSocket 的路径、Host 与 Early Data
httphttp-opts设置请求方法、请求头及 HTTP 路径
h2h2-opts配置 HTTP/2 的路径与 Host
grpcgrpc-opts填写 gRPC 的连接选项和服务名
xhttpxhttp-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。
YAML
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