oh-my-hysteria基于 Hysteria 2 的增强版虫洞工具。v1.2.0 提供更多拥塞控制选择和可选 UDP 混淆

文章目录(快捷跳转)

oh-my-hysteria

基于 Hysteria 2 的增强版代理工具。v1.2.0 提供更多拥塞控制选择和可选 UDP 混淆,保留 Hysteria2 的常用配置与分享链接。

特性

  • 拥塞控制:默认 BBR,支持 Reno、CUBIC,以及实验性 BBRv3、COPA、Geodesic。
  • 启动与预设:CUBIC / Reno 可启用 HyStart++;BBR / BBRv3 提供保守、标准、激进三档。
  • 混淆:Salamander、Gecko、Blink、Presto、Trident、Carakan,以及 Servo、Tasman、Mariner。
  • 代理方式:SOCKS5、HTTP、TCP / UDP 转发、TUN 等 Hysteria2 功能继续可用。

目录

  • 快速开始
  • 拥塞控制
  • 混淆配置
  • 分享链接
  • 配置文件与日志
  • 源码构建与容器
  • 更多文档
  • 许可与致谢

快速开始1. 下载程序

从 Releases 下载对应平台的程序:

平台 文件名
Linux x86-64 oh-my-hysteria-linux-amd64
Linux ARM64 oh-my-hysteria-linux-arm64
Windows x86-64 oh-my-hysteria-windows-amd64.exe

以下命令以 Linux x86-64 为例。Linux 下载后先执行:

chmod +x oh-my-hysteria-linux-amd64

2. 配置服务端

准备域名和对应的 TLS 证书,放行服务端的 UDP 443。保存为 server.yaml, 将证书路径和示例密码替换为自己的内容:

listen: :443

tls:
  cert: /etc/oh-my-hysteria/server.crt
  key: /etc/oh-my-hysteria/server.key

auth:
  type: password
  password: "CHANGE-ME-AUTH-PASSWORD"

启动服务端(Linux 绑定 443 需要相应端口权限):

./oh-my-hysteria-linux-amd64 server -c server.yaml

3. 配置客户端

保存为 client.yaml。auth 与服务端的 auth.password 一致,域名替换为自己的:

server: proxy.example.com:443
auth: "CHANGE-ME-AUTH-PASSWORD"

tls:
  sni: proxy.example.com

socks5:
  listen: 127.0.0.1:1080

http:
  listen: 127.0.0.1:8080
./oh-my-hysteria-linux-amd64 client -c client.yaml

Windows 使用对应的可执行文件:

.\oh-my-hysteria-windows-amd64.exe client -c client.yaml

随后将应用的 SOCKS5 代理设为 127.0.0.1:1080,或 HTTP 代理设为 127.0.0.1:8080。 以上配置使用默认 BBR,不启用额外混淆。下面的配置片段可合并到现有 YAML 中,同类示例选一种即可。

拥塞控制

客户端和服务端分别配置自己的发送方向,两端可以选择不同算法。

配置项 默认值 可选值与用途
congestion.type bbr 选择下表中的算法
congestion.bbrProfile standard conservative / standard / aggressive;仅对 bbr、bbr3 生效
congestion.slowStart legacy legacy / hystart++;HyStart++ 仅支持 cubic、reno,其他算法保留默认值

算法选择

type 说明 状态
bbr 原有 BBRv1 派生实现,按带宽与时延估计控制发送 默认
reno 传统的基于丢包的拥塞控制 可选
cubic CUBIC 拥塞控制,可搭配 HyStart++ 新增
bbr3 独立的 BBRv3 实现,支持三档预设 实验性
copa 延迟驱动的拥塞控制 实验性
geodesic 参考 KCC / UCP 的往返时延基线跟踪;动态路径估计仍在完善 实验性

保留默认 BBR,也可以调整它的预设:

congestion:
  type: bbr
  bbrProfile: standard

CUBIC + HyStart++,根据时延变化调整慢启动退出时机:

congestion:
  type: cubic
  slowStart: hystart++

BBRv3(实验性):

congestion:
  type: bbr3
  bbrProfile: standard

bbrProfile 的三档含义:conservative 减少探测压力,standard 为默认平衡设置, aggressive 更积极地探测带宽。BBR 与 BBRv3 的同名预设使用各自的参数。 选择 COPA 或 Geodesic 时,将 type 改为 copa 或 geodesic 即可,当前没有额外配置项。

与带宽设置配合

