协议配置 · 使用指南

Hysteria 初代怎样选定收发速率和 UDP 端口

先辨认 Hysteria 的协议代际,再配齐认证、收发速率及端口信息,并核对握手和 QUIC 接收设置。

  • auth-str
  • 带宽
  • 配置可切换的 UDP 端口
  • QUIC
  • obfs
查看分节

辨认 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 这样的写法明确标出了单位,并非链路性能结论。

这些速率控制发送行为。超过链路实际承载能力的设置会持续造成拥塞,因此不能直接照填套餐宣称的带宽。

Hysteria 带宽字段
字段收发方向取值依据
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 配置差异
核对项目Hysteria 1.xHysteria2
身份验证auth-str / authpassword
外层发包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,不应将基础端口移除。
YAML
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