家里宽带没有公网IP怎么自建Hysteria2?Hysteria2-Realm会合打洞实操

家宽没有公网 IP 怎么自建 Hysteria2?Hysteria2 Realm 会合打洞实操

不用公网 IP、不用路由器端口转发,让家里的机器也能当 Hysteria2 节点。

想用家里的宽带自建 Hysteria2 节点,最大的拦路虎往往不是技术,而是没有公网 IP:运营商给的是内网地址(CGNAT),或者路由器后面套了好几层 NAT,外面的设备根本连不进来。Hysteria 新增的 Realm 模式,用”会合服务 + UDP 打洞”的方式绕开了这个限制。这篇文章按”判断条件、原理、配置、自建会合服务、排错”的顺序,带你把它跑通。

一、先判断:你到底有没有公网 IP

  1. 登录家里路由器的管理页,找到 WAN 口(外网口)获得的 IP 地址。
  2. 在任意一台联网设备上,用”查询本机公网 IP”的网站查看对外显示的 IP。
  3. 两者一致,说明你有公网 IP(可能是动态的);两者不一致,或者 WAN 口地址落在 100.64.0.0/10、10.x、192.168.x 这些私有或共享地址段,就说明处于运营商 NAT(CGNAT)之后,外部无法直接访问。

有公网 IP 的话,直接开端口转发、用普通 Hysteria2 即可,官方和不少脚本也说明”有公网入口时不建议使用 Realm”。只有在无法开放入站端口时,Realm 才有价值。

二、Realm 的原理:四步握手

Realm 是 Hysteria 的点对点模式。可以把它理解为”介绍人”机制:

  1. 服务端登记:服务端向”会合服务”(rendezvous)登记一个名字(realm),并告知自己通过 STUN 发现的 UDP 地址。
  2. 客户端请求:客户端用同一个 realm 地址向会合服务发起请求,会合服务把服务端的地址发给客户端,同时把客户端的地址推送给服务端。
  3. 同时打洞:双方同时向对方发送 UDP 包,在各自的 NAT 上打开通路。
  4. 直连握手:通路打开后,正常的 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_IP4单个 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 的话,节点速度大致也就在这个量级。

九、排错清单

  1. 两端都打开 HYSTERIA_LOG_LEVEL=debug,保存完整日志。
  2. 核对 realm 名称、令牌、Hysteria 密码是否在两端完全一致,并检查 obfs 密码。
  3. 确认两端的防火墙允许出站 UDP,以及访问会合服务的 TCP 443(或你自建的端口)。
  4. 检查版本,v2.9.0 使用 hysteria cert 的证书时,需要服务端加 sniGuard: disable。
  5. 保留多个 STUN 服务器,必要时用 lport 固定源端口,并在路由器或防火墙上放行。
  6. 仍然失败,就怀疑 NAT 类型:试试把客户端换到另一个网络(比如手机热点)再连一次。

十、小结

Realm 把”无公网 IP 就没法自建”这个限制,变成了一道可以通过打洞解决的题:会合服务只做介绍,数据直连,不需要端口转发,也不一定需要域名。但它依赖 NAT 类型和版本,公共会合点也没有任何保证,所以更稳妥的做法是:自建会合服务、长随机 realm 名称、开启 obfs,并准备一个有公网 IP 的备用方案。

声明:本文仅为技术科普,不构成使用建议。各地对相关技术的法律规定不同,请遵守所在地法律法规。Realm 为较新的功能,参数与行为可能随版本变化,请以官方文档为准;文中配置中的 <…> 为占位符,请替换为你自己的值。

Leave a Comment

Your email address will not be published. Required fields are marked *