要使用上述自适应拥塞控制,省略客户端的 bandwidth.up/down 即可。 服务端也可以设置:

ignoreClientBandwidth: true

相关选项如下:

配置项 默认值 作用
bandwidth.up / bandwidth.down 未设置 指定本端上传 / 下载带宽,如 20 mbps;具体协商行为沿用 Hysteria2
bandwidth.disableLossCompensation false 关闭 Brutal 的丢包补偿,仅在使用 Brutal 时生效
ignoreClientBandwidth false 仅服务端;忽略客户端带宽请求,使用配置的自适应拥塞控制

明确带宽协商成功的发送方向仍优先使用 Brutal。brutal 不是 congestion.type 的可选值。

混淆配置

两端的混淆类型和混淆密码需要一致。混淆密码与前面用于登录的 auth 是两项独立设置。

部署要求、成本和验证范围统一见混淆说明。新增整形模式为实验功能,按需启用。

obfs.type 说明
plain 或省略 obfs 不加额外混淆,连接仍使用 QUIC / TLS
salamander Salamander 数据报混淆
gecko Salamander 混淆,加上握手阶段的分片与填充
blink 认证封装、动态填充和可选用户态分片
presto 单密码派生包长、转移、前导、分片和突发语法
trident 单密码编译 64 指令 ISA,将认证密文编码为字节码并自动分片
carakan 密码编译逆向 tANS 字节谱,自定义目标熵,自动分片与纠删修复
servo 密码派生容量,跨数据报装箱,每条数据报最多两个认证容器
tasman 短块纠删、有限载波与约2×预算,tiny例外独立计数
mariner 密码编译的非线性字节关系、交织与最多两片封装

Mariner

obfs:
  type: mariner
  mariner:
    password: "REPLACE-WITH-AT-LEAST-32-RANDOM-BYTES"

只需同一随机密码,图、非线性双射表与密度自动编译。内层最大1200B,外层UDP payload 最大1232B;没有cover、额外等待或FEC。格式、成本和验证结果见 Mariner。

Tasman

obfs:
  type: tasman
  tasman:
    password: "REPLACE-WITH-AT-LEAST-32-RANDOM-BYTES"

两端同密码;内层1200B、外层UDP payload≤1232B,跨报文装箱并按预算发送有限修复。 配置、tiny例外、异步错误与保守QUIC预留的边界见 Tasman。

Servo

obfs:
  type: servo
  servo:
    password: "REPLACE-WITH-AT-LEAST-32-RANDOM-BYTES"

两端使用相同混淆密码。Servo 不主动填充或发送 cover,使用有限异步队列聚合不同 QUIC 数据报。内层最大 1200B,外层 UDP payload 最大 1232B;迟到/失败消息由 QUIC 自行恢复。配置、异步错误和验证边界见 Servo。

Carakan

在两端配置相同密码和目标熵:

obfs:
  type: carakan
  carakan:
    password: "REPLACE-WITH-AT-LEAST-32-RANDOM-BYTES"
    targetEntropy: 4.0
配置项 默认 / 范围
obfs.carakan.password 必填,32..1024 字节,建议至少 32 个随机字节生成的密码
obfs.carakan.targetEntropy 省略为 4.00 bits/byte;支持 1.00..7.50,步长 0.01;两端必须一致

Carakan 将认证密文输入逆向 tANS 状态机,输出密码派生的低熵字节谱。目标熵用于 控制整形分布,短包实测值会受有限状态和边界影响;它是可逆整形,不是压缩。 H 越低通常开销越大:符号层理想膨胀约 8/H,还需计入每片 52 字节认证封装及修复冗余。

握手和数据统一自动分片:内层最大 1200 字节,外层 UDP payload 最大 1232 字节。 1200 字节报文分为 2..13 个数据片,加 1..4 个认证修复片;收到足够合法片即可恢复缺片。 当前仅提供带纠删修复的线格式 v3,旧开发构建需双端同时更新。

配置、开销表和验证结果见 Carakan。

Trident

在两端配置相同的随机密码:

obfs:
  type: trident
  trident:
    password: "REPLACE-WITH-AT-LEAST-32-RANDOM-BYTES"

唯一配置项 obfs.trident.password 必填,长度 32..1024 字节,建议至少 32 个随机字节 生成的密码。密码编译出 64 个互不重复的操作码及各自的操作数长度、对齐规则; Byte-Split Packing 将认证加密后的载荷编码为可解析的自定义字节码,不执行指令。

