pixly.

Minecraft Java 与 Bedrock 互通:Geyser 和 Floodgate 配置指南

Java 服务器运行 Geyser 转换 Bedrock 协议、运行 Floodgate 处理 Bedrock 登录后,Java 和 Bedrock 玩家就能在同一个世界里一起玩。

AlekseiFounder
更新于 4 分钟阅读
一座石门立在长着斑驳苔藓的泥土平台上,几根粗管道从它发着橙光的门洞中垂直穿过。

在 Pixly 上开启 Bedrock 跨平台联机,只需一个开关和一次重启,之后 Java 和 Bedrock 玩家用同一个地址加入。在你自己的服务器上,则需要最新的 Geyser 版本、Floodgate,以及同时对 TCP 和 UDP 开放的 19132 端口,因为 2026 年 10 月 27 日发布的 Bedrock 26.60 只通过 NetherNet 连接。12

Pixly 上的 Bedrock 跨平台联机:一个开关加一次重启

Pixly 会安装 Geyser 和 Floodgate:Geyser 是让 Bedrock 玩家加入 Java 服务器的插件,Floodgate 让他们无需 Java 账号就能加入。3 不需要任何配置:

  1. 开启 Bedrock 跨平台联机。 打开服务器设置,打开开关。Paper, Purpur, Pufferfish, Leaf, and Folia 和 Fabric, NeoForge, and Quilt 都支持。
  2. 重启服务器。 Geyser 和 Floodgate 会在这次启动时安装。游戏已经更新到更新版本的 Java 玩家也能加入,NeoForge 除外。
  3. 分享你的地址。 Java 玩家在“多人游戏”里添加地址。手机、平板和 Windows 上的 Bedrock 玩家依次打开“开始游戏”“服务器”“添加服务器”,输入同一个地址,端口保持不变。

你的自定义域名对 Bedrock 玩家同样有效;Bedrock 玩家加入时,也会像 Java 玩家一样唤醒休眠中的服务器。所有服务器规格都包含跨平台联机,不额外收费;更多内容见 Java 与 Bedrock 跨平台联机服务器托管。

开始之前:服务器软件、版本和 Java 21

自己运行 Geyser,先做四项检查。

  • 服务器软件。 Geyser 在 Paper、Spigot 及其分支上是插件,在 Fabric 和 NeoForge 上是模组,在 Velocity 和 BungeeCord 上是代理插件。Vanilla 和 Forge 需要 Geyser Standalone,它作为独立程序在服务器旁边运行。4
  • Minecraft 版本。 Geyser 同一时间只支持一个 Java 版本,2026 年 10 月是 26.3。1.20.5 及以上的 Paper 和 Spigot 可以通过 ViaVersion 插件配合使用。Fabric 和 NeoForge 必须运行这个确切版本。5
  • Java 更新。 2026 年,Geyser 支持每个新的 Java 版本花了 24 到 44 天,6 所以在 Geyser 跟上之前,让服务器停留在 Geyser 支持的版本。5
  • Java 21 或更高版本。 Geyser 无法在更旧的版本上运行。7

在自己的服务器上配置 Geyser 和 Floodgate

从 GeyserMC 下载页下载这两个,然后:

  1. 安装 Geyser 和 Floodgate。 在 Paper 或 Spigot 上,把 Geyser-Spigot.jar 和 Floodgate-Spigot.jar 放进 plugins/。8 在 Fabric 或 NeoForge 上,把 Geyser 构建和 Floodgate 模组放进 mods/;Fabric 还需要 Fabric API。9
  2. 启动一次服务器。 这会在 plugins/Geyser-Spigot/、config/Geyser-Fabric/ 或 config/Geyser-NeoForge/ 中生成 Geyser 的 config.yml。7 Geyser 会自动找到 Floodgate。10
  3. 检查 Geyser 的传输方式。 在 bedrock: 下,transport 的值是 nethernet,这是从构建 1273 起的默认值,如下所示。Bedrock 26.60 及更新版本只能这样连接;从构建 1280 起,Geyser 会自动把旧的 raknet 值改成 nethernet。1112
  4. 编辑 server.properties。 设置 enforce-secure-profile=false,否则 Bedrock 玩家能加入但无法聊天,13 并保持 online-mode=true。14
  5. 为 TCP 和 UDP 开放 19132 端口。 在路由器上同时转发两者,或在 Docker 中发布 -p 19132:19132 -p 19132:19132/udp。它不能和 Java 服务器使用同一个端口。15
  6. 重启并查看控制台。 出现 Built-in signaling started on http:// 说明 Bedrock 玩家可以加入了。16 出现 WARNING! Raknet-only transport has now been REMOVED. 说明配置里写的是 raknet:Geyser 现在改用 NetherNet,所以要检查端口除了 UDP 是否也对 TCP 开放。17
