Hysteria2 / AnyTLS 一键搭建教程:自建节点流程
自己动手搭 Hysteria2 — 装好 HY2、AnyTLS 和 Shadowsocks,逐项过一遍 UDP / TLS、防火墙、masquerade / 混淆、BBR / Reno / Brutal、bandwidth 的含义,以及慢了该怎么查。
- 发布
- 更新
- 核对
- 门槛
- 进阶
- 类别
- VPS 自建
最后更新于:2026-11-16
原名 / 别名:NekoBox
开源版还在持续出新版本,适合用 sing-box 和 Hysteria2 的人;项目方已说明 Google Play 上同名的那个是第三方控制的闭源版本。
原名 / 别名:SagerNet
项目仓库在 2024 年已归档、只能读不能改,新用户别再装它。
原名 / 别名:Hysteria2、HY2
文档和版本都还在更新,适合 UDP 能通、网络差、容易丢包的环境,不过别只靠它一种协议。
sing-box 里还带着它的官方入站,可以当 TCP 后备;支持它的客户端没有 Reality 多,所以先不给新手主推。
Hysteria2 是跑在 QUIC 上、能转 TCP / UDP 的一种代理。先确定两头的 UDP 是通的,再照官方对拥塞控制的说明去配,最后在条件相同的情况下试一试,看它合不合你的网络。
- 先看 UDP 通不通服务没监听、被防火墙挡,或者你这边网络不放行那个 UDP,HY2 就连不起来。
- 脚本不是官方的`everett7623/hy2` 要 root 权限;先把入口脚本读一遍,再找一台删了也不心疼的 VPS 试。
- 然后再调能连上以后,再去分清 Hysteria 的 BBR / Reno / Brutal、系统缓冲区和端口跳跃。
把监听状态、防火墙和连接日志记下来;协议叫什么不重要,能不能连到才重要。
先看适不适合 →眼下这个统一入口里有 HY2、AnyTLS、SS、VLESS Reality 和 EUserv HY2。
动手搭 →换了几个你能掌控的网络,UDP 还是一直不通,再拿 Reality 这类 TCP 方案来比。
去看 Reality 教程 →Hysteria2 是什么
主要特点
Hysteria2 是搭在 QUIC 上面的 TCP / UDP 代理。它靠 QUIC 传数据,可这不代表它的流量长得和普通网页的 HTTP/3 一样,也不代表性能是定死的。
官方配置里眼下要留意的:
- QUIC stream 与 datagram — 一条 QUIC 连接里同时转 TCP 和 UDP 请求。
- 三种拥塞控制 — 不用 Brutal 的时候,本地用
BBR(默认的)或者Reno;设置了bandwidth会决定那个方向用不用 Brutal。 - 带宽填得越大不等于越好 — Brutal 要靠你把线路能跑多少估准,填得比实际上限还高,就会堵、会抖,还会多耗流量。
- Fast Open 有利有弊 — 能省掉一个 RTT,可它会在还没确认目标连得上之前就先接下本地连接,并不是“重连不用等”的承诺。
挑的时候看哪些
| 要看的地方 | Hysteria2 本身 | 要你自己确认的 |
|---|---|---|
| 底下怎么传 | QUIC over UDP | 两头的 UDP、防火墙和你这边网络通不通 |
| 拥塞控制 | BBR、Reno 或者 Brutal | 版本、配置的方向和真实带宽对不对得上 |
| 快慢 | 由路径、CPU、NIC 以及缓冲区、流控窗口决定 | 同一个地址、同一时段,跟 TCP 方案比真去用的效果 |
| TLS / 域名 | TLS 验证要配对;官方教程多半用域名加受信任的证书 | 域名、证书、自签 pin、客户端的验证设置是否对得上 |
| 维护要花的功夫 | 服务端、客户端、防火墙、升级都得有人管 | 有没有退路,会不会升级、备份、看日志查问题 |
什么时候用 Hysteria2
可以把 Hysteria2 拿来比一比的情况:
- 服务端在监听,云安全组、主机防火墙和你本地网络也都放行了那个 UDP 端口。
- 你用的客户端写明支持 Hysteria2,还能看到原始的连接日志。
- 你能把地址、设备、时段固定住,去比真去用的效果、丢包、抖动、速度和 CPU 占用。
- 你肯留一条 TCP 后备,UDP 出问题时能退回去。
先别拿它当主力的情况:
- 那个 UDP 端口试了好多次、换了好几个你能掌控的网络,都连不上。
- 客户端不认现在的配置字段,或者你拿不到日志、也没有安全的退路。
- 配置低的机器上,CPU、NIC、内存带宽或者系统缓冲区已经卡住了。
- 你指望换个协议名、开 Gecko 混淆或者用 Realms,就能自己变得延迟更低、速度更快、没人认得出。
动手前要备好的
1. VPS 要什么样的
官方文档里没有一个对所有连接数、所有速度要求都适用的 VPS 最低配置。下单前先把这些记下来:
- CPU 是什么架构、能长时间跑多少,内存多大,NIC 和虚拟化有什么限制。
- 端口和 UDP 怎么规定、安全组、主机防火墙,以及有没有公网地址。
- 流量怎么算钱、带宽封顶多少、超了怎么办、多久一付、能不能退、快照和换 IP 有什么条件。
- 从你家网络到它、再到目标服务,去回程实际怎么走;机房名、线路名代替不了自己试。
可以考虑的 VPS:
| 服务商 | 入口 | 下单当天要看 |
|---|---|---|
| Vultr | 官方页面 | 地区、UDP / 端口规定、带宽、流量、付费周期、能否退款 |
| Hetzner | 官方页面 | 账号能不能开、地区、网络规定、带宽、流量、能否退款 |
| RackNerd | 官方页面 | 是哪个机房、给多少资源、UDP / 端口规定、续费价、能否退款 |
| DMIT | 官方页面 | 是哪款产品、去程回程实际怎么走、带宽、流量、续费价、能否退款 |
虚拟化是哪种: KVM 的内核和网络多半更独立些,不过 UDP 能不能用,光看 KVM / OpenVZ 这个标签说不准。下单前读一遍云服务商的条款,开机以后自己去试 UDP 端口、安全组和本地网络。
2. 准备域名
Hysteria2 本身不要求一定有公网域名,可这篇用的是公开受信任的 TLS 证书,所以最好备一个域名,拿来做这两件事:
- 申请 TLS 证书(让流量看起来像 HTTPS)
- 给客户端做 SNI 校验
去哪弄域名:
- 可以考虑的注册商:NameSilo / Cloudflare Registrar。买的那天看清首年价、续费价、能否转出、DNS 和账号资格。
- 别的域名来路(比如 eu.org)申请方式、归谁管、能不能签证书各有规定,先想清楚你能不能一直管着它的 DNS。
设置 DNS 解析:
- 域名到手后,打开它的管理后台
- 加一条 A 记录:
- 主机记录:
@(也可以用子域名,比如proxy) - 记录类型:
A - 记录值:填你 VPS 的 IP
- TTL:
600
- 主机记录:
看解析生效没有:
# 在本地电脑运行
nslookup 你的域名.com
# 应返回你的 VPS IP3. 登上 VPS
ssh root@你的VPS_IP4. 把系统升级一下
# Debian / Ubuntu
apt update && apt upgrade -y
# 安装必要工具
apt install -y curl wget sudo做法 1:用第三方脚本 everett7623/hy2 一键部署
只想快点搭出一个能导进客户端的节点,可以考虑 everett7623/hy2。它由 everett7623 维护,是要 root 权限的第三方脚本;照项目现在的说明,统一入口里有 5 种可选的搭法:
Hysteria 2
跑在 QUIC / UDP 上;先查 UDP 端口、防火墙、证书和客户端字段。
AnyTLS
用 sing-box 做的 TCP / TLS 入站;看客户端支不支持、证书和服务端版本。
VLESS Reality
用 sing-box 做的 TCP 方案;对一下 UUID、SNI、公钥、short ID 和 Vision flow。
Shadowsocks
有老式 AEAD 和 SS-2022 两种;用 SS-2022 的话,两头的系统时间都得准。
EUserv HY2
专给只有 IPv6 的 EUserv 机器用,另外处理 NAT64 DNS、WARP 和 IPv6 下载失败时的退路。
装统一入口
curl -fsSL https://raw.githubusercontent.com/everett7623/hy2/main/install.sh -o /tmp/hy2-install.sh
less /tmp/hy2-install.sh
bash /tmp/hy2-install.sh头一次跑完会装上一个快捷命令:
sb照这篇的 Hysteria2 步骤进菜单:
安装 / 重装- 选
Hysteria 2 - 装好以后选
查看节点信息或导出客户端配置 - 照你用的客户端导出
URI、Mihomo / Clash、Shadowrocket、Loon或者二维码
做法 2:官方 / 手动配置(进阶)
想每一项都自己说了算,可以用 Hysteria2 官方的二进制或脚本,然后自己写 /etc/hysteria/config.yaml。这样做适合已经弄懂 TLS、证书、UDP 防火墙和客户端 YAML 的人。装之前去 GitHub Releases 对一下该用的 app/v2 标签,旧的镜像和第三方网盘里的包别当成现在的版本。
curl -fsSL https://get.hy2.sh/ -o /tmp/hysteria-install.sh
less /tmp/hysteria-install.sh
bash /tmp/hysteria-install.sh
hysteria version官方文档给了两种弄证书的办法:tls 用你已经有的证书,acme 让服务端自己去申请;两样只能写一个。下面这个最精简的服务端示例用的是已有证书:
listen: :443
auth:
type: password
password: 你的强密码
tls:
cert: /etc/hysteria/cert.crt
key: /etc/hysteria/private.key
masquerade:
type: proxy
proxy:
url: https://www.bing.com
rewriteHost: true手动配的话,证书的申请和续期、systemd 服务、防火墙、客户端配置都得自己弄。新手先拿上面的脚本把它跑起来,回头再来弄懂这些字段。
listen 默认值是 :443。没有能从公网连到的地址时,官方另外给了 Realms URI 的写法,不过这篇讲的 VPS 主线不走那条。
客户端怎么配
Windows / macOS / Linux
Hysteria 官方二进制 / CLI: GitHub Releases
配置文件 (config.yaml):
server: 你的域名.com:443
auth: 你的强密码 # 与服务端 password 一致
# 默认先不写 bandwidth,当前官方客户端会使用非 Brutal 控制器(默认 BBR standard)
socks5:
listen: 127.0.0.1:1080 # SOCKS5 代理端口
http:
listen: 127.0.0.1:8080 # HTTP 代理端口只有你确定要用 Brutal、而且已经量出从客户端到服务器长时间能跑多少,才加上 bandwidth.up / bandwidth.down。填的数比线路实际能力高,就会堵、会不稳;服务端的 ignoreClientBandwidth 还可能让客户端那边的设置不起作用。
把客户端跑起来:
./hysteria -c config.yaml在浏览器里设代理:
- SOCKS5:
127.0.0.1:1080 - 或者 HTTP:
127.0.0.1:8080
iOS:Shadowrocket / Stash
Shadowrocket 能用 Hysteria2:
- 打开 Shadowrocket → 点右上角的「+」
- 类型挑「Hysteria2」
- 填这些:
- 地址:你的域名.com
- 端口:443
- 密码:你设的高强度密码
- 上传/下载带宽:先用客户端自带的默认值;弄明白填了会不会启用 Brutal、也量过实际能力,再来填
- 混淆:空着(服务端开了才填)
Stash 的配置(YAML):
proxies:
- name: "Hysteria2"
type: hysteria2
server: 你的域名.com
port: 443
password: 你的强密码
# 先不要写 up / down。这些字段在不少客户端里会进入 Brutal 选择流程Android:NekoBox
NekoBox(还在维护的选择):
- 下载 NekoBox
- 打开 → 点右上角「+」→「手动输入」
- 类型:Hysteria2
- 填好服务器地址、端口和密码;带宽那栏先用默认值,要调之前先弄懂它指的是什么
防火墙怎么设
VPS 上的防火墙
# UFW
ufw allow 你的端口/udp
ufw allow 80/tcp # 仅在使用 HTTP-01 申请或续期证书时需要
ufw reload
# iptables
iptables -I INPUT -p udp --dport 你的端口 -j ACCEPT
iptables -I INPUT -p tcp --dport 80 -j ACCEPT
iptables-save > /etc/iptables/rules.v4云服务商的安全组
登进云服务商的控制台,加一条规则:
- 协议:UDP
- 端口:你实际监听的那个端口
- 来源:填你能接受的范围,别想都不想就照抄对全网开放
让它跑得更顺
1. 先弄清 Hysteria 的拥塞控制
net.ipv4.tcp_congestion_control=bbr 只改 Linux 内核的 TCP 拥塞控制,并不会让 Hysteria2 用户态的 QUIC 也换成 BBR。Hysteria2 现在在不用 Brutal 的那个方向上,走的是自己本地的拥塞控制设置,默认值是 BBR standard,也能改成 Reno:
congestion:
type: bbr
bbrProfile: standard这项设置客户端和服务端各管各的,协议不会帮两边自动商量。先用默认值;只有问题能反复出现时,才在同一个地址、同一个时段、同样的 bandwidth 情况下,比一比 BBR profile 和 Reno。
2. 需要时再调系统缓冲区
官方讲性能的文档里,CPU、NIC、系统缓冲区、QUIC 流控窗口、进程调度都被列成可能卡住的地方。只有日志或大流量测试显示缓冲区不够用了才去调,而且改动放进单独的文件,方便改回去:
sudo tee /etc/sysctl.d/99-hysteria-buffer.conf > /dev/null <<'EOF'
net.core.rmem_max = 16777216
net.core.wmem_max = 16777216
EOF
sudo sysctl --system配置低的 VPS 还得盯着 CPU、内存和 NIC;缓冲区调大了,UDP 不通、路由走错、服务端限速这些问题照样在。
3. 带宽参数怎么调
bandwidth 不是随便填个“期望速度”的地方,它决定了用 Brutal 还是用别的控制器:
- 客户端哪个方向没写
bandwidth,那个方向就用本地的非 Brutal 控制器(默认是 BBR)。 - 在客户端写了
bandwidth,那个方向就会进入是否用 Brutal 的判断;填的数一定要是从客户端到服务器长时间真跑得到的能力。 - 服务端的
bandwidth是给每个客户端的上限,会跟客户端填的值比大小;自己一个人用的话,可以照官方建议先不写服务端的bandwidth和ignoreClientBandwidth。 - 数填得比线路能力高,会堵、会抖、会白耗;填低了就等于自己给自己限速。没有一个人人通用的
80%、90%或者固定的 Mbps 算法。 - Brutal 的 loss compensation 有时管用、有时反而更糟;跑得不稳时可以照现在的官方字段试试
disableLossCompensation,改之前和改之后都留个记录对比。
4. 端口不是用来调速度的
先用一个 UDP 端口跑出基准。只有在同一个网络、同一台服务器、同一份配置下,某个端口受限的情况一再出现,才去考虑后面讲的官方 port hopping;随手开一堆端口只会让防火墙口子变大,CPU、容量、路由或者填错的 bandwidth。
进阶设置
多个用户怎么管
Hysteria2 可以开多个用户,每人一个密码:
改服务端配置:
auth:
type: userpass
userpass:
user1: password1
user2: password2
user3: password3客户端这样写:
auth: user1:password1 # 格式:用户名:密码端口跳跃(Port Hopping)
官方现在的做法是让客户端在一串端口之间轮换;Linux 服务端可以开一个端口范围,再用 nftables / iptables 把这个范围里的流量都转到第一个端口。它只适合你已经看出“只有某些 UDP 端口被限”的情况,不是开了就提速,也不保证别人认不出。
服务端这样写:
listen: :20000-30000 # 监听端口范围客户端这样写:
server: 你的域名.com:20000-30000客户端会在这个范围里挑端口,按设定的间隔换一次。服务端要是 Linux,要有能用的 nftables / iptables,还要有改防火墙的权限;云安全组也只开你真正用到的那段端口。
Hysteria Realms
没有能从公网连进来的 UDP 时,官方允许把 listen 写成 Realms URI;sing-box 1.14 里也有 realm 这个字段。这样做照样要有 TLS、认证,以及两边一致的 Realms 标识,还得靠 STUN 和可选的端口映射。手上有公网 VPS 就还用普通监听,别把 Realms 当成默认搭法。
流量伪装(Obfuscation)
要是你的网络明显只拦 QUIC / HTTP/3、不拦全部 UDP,可以开混淆做一组对比。Salamander 会把数据包的样子打乱;Gecko 还在实验阶段,会把握手包再切碎。两头的密码要一样。打开以后,服务端看起来就不再像一台普通的 HTTP/3 服务器,masquerade 也就没用了。开了也不保证认不出、不保证更快。
服务端这样写:
obfs:
type: salamander
salamander:
password: 另一个强密码 # 混淆密码,与认证密码不同客户端这样写:
obfs:
type: salamander
salamander:
password: 另一个强密码 # 必须与服务端一致只有用了 Salamander 还是明显被认出来、而且你留好了能退回去的配置,再照现在的官方字段去试 Gecko 的 minPacketSize / maxPacketSize。
留意: 混淆会多吃 CPU,配置弱的 VPS 要小心开。
常见问题怎么查
客户端连接超时了怎么办?
按这个顺序查:
看服务端在不在跑:
bashsystemctl status hysteria-server看你选的 UDP 端口有没有在监听:
bashss -ulnp | grep 你的端口 # 应显示 hysteria 进程试一下 UDP 通不通: 在你自己电脑上执行:
bash# Linux/macOS nc -u -v 你的VPS_IP 443 # Windows(需安装 nmap) nmap -sU -p 443 你的VPS_IP看防火墙:
bashufw status iptables -L -n | grep 443看域名解析:
bashnslookup 你的域名.com # 应返回 VPS IP翻服务端日志:
bashjournalctl -u hysteria-server -n 50
证书申请不下来怎么办?
多半是这几种原因:
域名解析还没生效 → 等 DNS 生效(最长 24 小时)
80 端口被别的程序占了 → 找出是谁占的,先临时停掉:
bashss -tulnp | grep :80 # 如果是 nginx/apache systemctl stop nginx # 申请证书后再启动 systemctl start nginx被防火墙挡了 → 暂时放行 80 端口:
bashufw allow 80/tcpLet's Encrypt 次数限制 → 过一个小时再试
自己手动申请证书(后备办法):
# 安装 acme.sh
curl -fsSL https://get.acme.sh -o /tmp/acme-install.sh
less /tmp/acme-install.sh
sh /tmp/acme-install.sh
# 申请证书
~/.acme.sh/acme.sh --issue -d 你的域名.com --standalone
# 复制证书到 Hysteria 目录
mkdir -p /var/lib/hysteria
~/.acme.sh/acme.sh --install-cert -d 你的域名.com \
--cert-file /var/lib/hysteria/你的域名.com.crt \
--key-file /var/lib/hysteria/你的域名.com.key比不开代理还慢,怎么办?
可能的原因,照这个顺序处理:
- 记录测试地址与时间,同时保存 Hysteria 版本、客户端 / 服务端日志、拥塞控制和
bandwidth。 - 要是设置了
bandwidth,两头都要查:填太高会堵,填太低等于限速;必要时干脆删掉它,用默认的非 Brutal 控制器先跑个基准。 - 一样样看:你家的 Wi-Fi / 宽带、VPS 的 CPU / NIC / 系统缓冲区、云安全组,还有流量实际怎么走。
- 服务器和时段固定住,换几档 offered rate 去测 UDP 丢包 / 抖动,再跟真用 Hysteria 时的情况对比;iperf 一次测出 TCP / UDP 有差别,别直接算到运营商头上。
- 还是找不到原因,就用官方自带的 speed test(服务端要手动打开)或者换个 TCP 方案,一次只改一样来比。
Hysteria2 跟 Hysteria1 差在哪?
Hysteria2 把协议和配置方式都重新做了一遍,1.x 的功能大多留了下来;官方说得很清楚,两代协议互不相通。现在的文档和新搭的服务都以 Hysteria2 为准,换代时客户端和服务端一定要用同一代。
UDP 被运营商限速了怎么办?
怎么判断:
# 测试 TCP 速度
iperf3 -c 你的VPS_IP -p 5201
# 测试 UDP 速度
iperf3 -c 你的VPS_IP -u -b 100M -p 5201iperf 测 TCP 和测 UDP,跑法、拥塞控制、offered rate 都不一样,所以拿“UDP 小于 TCP 的 50%”来断定运营商限速是不对的。测 UDP 起码要记下设定的发送速率、实际跑出来的速度、丢包、抖动、方向、端口、测了多久、服务端忙不忙,再换个网络或换个时段重做一次。
处理办法:
- 先查两头的配置 — 服务有没有监听、云安全组、主机防火墙、客户端填的地址、UDP 实际丢多少包。
- 把 offered rate 调低再测 — 分清是线路容量不够、填错了
bandwidth,还是根本连不上。 - 换端口时只改这一样 — 某几个端口的差别能一再复现,才去考虑 port hopping。
- 拿 TCP 后备来比 — 换了好几个端口、好几个网络,UDP 还是一直不行,再用 VLESS Reality 这类 TCP 方案试试,看是不是更合你现在的环境。
安全方面
1. 隔段时间升级一次
# 更新 Hysteria2
curl -fsSL https://get.hy2.sh/ -o /tmp/hysteria-install.sh
less /tmp/hysteria-install.sh
bash /tmp/hysteria-install.sh
# 重启服务
systemctl restart hysteria-server2. 限制连接数
免得被人乱用:
# 添加到配置文件
trafficStats:
listen: :9999 # 流量统计 API 端口(内网访问)
acl:
inline:
- reject(all, udp/443) # 禁止 UDP 443 回连(防止被用作反射攻击)3. 盯着流量
# 查看实时连接
ss -ulnp | grep hysteria
# 查看日志
tail -f /var/log/hysteria.log4. 备份配置
# 备份配置和证书
tar -czf hysteria-backup.tar.gz /etc/hysteria /var/lib/hysteria
# 恢复时解压即可
tar -xzf hysteria-backup.tar.gz -C /