内层 QUIC 最大 1200 字节,自动分成最多 4 个独立认证片;1200 字节报文(含握手) 必分成 3–4 片。外层 UDP payload 不超过 1232 字节,无需另配 MTU。 每片有 84 字节认证封装,另加字节码编码开销;分片增加流量及丢包敏感性。 协议及开销见 Trident。

Presto

在两端配置同一个随机密码:

obfs:
  type: presto
  presto:
    password: "REPLACE-WITH-AT-LEAST-32-RANDOM-BYTES"

Presto 只有一个配置项:obfs.presto.password,必填,长度 32..1024 字节, 建议使用至少 32 个随机字节生成的密码(可用 Base64 保存)。 程序从密码自动生成双向流量语法,每个会话再随机采样:

  • 包长的概率分布与相邻包长的转移关系。
  • 初次发送的前导形态、分片倾向,以及小突发之间的短暂间隔。
  • 同密码保持相对稳定的统计特征,但具体包序列不会固定;不同服务器请使用不同随机密码。

外层 UDP payload 最大 1232 字节,内层 QUIC 最大 1200 字节,自动分片与重组, 无需另配 MTU。填充最多为原始数据报长度的 1/3,另有每片 84 字节固定开销; 分片与发送间隔会增加流量和时延。协议及验证结果见 Presto。

Blink

在客户端、服务端都加入以下配置即可启用默认 Blink:

obfs:
  type: blink
  blink:
    password: "CHANGE-ME-TO-A-LONG-RANDOM-SECRET"

全部 Blink 参数位于 obfs.blink 下,未填写的选项使用默认值:

参数 默认值 范围 / 说明
password 必填 16..1024 字节;建议使用至少 32 字节的随机密码
maxPacketSize 1400 本端发送的 UDP payload 上限,512..1400 字节;不分片时至少为 1272
paddingMax 32 每个内层数据报最多追加的填充字节,0..128;0 关闭填充
junkPackets 客户端 2;服务端 0 首次发送前的干扰包数量,0..4;服务端只能省略或设为 0
fragmentation false 启用用户态分片与重组;开启时两端都设为 true
maxSessions 1024 本端接收会话数量上限,1..4096
maxReassemblyBytes 1048576(1 MiB) 分片重组数据缓存的总字节预算,1200..8388608;另有全局条目数量限制
verifyPacketsPerSecond 32768 每秒报文认证预算,64..262144;允许短时突发,来源分组速率为全局的 1/4

除 paddingMax、junkPackets 外,数字参数设为 0 表示使用默认值。 其他预算可由两端各自设置,不要求相同。

需要较小的外层包时,可在两端使用以下配置:

obfs:
  type: blink
  blink:
    password: "CHANGE-ME-TO-A-LONG-RANDOM-SECRET"
    maxPacketSize: 1232
    fragmentation: true
    paddingMax: 32
  • maxPacketSize 指 UDP payload,不是 IP MTU;分片会增加包数和额外开销。
  • 可选填充还受内层长度 10% 和外层剩余空间限制,固定封装开销另计。
  • 每个 IPv4 地址 / IPv6 /64 最多保留 8 个接收会话;高速线路可按服务器能力调整验签预算。
  • Blink 自动将内层 QUIC 限制为 1200 字节并关闭其 PMTU 探测,无需另外配置;当前不支持端口跳跃。

Gecko

两端使用相同密码:

obfs:
  type: gecko
  gecko:
    password: "CHANGE-ME-OBFS-PASSWORD"
    minPacketSize: 512
    maxPacketSize: 1200
obfs.gecko 参数 默认值 说明
password 必填 混淆密码,至少 4 字节
minPacketSize 512 握手分片的最小目标长度,大于 0 且不超过 maxPacketSize
maxPacketSize 1200 握手分片的最大目标长度,不超过 2048 字节;不是所有数据报的硬上限

Salamander

obfs:
  type: salamander
  salamander:
    password: "CHANGE-ME-OBFS-PASSWORD"

obfs.salamander.password 必填,至少 4 字节,两端一致。

分享链接

支持 hysteria2:// 和 hy2://。使用客户端配置生成链接或二维码:

./oh-my-hysteria-linux-amd64 share -c client.yaml
./oh-my-hysteria-linux-amd64 share -c client.yaml --qr

Blink 链接使用以下查询参数:

参数 对应配置
obfs=blink obfs.type
obfs-password obfs.blink.password
blink-max-packet-size maxPacketSize
blink-fragmentation=1 fragmentation: true
blink-padding-max paddingMax
blink-junk-packets junkPackets