bedrock:
  port: 19132
  transport: nethernet

没法开放 TCP 端口?Geyser 可以配合 Warden 使用

Warden 是 CubeCraft 背后的公司 Ziax 提供的免费服务,Bedrock 玩家的游戏会先经过它,再到达你的服务器。2 用了它,只需要 UDP 能到达服务器,15 玩家不会看到信任提示,你还可以使用 Warden 主机名或自己的域名。18 在 Geyser 配置里这样设置:

bedrock:
  transport: nethernet
  signaling:
    mode: nxs

如果托管商只给你 Java 端口,还要在 bedrock: 下加上 clone-remote-port: true。重启后,控制台会显示 Bedrock 玩家要用的地址和端口。19 Warden 不保证可用性,面向的是个人服务器。18

Bedrock 玩家如何加入:地址、端口、主机

在手机、平板和 Windows 上,玩家依次打开“开始游戏”“服务器”“添加服务器”。19 能否进入取决于三点:

  • 地址和端口分开填写。 在地址栏输入 play.example.com:19132 会提示“Invalid IP address!”20
  • SRV 记录无效。 Bedrock 会忽略在 Java 上隐藏端口的 DNS 记录,所以请使用 IP 地址,或带普通 A 记录的域名。20
  • 主机需要变通办法。 Xbox、PlayStation 和 Switch 玩家通过 DNS 服务 BedrockConnect,或 BedrockTogether 之类的局域网应用加入。21

按上面的配置,Bedrock 会在每位玩家首次加入时询问是否信任该服务器。22 要为通过域名加入的玩家去掉这个提示,可以给 Geyser 配一张证书,比如 Let's Encrypt 的免费证书:在 bedrock: 部分的 signaling.builtin.https 下设置 certificate 和 private-key,并在每次续期后运行 geyser reload。23

代理、Standalone 和 ViaProxy:复制 key.pem

Floodgate 会在 plugins/floodgate/ 或 config/floodgate/ 中生成 key.pem,这把密钥让 Bedrock 玩家跳过 Java 登录。2425 在以下配置中,你需要自己复制它:

Geyser Standalone

把 key.pem 复制到 Geyser 的文件夹,设置 auth-type: floodgate,并在 Geyser 配置的 java: 下填写 Java 服务器的 address 和 port。2426

Geyser-ViaProxy

把 key.pem 复制到 plugins/Geyser/,Floodgate 登录会自动开启。2728

Velocity 或 BungeeCord

只在代理上安装 Geyser 和 Floodgate,并在代理和服务器之间开启玩家转发(player forwarding)。在代理上关闭安全聊天:BungeeCord 设置 enforce_secure_profile: false,Velocity 设置 force-key-authentication = false。2913

Bedrock 玩家有哪些不同:名字、账号绑定、限制

