Geyser 出现 NetherNet 错误和 Terracotta 错误的解决方法
解决 Geyser 服务器上的 NetherNet 错误和 Terracotta 错误:查看 InitialConnection 代码,更新 Geyser,并检查 TCP 和 UDP 是否连通。

Pixly 从第一天起就支持 Bedrock 26.60。在设置中开启 Bedrock 跨平台联机并重启,Pixly 会自动安装并配置 Geyser 和 Floodgate。Java 和 Bedrock 玩家通过同一个地址加入。
NetherNet、Terracotta 和 Door 代码是什么意思
Bedrock 26.60 于 2026 年 10 月 27 日发布,只能通过 NetherNet 加入服务器。12 如果加入时出现 NetherNet 错误、Terracotta 或 Door,点击 显示详情 查看 InitialConnection 编号,再根据这个编号选择下面要做的检查。
Bedrock 26.60 加入服务器时,先进行信令(signaling),即通过 TCP 查找服务器的一次 Web 请求,之后的游戏数据走 UDP。3 GeyserMC 的支持说明为每个 InitialConnection 编号对应了原因:4
| 代码 | 详情 | 原因 | 解决方法 |
|---|---|---|---|
| Terracotta | InitialConnection-149 | Geyser 仍在用 RakNet,或 TCP 端口未开放 | 按下面四个步骤操作 |
| Door | InitialConnection-83 | UDP 被拦截,或服务器在 NAT 之后 | 开放 UDP,设置 advertise-addresses |
| NetherNet | InitialConnection-13 | NetherNet 和 RakNet 都没有响应 | 检查地址和两个端口 |
| NetherNet | InitialConnection-122 | 连接建立后又被关闭 | 更新 Geyser;仍然出现就查看断开连接日志 |
Terracotta 加 149 表示服务器不支持 NetherNet,或者它的信令无法访问。4 NetherNet 错误加 13 表示服务器两种方式都没有响应,所以先检查地址。出现 122 时,连接建立后又被关闭;1273 之前的 Geyser 构建在 Alpine Linux 上就会这样。5
解决 Geyser 服务器上的 Terracotta 错误
从 GeyserMC 下载页下载 Geyser,然后:
- 把 Geyser 更新到最新构建。 10 月 26 日的 1273 号构建是第一个支持 Bedrock 26.60 的版本,之后的构建又加入了 26.61 到 26.63。6
- 在 Geyser 配置中设置
transport: nethernet。 Paper 上配置位于plugins/Geyser-Spigot/,Fabric 或 NeoForge 上位于config/Geyser-Fabric/或config/Geyser-NeoForge/。7 1279 及之前的构建会保留旧的raknet设置;从 1280 号构建起,Geyser 会自动改掉它。唯一的其他取值是both,它同时接受 RakNet,但需要第二个 UDP 端口。8910 - 为 Geyser 端口同时开放 TCP 和 UDP。 使用 Docker 时,映射
-p 19132:19132 -p 19132:19132/udp。3 这个端口不能和 Java 服务器的端口相同。7 - 重启并测试 Bedrock 加入。 看到
Built-in signaling started on http://0.0.0.0:19132就说明 Geyser 的信令服务器已启动。8 从你的网络外部加入,确认玩家可以通过 TCP 和 UDP 连接。3
此时配置中的 bedrock: 部分如下:
bedrock:
port: 19132
transport: nethernet如果使用代理、Geyser Standalone,或者主机只开放 Java 端口,仅靠这些还不够;Geyser 和 Floodgate 设置指南介绍了这些情况。
解决 Door 错误:检查 UDP 和 NAT
Door 加 83 表示 TCP 信令成功,但 UDP 游戏流量没有通过。端口转发或 Docker 端口映射只配置了 TCP 就会出现这种情况,所以要在同一端口上加上 UDP。有位服主在 TCP 已经正常的情况下修好了 UDP,从而解决了 26.60 主机上的 Door 83。11
如果 Geyser 位于路由器或 NAT 之后,并且 Door 仍然出现,GeyserMC 建议把你的公网 IP 加到 bedrock.signaling.advertise-addresses 中并重启。4 把下面的内容合并到现有的 bedrock: 部分,并把 203.0.113.10 换成服务器的公网 IP:
bedrock:
signaling:
advertise-addresses:
- "203.0.113.10"26.60 之后的 Geyser 警告及含义
Geyser 会在启动时输出这些警告。1273 到 1279 号构建还会在管理员加入时发送关于 NetherNet 的消息。69
Geyser 控制台警告
WARNING! NetherNet support is NOT enabled.
1273 到 1279 号构建在配置仍为
raknet时输出。更新 Geyser,或设置transport: nethernet,然后重启。WARNING! Raknet-only transport has now been REMOVED.
1280 及更新的构建已将配置切换为 NetherNet。除了 UDP,还要为该端口开放 TCP。
NetherNet will not start! Could not load its WebRTC native library
1280 之前的构建会改为输出
NetherNet is not available on Linux (amd64)。这说明 Geyser 无法加载 NetherNet 库,已报告的原因有缺少libcrypto.so.3(Ubuntu 上安装libssl3)以及只读的/tmp。1211
1280 之前的构建还会在最后这条警告中建议把 transport 设为 raknet。不要照做:GeyserMC 表示 Bedrock 26.60 完全不再通过 RakNet 连接。2
实测:每种错误配置对加入有什么影响
我们在 2026 年 11 月 1 日用 Paper 26.3、Geyser 2.12.1 和一个基于开源 Bedrock 库 gophertunnel 的 NetherNet 测试客户端,测试了五种配置。8
| Geyser | 配置 | 加入结果 |
|---|---|---|
| 1279 | transport: raknet | 在 TCP 阶段立即被拒绝 |
| 1279 | transport: nethernet | 登录到达 Geyser |
| 1280 | transport: raknet | 已切换为 NetherNet;登录到达 Geyser |
| 1280 | 关闭 TCP 19132 | 在 TCP 阶段立即被拒绝 |
| 1280 | 丢弃 UDP 19132 | 信令正常;30 s 后超时 |
测试客户端会报告每次加入在哪一步停止。外部报告与正常配置一致:一位服主在 Windows 版 Bedrock 26.60 上通过 NetherNet 加入,13 groundsgg 的服务器镜像也通过 1280 号构建和开放 TCP 加 UDP 19132 恢复了 26.60 的加入。14
NetherNet 错误和 Terracotta 错误常见问题
作为玩家,怎么解决 NetherNet 错误?
确认服务器地址和你的游戏版本。把完整的 显示详情 界面、你的设备和游戏版本,以及其他玩家能否加入,发给服主。代码 13 和 122 表示连接失败或被关闭;服主可以根据这些详情检查服务器日志。
为什么 26.60 的局域网游戏里看不到我的 Geyser 服务器?
Bedrock 26.60 在 UDP 端口 7551 上查找局域网世界,而 Geyser 目前还不会响应这个端口;截至 2026 年 11 月 10 日,Geyser 问题追踪器上的相关报告仍未关闭。13 请改为在“服务器”标签页中通过地址添加服务器。
Footnotes
minecraft.wiki,Bedrock Edition 26.60:2026 年 10 月 27 日发布,协议 2225。2026 年 11 月 1 日查阅。 ↩
GeyserMC,Preparing Your Geyser Server for NetherNet,2026 年 10 月 8 日:“Bedrock clients will stop connecting over RakNet.” ↩ ↩
GeyserMC,Port forwarding:“players find the server over TCP (signaling), and play on it over UDP.” 2026 年 11 月 1 日查阅。 ↩ ↩ ↩
GeyserMC/Geyser issue #6807,已关闭:在 Alpine 镜像上,客户端 “shows
InitialConnection-122(NetherNetDataChannelClosed) after 30 s”;已在 1273 号构建中修复。 ↩GeyserMC,Geyser 2.12.1 构建列表:1273 号构建,2026 年 10 月 26 日,“Support 26.60”“Surgically remove 26.30”和“Add operator join message informing NetherNet deprecation, change bedrock.transport config default to nethernet”;1291 号构建,11 月 6 日,“Indicate Minecraft: Bedrock Edition 26.61 and 26.62 Support”;1298 号构建,11 月 9 日,“Indicate Minecraft: Bedrock Edition 26.63 Support”。2026 年 11 月 10 日查阅。 ↩ ↩ ↩
GeyserMC,Geyser 设置指南:“Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server.” 2026 年 11 月 1 日查阅。 ↩ ↩
Pixly 测试,2026 年 11 月 1 日:在 Docker 中运行 Paper 26.3 和 Geyser-Spigot 2.12.1 的 1279 与 1280 号构建,由同一网络中基于 gophertunnel 的 NetherNet 客户端加入;端口通过服务器容器内的防火墙规则关闭。1279 号构建生成的新配置为
transport: nethernet,但保留了已有的transport: raknet,并记录WARNING! NetherNet support is NOT enabled.↩ ↩ ↩GeyserMC,Remove RakNet-only transport (#6843),1280 号构建,2026 年 10 月 31 日(UTC):把
raknet传输方式改为nethernet,移除启动和加入时的WARNING! NetherNet support is NOT enabled.消息,并把 Linux 消息换成 “NetherNet will not start! Could not load its WebRTC native library”。 ↩ ↩GeyserMC,GeyserConfig.java:“both”:“accepts NetherNet and RakNet. Each needs its own UDP port”。2026 年 11 月 10 日查阅。 ↩
spruyt-labs,run NetherNet transport for Bedrock 26.60 clients,2026 年 10 月 28 日关闭:“The first console test failed with
initialconnection 83. TCP signaling worked”,之后修好 UDP,“A console on Minecraft 26.60 reaches the server list and joins”;此前启动曾因 “/tmp/datachannel-java-...: Read-only file system” 失败。 ↩ ↩GeyserMC/Geyser issue #6852,“NETHERNET: Terracotta error”,2026 年 10 月 31 日:日志显示
libcrypto.so.3: cannot open shared object file,一位 Geyser 贡献者回复 “Installing libssl3 should resolve your issue.” ↩GeyserMC/Geyser issue #6853,2026 年 10 月 31 日,截至 11 月 10 日仍未关闭:在 Windows 版 Bedrock 26.60 和 Geyser 2.12.1-b1279 上,“Joining by address from the Servers tab works fine over NetherNet”,而客户端发往 UDP 7551 的局域网广播没有回应,因为 “Nothing listens on UDP 7551”。 ↩ ↩
groundsgg,fix(geyser): restore Bedrock 26.60 connections,2026 年 11 月 1 日合并:把 Geyser 固定为 2.12.1 的 1280 号构建,并开放 TCP 和 UDP 19132。 ↩
GeyserMC,Supported versions:“Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3.” 2026 年 11 月 10 日查阅。 ↩