使用 Blink 的两端都需要支持 Blink。分享链接包含连接凭证;拥塞控制和本地资源配额仍由各端配置选择。

Presto 分享链接使用 obfs=presto 和 obfs-password,没有其他形态参数。 Trident 分享链接使用 obfs=trident 和 obfs-password,同样只有密码参数。 Carakan 使用 obfs=carakan、obfs-password 和可选 carakan-target-entropy;省略熵参数时为 4.00。 Servo、Tasman、Mariner 分别使用 obfs=servo|tasman|mariner 和 obfs-password。

配置文件与日志

使用 -c 指定配置最直接。未指定时,依次查找当前目录、$HOME/.oh-my-hysteria/、 /etc/oh-my-hysteria/ 中的 config.yaml / config.yml,也支持 JSON 配置。

命令行选项 默认值 用途
-c / --config 自动查找 配置文件路径
-l / --log-level info debug / info / warn / error
-f / --log-format console console / json
环境变量 用途
OH_MY_HYSTERIA_LOG_LEVEL 日志级别
OH_MY_HYSTERIA_LOG_FORMAT 日志格式
OH_MY_HYSTERIA_ACME_DIR ACME 证书存储目录;默认 acme,配置中的 acme.dir 优先

上述三个变量兼容对应的 HYSTERIA_* 旧名称,OH_MY_HYSTERIA_* 优先。 更新程序请从本项目 Releases 下载;程序不会自动向上游检查更新。

实验性拥塞控制诊断开关

设置为 1 时向 stderr 输出相应控制器的模型快照,默认关闭:

环境变量 控制器
OH_MY_HYSTERIA_BBR3_DEBUG BBRv3
OH_MY_HYSTERIA_COPA_DEBUG COPA
OH_MY_HYSTERIA_GEODESIC_DEBUG Geodesic

源码构建与容器

工作区使用Go 1.26.10工具链;Go会按go.work自动选择。该补丁系列包含Windows异步 抢占崩溃修复,Windows构建不要使用1.26.0/1.26.1。

本机与交叉编译

使用 Go 1.26.10 和 Python 3.11+。在完整源码根目录运行,保留其中的 third_party/ 目录:

python hyperbole.py build -r

产物位于 build/,默认构建本机平台。构建脚本支持以下环境变量:

环境变量 默认值 用途
OH_MY_HYSTERIA_PLATFORMS 本机平台 逗号分隔的目标平台,如 windows/amd64,linux/amd64,linux/arm64
OH_MY_HYSTERIA_VERSION VERSION 文件中的版本 覆盖构建版本
OH_MY_HYSTERIA_COMMIT 当前 Git 提交 覆盖构建提交信息

例如在 PowerShell 中构建 Linux 两种架构:

$env:OH_MY_HYSTERIA_PLATFORMS = "linux/amd64,linux/arm64"
python hyperbole.py build -r

Docker

先在源码目录构建镜像:

docker build -t oh-my-hysteria:1.2.0 .

再在存放 server.yaml、server.crt、server.key 的配置目录启动:

docker run -d --name oh-my-hysteria \
  -p 443:443/udp \
  -v "$PWD:/etc/oh-my-hysteria:ro" \
  oh-my-hysteria:1.2.0 server -c /etc/oh-my-hysteria/server.yaml

 

贡献代码:运行测试

python -m unittest discover -s tests
uv sync --locked
uv run python hyperbole.py test
go test ./third_party/quic-go ./third_party/quic-go/internal/... ./third_party/quic-go/http3

许可与致谢

项目原创新增内容采用 MIT-0。继承的 Hysteria2 / quic-go 代码保留 MIT, COPA 适配保留 TQUIC Apache-2.0,Geodesic 适配保留 KCC 的 BSD 选项及 UCP MIT。 完整声明见 第三方许可;分发二进制时请一并保留随附许可文件。

感谢 Hysteria2、quic-go 及相关算法与工具项目的开发者。

  • Maintainer:zjl88858
  • Co-Developer:GPT-6.1 Sol(OpenAI)
未经允许不得转载:网站源码、软件资源与技术教程分享 - 今夕资源网 » oh-my-hysteria基于 Hysteria 2 的增强版虫洞工具。v1.2.0 提供更多拥塞控制选择和可选 UDP 混淆
扫码在手机上阅读本页
赞(0)

评论抢沙发

评论前必须登录!