v2rayN 配置 Hysteria2 与 VLESS：内核与字段

配置这两类连接，需要分别核对客户端支持的内核、服务端提供的认证信息，以及协议与传输安全字段。Hysteria2 的地址参数与 VLESS 的 REALITY 参数各有含义；官方没有说明的界面对应关系，须以应用内实际界面为准。

Hysteria2 与 VLESS-REALITY 分别描述了什么

Hysteria2 使用 QUIC 承载连接

Hysteria 2 官方将其描述为基于定制 QUIC 的协议，流量设计成看起来像普通 HTTP/3，并支持 TCP 与 UDP 转发。这些是协议特性，不是速度或连接质量的保证。

协议规范进一步说明，每个 TCP 连接对应一条 QUIC 双向流；UDP 包经过封装后，以数据报发送，超大包还会分片。两类转发在协议中的承载方式有所区别。

REALITY 属于传输安全配置

Xray 文档将 REALITY 描述为修改过的 TLS，借用目标网站的外观与握手作为伪装。服务端会将认证失败的流量转发到已配置的目标站点。

VLESS 出站字段与 REALITY 客户端字段分属不同配置部分。服务器地址、用户身份与传输安全参数需要分别理解，不能只凭连接名称判断字段是否完整。

传输方式仍然有适用条件

Xray 的 REALITY 仅在传输安全类型为 reality 时有效，适用于 RAW、XHTTP 与 gRPC。使用 REALITY 时，仍须核对所用传输是否在文档列出的范围内。

VLESS 的 flow 也有独立条件。启用 XTLS 的流控方式，需要配合 TCP 与 TLS、REALITY，或配合 VLESS Encryption；它不能脱离这些条件单独理解。

先分清客户端支持与发布包包含的内核

v2rayN 列出了不同内核系列

v2rayN 的 README 将其描述为支持 Windows、Linux 和 macOS 的图形客户端，并说明支持 Xray、sing-box 及其他内核。客户端支持范围与具体连接的承载关系需要分开看。

官方支持内核列表把 hysteria2 core 放在 Others 分组，也单独列出了 sing_box core。这能确认两者出现在支持列表中，但不能据此确定某个连接实际调用哪一个。

发布包并非包含全部内核

发布文件说明写明，发布包包含部分内核文件，包括 Xray、sing-box 和 mihomo，其他内核需要自行获取。支持列表中的条目，不等于所有发布包都已包含对应文件。

因此，核对环境时要分别看支持列表与发布包说明：前者说明列出的内核对象，后者说明文件包含范围。仅看到支持某个内核，无法确认本地文件已经齐备。

Hysteria2 的地址信息要按用途拆开理解

协议标识与认证信息各有位置

Hysteria2 官方 URI 规范接受 hysteria2 与 hy2 两种协议标识。认证信息放在用户名位置，若其中含有特殊字符，须按规范进行百分号编码。

使用用户名与密码认证时，认证部分由用户名和密码组成，中间以冒号分隔。识别认证内容时，需要保留这一结构，不能把特殊字符的编码要求忽略。

主机、端口与显示名承担不同作用

主机部分可以附带端口，规范给出的默认端口是 443，并支持 Port Hopping 的多端口格式。端口属于连接信息，需要与显示名称区分。

片段部分用于提供可选显示名，不包含连接信息。修改或辨认显示名称时，不能将名称里的文字当作服务器地址、端口或认证内容的替代。

混淆与服务器名称是不同参数

查询参数中的 obfs 用于指定混淆类型，规范列出 salamander 与 gecko；obfs-password 是另一个独立参数。混淆类型与混淆密码需要分别核对。

规范还列出 sni 参数。它与混淆参数各自占有位置，阅读地址信息时，应区分服务器名称、混淆方式和混淆密码，避免把相邻参数当成同一项内容。

证书与 ECH 信息不能混为一项

insecure 通过规范指定的取值表达真假，pinSHA256 表示证书的 SHA-256 指纹。两者分别表达不同信息，字段名称不能互相替换。

ech 表示经过编码的 ECH 配置列表，并且须与服务端一致。sing-box 的 Hysteria2 出站还明确要求 tls；该要求属于其出站配置文档的说明。

VLESS 的基础字段先核对地址与身份

address 与 port 决定连接目标

Xray 的 VLESS 出站中，address 是客户端连接的服务器地址，可以使用域名，也可以使用两种形式的 IP 地址。它描述的是实际连接目标。

port 是服务器端口，文档说明它通常与服务端监听端口一致。地址和端口应作为目标信息一起核对，不能用用户身份或 REALITY 的服务器名称来替代。

