家宽没有公网 IP 怎么自建 Hysteria2?Hysteria2 Realm 会合打洞实操
不用公网 IP、不用路由器端口转发,让家里的机器也能当 Hysteria2 节点。
想用家里的宽带自建 Hysteria2 节点,最大的拦路虎往往不是技术,而是没有公网 IP:运营商给的是内网地址(CGNAT),或者路由器后面套了好几层 NAT,外面的设备根本连不进来。Hysteria 新增的 Realm 模式,用”会合服务 + UDP 打洞”的方式绕开了这个限制。这篇文章按”判断条件、原理、配置、自建会合服务、排错”的顺序,带你把它跑通。
一、先判断:你到底有没有公网 IP
- 登录家里路由器的管理页,找到 WAN 口(外网口)获得的 IP 地址。
- 在任意一台联网设备上,用”查询本机公网 IP”的网站查看对外显示的 IP。
- 两者一致,说明你有公网 IP(可能是动态的);两者不一致,或者 WAN 口地址落在
100.64.0.0/10、10.x、192.168.x这些私有或共享地址段,就说明处于运营商 NAT(CGNAT)之后,外部无法直接访问。
有公网 IP 的话,直接开端口转发、用普通 Hysteria2 即可,官方和不少脚本也说明”有公网入口时不建议使用 Realm”。只有在无法开放入站端口时,Realm 才有价值。
二、Realm 的原理:四步握手
Realm 是 Hysteria 的点对点模式。可以把它理解为”介绍人”机制:
- 服务端登记:服务端向”会合服务”(rendezvous)登记一个名字(realm),并告知自己通过 STUN 发现的 UDP 地址。
- 客户端请求:客户端用同一个 realm 地址向会合服务发起请求,会合服务把服务端的地址发给客户端,同时把客户端的地址推送给服务端。
- 同时打洞:双方同时向对方发送 UDP 包,在各自的 NAT 上打开通路。
- 直连握手:通路打开后,正常的 Hysteria QUIC 握手在直连通道上进行,包含 TLS 校验和密码认证。
会合服务只负责”介绍”,不转发任何流量;打洞成功之后,它就不再参与。真正的数据是你的客户端与家里机器之间的直连。
三、准备清单
- 服务端:家里一台能 24 小时开机的机器(NAS、小主机、树莓派等),能出站访问 UDP 和会合服务。
- 客户端:你的手机或电脑,同样需要能出站发 UDP。
- 会合服务:可以先用官方的公共会合点
realm.hy2.io,也可以自己在一台有公网 IP 的 VPS 上自建(第五节)。 - 版本:Realm 功能较新,据发布记录,Hysteria 2.9.0 与 sing-box 1.14 系列起提供。请确认两端版本都支持。
- 不需要域名,也不需要在路由器上做端口转发。
四、配置实操
第 1 步:生成证书。客户端没有域名可供校验,官方推荐用自签证书加 pinSHA256 固定指纹。在服务端执行 hysteria cert,它会输出服务端和客户端各自需要的 tls 配置块(客户端那块包含 insecure: true 和 pinSHA256)。
第 2 步:编写服务端配置。关键只有一处:把 listen 改成 realm 地址,其余的 auth、tls、obfs 等字段和普通 Hysteria2 一样:
listen: realm://public@realm.hy2.io/<你的 realm 名称>
tls:
cert: server.crt
key: server.key
# 仅 v2.9.0 且使用 hysteria cert 生成的证书时需要
sniGuard: disable
auth:
type: password
password: <你的强密码>
obfs:
type: salamander
salamander:
password: <混淆密码>第 3 步:编写客户端配置。server 填同一个 realm 地址,auth 填 Hysteria 密码(它不等同于 realm 令牌):
server: realm://public@realm.hy2.io/<你的 realm 名称>
auth: <你的强密码>
obfs:
type: salamander
salamander:
password: <混淆密码>
tls:
insecure: true
pinSHA256: <hysteria cert 输出的指纹>
socks5:
listen: 127.0.0.1:1080第 4 步:先启动服务端,再启动客户端。第一次建议开启调试日志,方便确认打洞过程:
HYSTERIA_LOG_LEVEL=debug ./hysteria server -c server.yaml HYSTERIA_LOG_LEVEL=debug ./hysteria client -c client.yaml
realm 地址格式说明:realm://<令牌>@<会合服务地址>[:端口]/<realm 名称>。
realm://通过 HTTPS(默认 443)访问会合服务,推荐使用;realm+http://走明文 HTTP,仅限开发测试。- realm 名称需要在服务端与客户端完全一致。
- 可选参数
stun=主机:端口用来指定 STUN 服务器(可重复);lport=1-65535可固定本地 UDP 源端口,方便在防火墙上做放行。
五、自建会合服务:更可控的选择
公共会合点 realm.hy2.io 是免费的”尽力而为”服务,可能宕机、改限额,甚至被封锁;而且任何人都能在上面登记 realm。想长期使用,建议在一台有公网 IP 的小 VPS 上自建,项目是开源的:hysteria-realm-server。
它需要 Go 来编译,运行时必须提供共享令牌 HYSTERIA_REALM_TOKEN,常用参数如下:
| 变量 | 默认值 | 作用 |
|---|---|---|
HYSTERIA_REALM_TOKEN | 必填 | 共享令牌,客户端和服务端都要知道 |
HYSTERIA_REALM_LISTEN | :8443 | 监听地址 |
HYSTERIA_REALM_CERT / KEY | 未设置 | TLS 证书和私钥;不设置则走明文 HTTP |
HYSTERIA_REALM_MAX_REALMS_PER_IP | 4 | 单个 IP 可登记的 realm 数 |
HYSTERIA_REALM_TRUSTED_PROXY_HEADER | 未设置 | 放在反向代理后时,用来读取真实客户端 IP |
HYSTERIA_REALM_TOKEN=<你的令牌> \ HYSTERIA_REALM_LISTEN=:8443 \ HYSTERIA_REALM_CERT=/path/to/cert.pem \ HYSTERIA_REALM_KEY=/path/to/key.pem \ ./hysteria-realm-server
自建之后,realm 地址就变成 realm://<令牌>@<你的域名>:8443/<realm 名称>。注意:
- 状态全部保存在内存里,会合服务重启后所有 realm 都会消失,需要服务端重新登记。
- 一个共享令牌覆盖所有 realm,更适合自己或可信的小圈子使用。
- 只有放在会设置或清除该请求头的反向代理后面,才启用
TRUSTED_PROXY_HEADER,否则客户端可以伪造 IP 绕过单 IP 限制。
六、NAT 类型决定成败
UDP 打洞的成功率取决于两端的 NAT 类型。根据官方文档:
| 结果 | 典型组合 |
|---|---|
| 通常可靠 | 公网 IP 或完全锥形 NAT,可与任何类型配对;受限/端口受限 NAT 彼此之间也可以 |
| 有时可行 | 端口可预测的对称型 NAT,与受限/端口受限或同类配对,取决于能否猜中对方下一个端口 |
| 通常失败 | 端口随机的对称型 NAT,与除公网 IP、完全锥形之外的任何类型配对 |
如果 Realm 一直连不上,最可能的原因就是某一端是对称型 NAT。这是 UDP 打洞本身的性质,而不是 Hysteria 的缺陷,这时只能换成有公网 IP 的服务端。另外,只配置一个 STUN 服务器会让端口预测失效,请保留默认的多个 STUN,或自行配置多个。
七、安全要点
- 两层认证:realm 令牌只管”能不能访问会合服务”,Hysteria 密码才管”能不能用代理”,两者要分开设置。
- realm 名称要长且随机:知道或猜到名称的人可以探测你服务端的 IP(但没有密码用不了代理)。名称限制为 6 到 64 个字符,以字母或数字开头,只含字母、数字、
-、_;不要用能暗示你身份的名字。 - 不要连不认识的 realm:公共会合点上任何人都可以建 realm,恶意的 realm 可能记录日志甚至做中间人,对待它要像对待陌生的 VPN 服务商一样。
- 开启 obfs:Realm 模式使用随机 UDP 端口,而不是 443,不标准的 HTTP/3 流量本身就可能成为识别信号,在意这点的话建议启用
obfs。 - 默认 STUN 属于第三方公益服务:长期使用建议自行配置
realm.stunServers。
八、常见问题
Hysteria2 一定需要域名吗?
不一定。Realm 场景下可以用自签证书加 pinSHA256;如果想用正规 CA 证书,需要用 DNS-01 方式申请(HTTP-01 等方式需要公网 IP),并在客户端设置 tls.sni。
Hysteria2 能套 Cloudflare CDN 吗?
基本不行。CDN 代理的是 HTTP 类流量,而 Hysteria2 是基于 QUIC 的自有协议,使用 UDP 直连。想隐藏源站,请参考我之前写的 XHTTP + CDN 方案,两者思路不同。
Realm 和端口跳跃能一起用吗?
官方 Realm 文档没有展开这一点。有一键脚本在更新记录中明确说明二者互斥,安装时会有确认提示,建议以你所用脚本的说明为准。
v2ray 系客户端和 Windows 客户端怎么选?
官方的 Hysteria 客户端是命令行程序;图形界面可以用支持 Hysteria2 的客户端,比如 v2rayN、Clash Verge Rev、sing-box 系客户端。有脚本的更新记录显示,Realm 配置已支持导出给 Clash/Mihomo、sing-box 和 v2rayN,但是否可用取决于客户端版本,使用前请确认。
速度会怎么样?
瓶颈通常是家里宽带的上行带宽:别人通过你的节点下载内容,走的是你家的上传速度。上行只有 20 到 50 Mbps 的话,节点速度大致也就在这个量级。
九、排错清单
- 两端都打开
HYSTERIA_LOG_LEVEL=debug,保存完整日志。 - 核对 realm 名称、令牌、Hysteria 密码是否在两端完全一致,并检查 obfs 密码。
- 确认两端的防火墙允许出站 UDP,以及访问会合服务的 TCP 443(或你自建的端口)。
- 检查版本,v2.9.0 使用
hysteria cert的证书时,需要服务端加sniGuard: disable。 - 保留多个 STUN 服务器,必要时用
lport固定源端口,并在路由器或防火墙上放行。 - 仍然失败,就怀疑 NAT 类型:试试把客户端换到另一个网络(比如手机热点)再连一次。
十、小结
Realm 把”无公网 IP 就没法自建”这个限制,变成了一道可以通过打洞解决的题:会合服务只做介绍,数据直连,不需要端口转发,也不一定需要域名。但它依赖 NAT 类型和版本,公共会合点也没有任何保证,所以更稳妥的做法是:自建会合服务、长随机 realm 名称、开启 obfs,并准备一个有公网 IP 的备用方案。
声明:本文仅为技术科普,不构成使用建议。各地对相关技术的法律规定不同,请遵守所在地法律法规。Realm 为较新的功能,参数与行为可能随版本变化,请以官方文档为准;文中配置中的 <…> 为占位符,请替换为你自己的值。