Bedrock 玩家加入的是同一个世界,只是有几点不同。

  • 名字。 Floodgate 会在名字前加一个 .,并把空格换成下划线,所以 Steve Miner 会以 .Steve_Miner 的身份加入。30 要把这样的玩家加入白名单,用 fwhitelist add 加原始名字。31
  • 绑定账号。 同时拥有两个版本的玩家可以绑定账号:从两个版本分别加入 link.geysermc.org,在其中一个上运行 /linkaccount,在另一个上输入它的代码。玩家会保留 Java 账号的物品栏和进度。32
  • 缺少的功能。 Bedrock 没有可点击的聊天链接、发光效果、自定义附魔和自定义配方,主世界低于 -512 或高于 512 的部分也不会显示。Geyser 会安装 GeyserIntegratedPack,用来恢复盔甲架姿势、副手动画等内容。33
  • 资源包。 Java 资源包不能直接在 Bedrock 上使用。GeyserMC 的 Thunder 还处于早期测试阶段,可以转换简单的资源包;转换结果放进 Geyser 的 packs 文件夹。34
  • 模组。 服务端模组可以工作,但模组添加的方块、物品和生物,Bedrock 玩家看不到。35

Geyser 的已知问题及解决方法

Bedrock 26.60 之后,过时的 Geyser 构建、旧的 RakNet 设置,或被拦截的 TCP/UDP 流量,都可能导致玩家无法加入。检查步骤见如何修复 NetherNet、Terracotta 和 Door 错误。

Bedrock 玩家无法连接时,Geyser 会在控制台输出以下信息。16

Geyser 控制台信息

Built-in signaling cannot use port … because the Java server already uses it

给 Geyser 一个专用端口,并对 TCP 和 UDP 开放。

… is a loopback address

把 bedrock: 下的 address 设为 0.0.0.0,否则所有玩家都会超时。

Built-in signaling could not start

紧随其后的错误会说明原因。如果有其他程序占用了该 TCP 端口,请停止它或换一个端口。

其他问题会在游戏里出现。

“Unable to Connect to World”

端口或 Geyser 配置有误。36 检查 19132 端口是否对 TCP 和 UDP 开放(使用 Warden 时只需 UDP)、是否与 Java 服务器端口不同,以及 bedrock: 下的 address 是否为 0.0.0.0。

能看到服务器,但加入时超时

UDP 19132 被路由器或防火墙拦截了,或者这台机器上的其他程序占用了它。23

“Cannot reply to EncryptionRequestPacket without profile and access token”

Floodgate 配置有误:以插件方式安装时把 key.pem 复制到了 Geyser 的文件夹里(那里不该放),或者 Java 服务器是正版验证模式(online),而 Geyser 设置为离线(offline)。20 删除多余的密钥,并让两边设置一致。

加入时提示“Outdated client!”或“Outdated server!”

Geyser 和服务器运行的 Minecraft 版本不同。Outdated client! 表示要更新 Geyser;Outdated server! 表示要更新服务器或添加 ViaVersion。20

Geyser 能配合 playit.gg 或 ngrok 使用吗?

ngrok 不行,因为它不支持 UDP。35 playit.gg 有专为 Geyser 准备的 Minecraft Bedrock (NetherNet) 隧道,目前仍标为实验性;请选它,而不是较旧的 Minecraft Bedrock 类型。37

哪些插件和 Floodgate 冲突?

10.28B 以下的 DynamicBungeeAuth、FastLogin、ExploitFixer、JPremium、LibHatesMods、ProtocolSupport、ProtocolSupportBungee 和 SayNoToMcLeaks,因为 Floodgate 改变了玩家的登录方式。使用 TCPShield 时,除非你用的是它的付费方案,否则需要关闭 only-allow-proxy-connections。35

