协议配置 · 使用指南

Hysteria2 怎样对照服务端核查证书与混淆类型

配置 Hysteria2 时,先让密码与证书匹配对端,再按需要设置端口切换、报文混淆、拥塞控制及 Realm。

  • password
  • 设定端口集合与切换周期
  • obfs
  • 拥塞控制
  • Realm
查看分节

先配齐连接所需条件

type: hysteria2 要求对端也采用 Hysteria 2。它借助 UDP 上的 QUIC 承载连接,流量外观采用 HTTP/3,不能接入 Hysteria 1.x 服务端。

创建配置前应先给出有效端口来源,再填写名称、类型和服务器。单端口用 port,切换端口用 ports;两项都为空会触发 invalid port。

name不可省略
规则或策略组引用连接时所用的名称。
type: hysteria2不可省略
指定 Hysteria2 协议,对端无法用 Hysteria 1.x 代替。
server不可省略
填写实际接入主机的域名或 IP。
port / ports择一设置
可给出固定端口,也可提供用于切换的端口集合。
password身份验证
密码按对端认证要求填写。构造配置允许留空,但这不代表服务端会接受空凭据。

分别核对密码与证书

Hysteria2 的握手使用 TLS 1.3。认证密码用于身份检查,可信证书及服务器名称用于 TLS 验证,密码匹配并不能跳过后者。

password身份验证
对端借此验证客户端;若采用 userpass,应完整保留服务端给出的认证格式。
sniTLS
名称应对应服务器证书;没有单设时沿用 server。
alpnTLS
页面所示写法使用 h3;没有对端要求时保留协商行为即可。
skip-cert-verify先了解风险
仅在已知风险的定位故障或自签场景下考虑关闭验证。
name-cert-verifyTLS
为证书名称的检查另设目标。
fingerprintTLS
填写服务端整张证书的 SHA-256 摘要,用于锁定证书。
certificate / private-keymTLS
对端要求 mTLS 时,客户端证书和私钥需要一起提供。

设定端口集合与切换周期

一旦提供 ports,连接便从集合内选取端口,单独的 port 不再参与选择。集合可用连字符表达连续区间,再用逗号或斜杠拼接各项。

ports需要时设置
服务端与防火墙需放行相同的 UDP 端口集合;列表可同时包含单值和范围。
hop-interval默认 30 秒
可采用固定的秒数,也可通过一个区间让切换周期随机变化。
最小间隔5 秒
起始间隔低于 5 秒时,实现会将其抬高到 5 秒。
范围限制重要
只有配置 ports 后才读取 hop-interval;区间只能填写一组,不能以逗号拼接多组。

让混淆类型与对端配套

需要混淆时,两端须采用相同类型及密码。它调整 QUIC 报文的外观,承载仍是 UDP,无法解决全部 UDP 都被阻断的情况。

obfs需要时设置
留空表示不混淆;可选择 salamander 或 gecko。
obfs-password启用时需提供
填写 obfs 时也要提供密码,缺少密码会使客户端返回 missing obfs password。
obfs-min-packet-size仅 Gecko
Gecko 握手分片的线上包下限由此控制,页面记载的上游默认值为 512 字节。
obfs-max-packet-size仅 Gecko
Gecko 握手分片的线上包上限由此控制,页面记载的上游默认值为 1200 字节。
Gecko 范围约束
上限不能低于下限,也不能高于 2048 字节;这组包大小选项对 Salamander 无效。

区分发送速率和接收窗口

Hysteria2 用 up 和 down 分别设置两个方向的 Brutal 行为,填写要求与 Hysteria 1.x 不同。设置 up 后本地上传采用 Brutal;设置 down 后,下载目标速率由对端处理。

bbr-profile 只影响未启用上传 Brutal 的客户端发送行为,下载方向仍由服务端控制。quic-go 接收窗口牵涉带宽时延积与内存消耗,缺乏依据时不宜改动。

up / down需要时设置
采用 Brutal 时填写目标速率;省略单位按 Mbps 解析,目标应在链路稳定承载范围内。
bbr-profile默认 standard
本地未用 up 开启 Brutal 时才影响上传,可选 standard、conservative、aggressive。
initial-stream-receive-window进阶设置
限定 QUIC 每条流开始时的接收窗口。
max-stream-receive-window进阶设置
限定 QUIC 每条流可扩展到的接收窗口上限。
initial-connection-receive-window进阶设置
设定整条 QUIC 连接开始时的接收窗口。
max-connection-receive-window进阶设置
设定整条 QUIC 连接可扩展到的窗口上限。

按需接入 Realm 辅助服务

realm-opts 对应 Hysteria2 Realm 的牵线及 UDP 打洞功能。默认不启用,获得服务端或提供方给出的配套参数后再配置。

realm-opts.enable默认 false
此项需要明确填 true 才会开启 Realm。
realm-opts.server-urlRealm
填写用于牵线的 HTTPS 服务地址。
realm-opts.token / realm-opts.realm-idRealm
前者是牵线服务凭据,后者用来指定目标 Realm。
realm-opts.stun-serversRealm
填写负责发现公网 UDP 地址的 STUN 服务列表。
realm-opts.sni / skip-cert-verify / fingerprint作用域
这些设置仅验证 realm-opts.server-url 对应服务;代理端的 TLS 仍需在自身作用域配置。

从基础连接开始检查

先验证固定端口、不启用混淆时的密码和证书,再按对端要求增加切换端口及混淆选项。

  • auth-str、protocol 是旧代字段,Hysteria2 配置不应继续携带。
  • obfs 与 obfs-password 应成套填写,漏掉密码会阻止创建连接配置。
  • 端口周期性切换后掉线,应核对 ports 与对端、防火墙放行范围是否一致。
  • up、down 超出链路实际能力会增加拥塞及丢包,应按可承载速率设置。
YAML
proxies:
  - name: hysteria2-node
    type: hysteria2
    server: server.example.com
    port: 443
    password: replace-with-server-password
    sni: server.example.com
    alpn:
      - h3
    skip-cert-verify: false