先配齐连接所需条件
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超出链路实际能力会增加拥塞及丢包,应按可承载速率设置。
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