Footnotes

  1. minecraft.wiki,Bedrock Edition 26.60:2026 年 10 月 27 日发布。 ↩

  2. GeyserMC,Preparing Your Geyser Server for NetherNet,2026 年 10 月 8 日。 ↩ ↩

  3. GeyserMC,Floodgate overview。 ↩

  4. GeyserMC,Download:Geyser 2.12.1 的构建 1298(2026 年 11 月 9 日)已发布 BungeeCord、Fabric、NeoForge、Spigot、Standalone、Velocity 和 ViaProxy 版本。2026 年 11 月 10 日查阅。 ↩

  5. GeyserMC,Supported versions。2026 年 10 月 20 日查阅。 ↩ ↩

  6. Modrinth,Geyser versions:支持每个版本的首个构建分别是 5 月 7 日的 2.10.0-b1138、7 月 10 日的 2.11.0-b1186 和 2026 年 10 月 14 日的 2.12.0-b1255,对照 Mojang 版本清单中的发布日期。2026 年 10 月 20 日测量。 ↩

  7. GeyserMC,Geyser setup guide。2026 年 10 月 20 日查阅。 ↩ ↩

  8. GeyserMC,Floodgate on Paper and Spigot。 ↩

  9. GeyserMC,Floodgate on modded servers。 ↩

  10. GeyserMC,GeyserImpl.java,Geyser 源码。2026 年 10 月 20 日查阅。 ↩

  11. GeyserMC,Geyser 2.12.1 build list:构建 1273(2026 年 10 月 26 日)“change bedrock.transport config default to nethernet”;构建 1280(2026 年 10 月 31 日)“Remove RakNet-only transport”。2026 年 11 月 10 日查阅。 ↩

  12. GeyserMC,GeyserConfig.java,Geyser 源码,配置版本 10。transport 接受“nethernet”和“both”,默认 NETHERNET。2026 年 11 月 10 日查阅。 ↩

  13. GeyserMC,Geyser and Secure Chat。 ↩ ↩

  14. minecraft.wiki,server.properties。 ↩

  15. GeyserMC,Port forwarding。2026 年 10 月 20 日查阅。 ↩ ↩

  16. GeyserMC,NetherNetServer.java,Geyser 源码。2026 年 10 月 20 日查阅。 ↩ ↩

  17. GeyserMC,Remove RakNet-only transport (#6843):raknet 传输方式会被改为 nethernet,并输出“WARNING! Raknet-only transport has now been REMOVED.” ↩

  18. Warden,Signaling infrastructure for Minecraft Bedrock。2026 年 10 月 20 日查阅。 ↩ ↩

  19. GeyserMC,Provider.tsx,配置指南中各托管商说明的源码。2026 年 10 月 20 日查阅。 ↩ ↩

  20. GeyserMC,Common Issues。2026 年 10 月 20 日查阅。 ↩ ↩ ↩ ↩

  21. GeyserMC,Using Geyser with Consoles。 ↩

  22. Mojang,NetherNet HTTP Signaling — Partner Onboarding Guide,2026 年 10 月 13 日生成的协议文档。 ↩

  23. GeyserMC,HTTPS for NetherNet。2026 年 10 月 20 日查阅。 ↩ ↩

  24. GeyserMC,Floodgate with Geyser Standalone。 ↩ ↩ ↩

  25. GeyserMC,FabricFloodgateMod.java,Floodgate-Modded 源码;NeoForge 构建使用同一个文件夹。 ↩

  26. GeyserMC,GeyserRemoteConfig.java,Geyser 源码。 ↩

  27. GeyserMC,Floodgate with ViaProxy。 ↩

  28. GeyserMC,GeyserViaProxyPlugin.java,Geyser 源码。 ↩

  29. GeyserMC,Floodgate on proxy servers。 ↩

  30. GeyserMC,Floodgate's default config.yml,Floodgate 源码。 ↩

  31. GeyserMC,Floodgate features。 ↩

  32. GeyserMC,Floodgate account linking。 ↩

  33. GeyserMC,Current Limitations。2026 年 10 月 20 日查阅。 ↩

  34. GeyserMC,Thunder。 ↩

  35. GeyserMC,Frequently Asked Questions。 ↩ ↩ ↩

  36. GeyserMC,Fixing 'Unable to Connect to World'。 ↩

  37. playit.gg,Setting up Geyser with playit:“Make sure you pick Minecraft Bedrock (NetherNet), not Minecraft Bedrock”和“Tick the box to confirm NetherNet is experimental.”2026 年 11 月 10 日查阅。 ↩

AlekseiFounder at Pixly

撰写 Minecraft 服务器运营相关内容——实测数据、可复现的解决方法,以及托管页面不会告诉你的取舍。

继续阅读