id 与 encryption 都有明确约束

id 表示用户身份，可以使用 UUID，也可以使用文档允许长度内的字符串。因此，不能仅凭它是否呈现为 UUID 外观，就断定字段符合或不符合要求。

encryption 不能留空。若要关闭该项加密，需要明确使用文档规定的关闭取值；空白与显式关闭在这里不是同一种填写方式。

flow 需要结合传输条件理解

flow 留空时，文档将其描述为普通 TLS 代理；使用 xtls-rprx-vision 时，会启用 XTLS，并带有内层握手随机填充。这是字段含义上的区别。

核对流控时，还要同时查看文档要求的配合条件。仅有流控名称，并不能代替对传输方式、传输安全或 VLESS Encryption 的核对。

REALITY 客户端字段要与服务端逐项对应

serverName 受服务端名单约束

serverName 须是服务端 serverNames 中的一个名称。服务端的名称列表不支持通配符，因此不能把任意相似名称都视为符合该字段要求。

文档也允许客户端填写任意 IP 地址，此时握手不携带 SNI，但服务端名称列表须包含空字符串。这种写法附有服务端条件，不能只看客户端一侧。

fingerprint 与公钥字段有各自要求

fingerprint 是必填字段，并须支持 MLKEM。Xray 文档对支持情况给出了有限范围的保证，不能将任意指纹名称都视为满足这一条件。

password 同样必填，含义是与服务端私钥对应的公钥，旧名称为 publicKey。这里需要按 REALITY 字段定义理解，不能仅凭名称把它当作普通口令。

shortId 与 spiderX 不能互相代替

shortId 须是服务端 shortIds 中的一项，最多包含十六个十六进制字符，字符数须为偶数，末尾的零会自动补齐。这些限制需要一并核对。

spiderX 表示初始爬虫路径与参数，官方建议每个客户端使用不同值。它承担的用途与短标识不同，不能拿路径内容替代服务端允许的短标识。

可选校验与分享参数仍有文档边界

mldsa65Verify 是可选的签名校验公钥，用于校验服务端证书的 ML-DSA-65 签名；字段非空时，Xray 才使用它。它与前述必填公钥字段的用途不同。

分享链接参数提案使用 pbk 表示公钥，也列出 sid、spx、fp 和 sni。这些是提案中的参数名称，不能直接当作 v2rayN 输入框名称。

官方没有写明的几件事

Hysteria2 从哪个版本开始受支持

v2rayN 从哪个版本开始支持 Hysteria2，官方没有说明。支持内核列表列出对应条目，并不能据此推出起始版本，也不能补写版本判断。

阅读支持范围时，可以确认列表已经列出该内核；涉及某个版本是否开始支持，则仍须保留这一信息边界，不能把两种问题合并成同一个结论。

Hysteria2 在客户端具体由谁承载

v2rayN 中的 Hysteria2 具体由 hysteria2 core 还是 sing_box 承载，官方没有说明。两个内核都出现在支持列表中，不足以确认客户端内部的选择关系。

涉及实际使用的内核与填写位置，应以应用内界面为准。sing-box 的出站文档可以解释其字段要求，但不能代替 v2rayN 对内核对应关系的说明。

输入框名称、默认值与校验如何对应

v2rayN 的 Hysteria2 填写界面字段说明，以及 REALITY 各输入框的名称与对应关系，官方没有说明。本文列出的名称分别属于对应协议或内核文档。

v2rayN 的默认值与必填校验，官方没有说明。实际填写应以应用内界面为准，不能把内核文档中的字段规则直接改写成客户端的默认行为。

常见问题

支持列表出现 Hysteria2，就代表已经能直接使用吗？

支持列表可以确认 hysteria2 core 已被列出。发布文件说明同时指出，发布包仅包含部分内核，其他内核需要自行获取，因此还须核对实际文件包含范围。

Hysteria2 是否可以直接理解为内置 TLS？

Hysteria 2 首页与协议规范是否明确写出默认加密或内置 TLS，官方没有说明。可以确认的是，sing-box 的 Hysteria2 出站文档将 tls 列为必填，两处说明不能合并成同一个结论。

Xray 与 sing-box 的 REALITY 字段能直接照搬吗？

两者文档使用的字段名称并不完全相同：Xray 使用 password 表示对应公钥，sing-box 使用 public_key。sing-box 还单独规定其短标识和指纹行为，不能只按相似名称判断全部规则相同。

第三方整理,与相关软件及服务的开发者无隶属关系。

v2rayN 配置 Hysteria2 与 VLESS：读懂内核要求和 REALITY 参数