辨认 Hysteria 的协议代际
type: hysteria 要求两端都采用 Hysteria 1.x。虽然底层同为 QUIC,这一代的报文不能与 Hysteria2 互认。
名称、地址、类型和端口之外,Hysteria 还要求 up 与 down 有效。服务端决定是否验证身份;需要验证时,应按其要求提供 auth-str 或 auth。
name不可省略- 供策略组识别这条连接的名称。
type: hysteria不可省略- 选择的是 Hysteria 1.x,对端也必须采用这一代协议。
server / port不可省略- 填入服务器及基础端口;使用 ports 的同时仍须保留 port。
up / down不可省略- 上下行速率都必须能被正确解析且大于零,否则连接配置无法建立。
身份凭据与报文承载
先从服务端确认外层发包方式,再决定传输模式。认证内容可使用普通文本或 Base64 编码形式,二者属于不同输入字段。
auth-str身份验证- 按原样录入对端给出的认证文本,便于逐项核对。
auth身份验证- 该项接收经过 Base64 编码的认证内容。若也填写 auth-str,实现会选用 auth。
protocol默认 udp- 省略此项采用 udp;另有 wechat-video 和 faketcp 可供服务端配套选择。
obfs需要时设置- 填写这一代 XPlus 使用的混淆文本;salamander 和 gecko 属于另一代协议。
obfs-protocol旧格式兼容- 这是兼容旧格式的覆盖项,填写后会取代 protocol;没有兼容需求时直接设置 protocol 即可。
按链路能力填写速率
up 与 down 为 Brutal 提供收发速率。Hysteria 1.x 把未注明单位的值视作 Mbps;例如 30 Mbps 这样的写法明确标出了单位,并非链路性能结论。
这些速率控制发送行为。超过链路实际承载能力的设置会持续造成拥塞,因此不能直接照填套餐宣称的带宽。
| 字段 | 收发方向 | 取值依据 |
|---|---|---|
up | 本地向外发送 | 以上行链路能稳定承载的速率为上限 |
down | 远端向本地发送 | 以下行链路能稳定承载的速率为上限 |
| 速率单位 | 上传及下载 | 写出 Mbps 便于检查;未标明时仍以该单位解析 |
配置可切换的 UDP 端口
ports 决定 Hysteria 1.x 可切换的 UDP 端口集合,支持单值、范围及逗号或斜杠连接的组合。即使提供了集合,port 仍是必需项。
port不可省略- 同时使用 ports 时,这个基础端口也要保留。
ports需要时设置- 端口集合需与防火墙及转发规则一致,可组合写入单值和连续范围。
hop-interval默认 10 秒- 以整数秒表示相邻端口切换的等待时间。
握手校验和接收行为
Hysteria 1.x 依赖 TLS 1.3。未给 alpn 时使用 hysteria;对端没有提出其他要求,就不要套用 Hysteria2 的 h3。
sniTLS- 名称应对应服务器证书;没有单设时沿用 server。
alpn默认 hysteria- 协商标识应服从对端要求,QUIC 本身并不能作为改填 h3 的依据。
skip-cert-verify先了解风险- 关闭验证需要明确的排错或自签证书理由,并先理解其风险。
name-cert-verify / fingerprintTLS- 前者指定验证证书名称的目标,后者约束证书摘要。
recv-window-conn进阶设置- 此项限定 QUIC 每条流的接收窗口,没有调整依据时保持原值。
recv-window进阶设置- 这是 QUIC 整条连接的窗口设置;扩大窗口也会消耗更多内存。
disable-mtu-discovery进阶设置- 确认系统或路径的 MTU 探测有问题后,才考虑关闭此功能。
fast-open默认 false- 可减少建立连接的等待,但目的端可达性的确认时点也会随之变化。
迁移时逐项区分字段
迁移应依据目标服务端重新填写配置。共用 UDP 和 QUIC 并不意味着认证、混淆或速率设置可以在两代协议之间直接互换。
| 核对项目 | Hysteria 1.x | Hysteria2 |
|---|---|---|
| 身份验证 | auth-str / auth | password |
| 外层发包 | udp、wechat-video、faketcp | 以 UDP 承载 QUIC,无 protocol 选项 |
| 速率设置 | up、down 均需填写有效速率 | 按方向决定是否填写,填入即采用 Brutal |
| 外观处理 | obfs 采用文本形式 | 选择 salamander / gecko,并配套 obfs-password |
| 对端要求 | 对端须为 Hysteria 1.x | 对端须为 Hysteria2 |
结合示例核对错误配置
使用这份写法前,先与对端确认认证内容、SNI 和速率设置。若没有填写 alpn,会沿用 Hysteria 1.x 的协议默认值。
password、obfs-password、salamander 属于 Hysteria2,不能代替本代的字段。- 缺少
up、down,或把速率设为零,都会使配置因无效速率而失败。 - 对端采用 hysteria 作为协商标识时,客户端不能改用 h3。
- 加入 ports 后依然需要 port,不应将基础端口移除。
proxies:
- name: hysteria-v1
type: hysteria
server: server.example.com
port: 443
auth-str: replace-with-server-auth
protocol: udp
up: "30 Mbps"
down: "200 Mbps"
sni: server.example.com
skip-cert-verify: false