Hysteria2一键安装脚本:官方脚本、老王工具箱、f佬和233boy

Hysteria2 是基于 QUIC 的代理协议,在高丢包高延迟的网络环境下表现比 TCP 系协议稳定,3x-ui 面板内置了 Hysteria2 支持,可以直接在面板里配置,具体方法参考3x-ui配置Hysteria2节点教程。如果不想用面板,也可以用一键脚本直接在服务器上安装独立的 Hysteria2。

开始之前需要一台 VPS:Hysteria2 的看家本领是 Brutal 拥塞控制——丢包不降速,在抖动大、丢包高的网络上优势最明显。换句话说,线路越差,Hysteria2 的提升越大,它最适合的是廉价 VPS(如 Akile),而不是顶级线路。DMIT 这类 CN2 GIA 当然也能跑得很稳(本站实测用的就是它家机器),但在这种线路上,Hysteria2 相比普通协议的提升就没那么大了。

赶时间:先跑这几条命令

不管你搜的是 Hysteria2 一键安装脚本、搭建脚本还是安装脚本,要做的都是同一件事。只想最快得到一个节点,走官方路线一共三步。先装程序:

1
bash <(curl -fsSL https://get.hy2.sh/)

这个脚本只装程序,接着编辑 /etc/hysteria/config.yaml,写好监听端口、证书和认证密码(最小配置怎么写看这篇),然后启动并确认服务在跑:

1
2
systemctl enable --now hysteria-server.service
systemctl status hysteria-server.service

最后放行 UDP 端口(ufw allow 端口号/udp;服务商有安全组的,还要去控制台加一条 UDP 入站规则)。只装一个自用节点,到这里就结束了;想要菜单式搭建脚本、一次装多协议或者订阅的,往下看对比。

先说结论:该选哪个脚本

先说依据:下面的内容来自我读这几个脚本的源码和 README,没有在机器上逐个实际运行;脚本会更新,菜单编号和细节以你运行时屏幕上显示的为准。

脚本 装完能直接用吗 要域名吗 证书 维护状态(2026-10-22 核对) 适合谁
官方 get.hy2.sh 不能,只装程序和示例配置,要手写 config.yaml 取决于你自己怎么配证书 自己配置 持续更新,当前最新版 v2.13.0 想自己掌控配置、不想用第三方脚本
老王 Hysteria2.sh 能,装完直接输出链接 不要 脚本生成自签证书 在维护,工具箱仓库 2026-06 更新 只想快速要一个 Hysteria2 节点
f佬 Sing-box 全家桶 能,多协议一起装 不要(README 写明所有协议均不需要域名) 我没核对 最活跃,2026-10 仍在频繁更新 想一次装多个协议,并要订阅链接
233boy sing-box 能,一条命令添加 不要 sing-box 生成的自签证书 在维护,仓库 2026-06 更新 想用命令随时增删改查多个配置
Misaka hysteria.sh 能,交互菜单安装 不要(默认必应自签证书) 必应自签证书(默认),可选 ACME 或自备 已停更,仓库停在 2024-04 已在用的人;新装不优先推荐
mack-a vasma 八合一 能,多协议菜单选装 要(用域名证书) 脚本为域名自动申请 最活跃,2026-10 仍在更新 有域名,想一次装多协议加订阅

简单说:最快要一个节点选老王,要多协议加订阅选 f佬,有域名、要八合一全家桶选 vasma(mack-a),要方便管理多个配置选 233boy,想要菜单式管理和卸载选 Misaka(但它已停更,见该节说明),想自己掌控就用官方脚本。

第三方脚本一般需要 root 运行,并且会从网上下载再执行别的脚本,跑之前最好先看一眼内容;不放心的话,用官方脚本加手写最小配置最稳。

官方安装脚本

最稳妥的是官方文档给的脚本,不依赖第三方。2026-10-22 核对时官方最新版为 v2.13.0(2026-10-05 发布),这个脚本默认就装最新版:

1
bash <(curl -fsSL https://get.hy2.sh/)

需要注意:这个脚本只负责安装程序并生成示例配置,装完服务还起不来,必须手动编辑 /etc/hysteria/config.yaml,写入监听端口、证书和认证密码(最小配置怎么写看这篇),然后再启动:

1
systemctl enable --now hysteria-server.service

改完配置后用 systemctl restart hysteria-server.service 重启,出问题时看日志:

1
journalctl --no-pager -e -u hysteria-server.service

默认情况下服务以 hysteria 这个普通用户运行,如果证书文件权限读不了,可以改成 root 运行:HYSTERIA_USER=root bash <(curl -fsSL https://get.hy2.sh/)。卸载用 bash <(curl -fsSL https://get.hy2.sh/) --remove,指定版本在命令后面加 --version 版本号。升级、备份配置等注意事项看Hysteria2升级和卸载。

老王工具箱(eooce):最快出节点

老王工具箱是一个综合脚本,Hysteria2 只是里面的一项。README 给的运行命令是:

1
bash <(curl -fsSL ssh_tool.eooce.com)

也可以用下载文件的方式:

1
wget -qO ssh_tool.sh https://raw.githubusercontent.com/eooce/ssh_tool/main/ssh_tool.sh && chmod +x ssh_tool.sh && ./ssh_tool.sh

进去之后按我读到的菜单:主菜单选 12. 节点搭建合集,再选 9. 老王Hysteria2一键脚本,然后选 1. 安装Hysteria2。这个子菜单里还有 2 卸载和 3 更换端口。安装时会问端口,直接回车就用随机端口,脚本会先检查这个 UDP 端口有没有被占用。

菜单里实际执行的就是下面这条,所以也可以跳过菜单直接跑(Alpine 系统走的是另一个脚本):

1
HY2_PORT=你的端口 bash -c "$(curl -L https://raw.githubusercontent.com/eooce/scripts/master/Hysteria2.sh)"

不写 HY2_PORT 的话,脚本会在 2000-65000 之间随机选一个端口;密码是随机生成的 UUID。

按源码,这个脚本依次做了这些事:

  1. 要求用 root 运行,脚本里判断的系统有 Debian、Ubuntu、CentOS、Oracle、RHEL、Fedora、Rocky、AlmaLinux、Alpine,其他系统直接退出;
  2. 安装 openssl、unzip、wget、curl、sudo;
  3. 调用官方脚本 get.hy2.sh 安装 Hysteria2;
  4. 用 openssl 生成一张自签证书(CN 是 bing.com,有效期 36500 天);
  5. 写入 /etc/hysteria/config.yaml:监听你选的端口、密码认证、开启 fastOpen,并把伪装(masquerade)指向 https://bing.com;
  6. 启动 hysteria-server.service 并设为开机自启;
  7. 输出 V2rayN/NekoBox 用的 hysteria2:// 链接,以及 Surge 和 Clash 的配置片段。

所以它本质上是"官方脚本加一份预设配置",装出来的服务名、配置路径和官方脚本一致,后面的验证和排错可以直接按官方脚本的来。维护方面(2026-10-22 核对):工具箱仓库 2026 年 6 月还有更新;Hysteria2.sh 因为是调用官方脚本安装,装到的 Hysteria2 版本始终随官方最新。

有两点要知道:脚本没有放行防火墙,UDP 端口要自己放行(见后面);它输出的链接带 insecure=1,因为用的是自签证书。

f佬(fscarmen)的 Sing-box 全家桶:多协议加订阅

仓库在 GitHub,作者主页在 GitLab。首次运行:

1
bash <(wget -qO- https://raw.githubusercontent.com/fscarmen/sing-box/main/sing-box.sh)

之后再进入管理界面只需要输入 sb。按 README 的说明:

  • 可以单选、多选或全选协议,包括 Reality、Hysteria2、TUIC v5、Trojan、AnyTLS 等,所有协议均不需要域名;
  • 节点信息会输出到 V2rayN、Clash Verge、小火箭、sing-box 等客户端,订阅会按客户端自动适配;
  • 有无交互的快速安装模式,运行参数里 -l 是"使用中文快速安装";
  • 针对 Hysteria2,README 的更新记录里提到:支持端口跳跃(装完后可以用 sb -d 开关和修改范围)、可以自定义上下行带宽、有 Realm 模式(给没有公网入口的机器用)。

维护方面(2026-10-22 核对):仓库当天仍在提交,是这几个脚本里更新最勤的一个。

我只读了 README,没有读 sing-box.sh 里 Hysteria2 的安装细节,所以它用的证书怎么生成、默认配置长什么样,这里不下结论。端口跳跃的官方做法可以看Hysteria2端口跳跃怎么配,Realm 看Hysteria2 Realms是什么。

233boy 的 sing-box 脚本:一条命令管理多个配置

仓库在 GitHub。安装命令和完整用法以作者的文档页为准。装好之后管理命令就是 sing-box,README 里的帮助显示常用的有:

命令 作用
sing-box add [协议] 添加配置,README 列出可以一键添加 Hysteria2、TUIC、Reality、Trojan、AnyTLS 等
sing-box info [名字]、url [名字]、qr [名字] 查看配置、导出链接、二维码
sing-box port / passwd 修改端口、密码
sing-box del [名字] 删除配置
sing-box restart、log 重启、查看日志

按我读到的源码,Hysteria2 这一项的做法是:

  • 证书用 sing-box 自己生成的自签证书,放在 /etc/sing-box/bin/tls.cer 和 tls.key,不依赖域名;
  • 密码不指定的话用随机 UUID;
  • 导出的链接形如 hysteria2://密码@地址:端口?alpn=h3&insecure=1&allowInsecure=1&pinSHA256=证书指纹,除了允许不安全连接,还带了证书的 SHA-256 指纹,支持的客户端可以用它固定证书。

它的服务名、配置路径都是 sing-box 的(配置在 /etc/sing-box/ 下),和官方脚本的 hysteria-server.service 不同。维护方面(2026-10-22 核对):仓库最近一次更新在 2026 年 6 月。

Misaka(Misaka-blog):交互菜单,自带卸载选项

仓库在 GitHub(作者 MisakaNo の 小破站,fork 自 chika0801 的版本)。Hysteria 2 的安装命令是:

1
wget -N --no-check-certificate https://raw.githubusercontent.com/Misaka-blog/hysteria-install/main/hy2/hysteria.sh && bash hysteria.sh

先说维护状态(2026-10-22 核对):这个仓库自 2024 年 4 月起没有再更新过。有一点还好:它安装时仍会调用官方 get.hy2.sh 拿最新版程序,装到的版本不会旧;但菜单脚本本身和它写出的配置模板停在 2024 年,官方这两年加的东西没人跟进。新装的话优先选上面几个还在维护的,这个更适合已经在用的人。

跑起来是一个交互菜单:1 安装、2 卸载、3 查看配置、4 修改配置(改端口、改密码、改证书类型、改伪装网站)。证书有三个选项:1 必应自签证书(默认)、2 用 ACME 申请域名证书、3 自备证书路径。装完输出 hysteria2:// 链接(带 insecure=1,备注名是 Misaka-Hysteria2)。

跟老王脚本的区别:老王是"官方脚本加预设配置",一次跑完;Misaka 是独立菜单脚本,装完还能回来改配置、卸载也有专门选项(菜单 2 会彻底卸载)。证书默认都是自签,客户端同样要允许不安全连接。

mack-a 的 v2ray-agent(vasma):八合一全家桶

仓库在 GitHub,2.2 万星,是这批脚本里名气最大的一个(2026-10-22 核对,仓库最近更新在 2026-10-20)。它不是 Hysteria2 专用脚本,而是 Xray、sing-box 双核心的八合一脚本,Hysteria2 是其中一项。安装命令:

1
wget -P /root -N --no-check-certificate "https://raw.githubusercontent.com/mack-a/v2ray-agent/master/install.sh" && chmod 700 /root/install.sh && /root/install.sh

装完输入 vasma 回到管理菜单,主菜单里有专门的 Hysteria 管理项;安装时可以只选 Hysteria2,也可以和其他协议任意组合。

按我读到的 install.sh 源码,它装 Hysteria2 的做法和 f 佬、233boy 一样走 sing-box 核心(生成的是 sing-box 的 hysteria2 入站配置),上下行带宽取安装时填的数值。和老王、233boy 最大的区别在证书:它用的是域名证书,TLS 配置里写的是你某个域名的证书文件,脚本负责自动申请和续订。所以用它装 Hysteria2 需要先备好一个域名;想要免域名自签的别选它,有域名、又想一次装齐多协议加订阅的,它是这一类里最稳的选择。

维护方面(2026-10-22 核对):仍在频繁更新,当前脚本版本 v3.5.26。我只读了 README 和 install.sh 里 Hysteria2 相关的部分,没有实际运行,菜单编号以运行时屏幕显示为准。

自签证书和 insecure:连接时客户端要怎么设

老王脚本和 233boy 脚本装出来的 Hysteria2 用的是自签证书,所以客户端导入的链接里都有 insecure=1。意思是客户端要允许不安全的证书(有的客户端叫"跳过证书验证")才能连上;如果你手动填配置,要记得打开这个选项。链接各参数的含义和手动填写方法见Hysteria2客户端怎么导入连接。

装完连不上时,先查 UDP 端口有没有放行,再看Hysteria2报错timeout: no recent network activity怎么办;连上了但很慢,看Hysteria2速度慢怎么办。

第三方脚本的服务名、配置路径可能和官方脚本不同,装完以脚本输出的提示为准。

安装完之后验证 Hysteria2 是否正常运行,最直接的方式是把节点导入客户端测试连接速度,速度正常说明运行没有问题。官方脚本安装的话也可以检查服务状态:

1
systemctl status hysteria-server

显示 active (running) 说明服务在跑;用的是第三方脚本的话,服务名以脚本提示为准。

Hysteria2 走的是 UDP 协议,防火墙需要单独放行 UDP 端口,不是只开 TCP 就够了:

1
ufw allow 你的端口号/udp

如果服务商有安全组(比如甲骨文、AWS),同样需要在控制台手动加 UDP 入站规则,光在系统防火墙放行不够。连不上的时候这是最常见的原因。

独立脚本安装的 Hysteria2 和通过 3x-ui 面板配置的 Hysteria2 在使用上没有本质区别,区别在于管理方式——独立脚本直接在服务器上管理,3x-ui 面板提供图形界面,多节点多用户的情况下面板更方便管理,参考3x-ui多用户管理。

用 Docker 部署的做法见Hysteria2 Docker 部署。

想先了解协议原理和 1 代、2 代的区别,看Hysteria2是什么协议。