Minecraft Java 与 Bedrock 互通:Geyser 和 Floodgate 配置指南
Java 服务器运行 Geyser 转换 Bedrock 协议、运行 Floodgate 处理 Bedrock 登录后,Java 和 Bedrock 玩家就能在同一个世界里一起玩。

在 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 不需要任何配置:
- 开启 Bedrock 跨平台联机。 打开服务器设置,打开开关。Paper, Purpur, Pufferfish, Leaf, and Folia 和 Fabric, NeoForge, and Quilt 都支持。
- 重启服务器。 Geyser 和 Floodgate 会在这次启动时安装。游戏已经更新到更新版本的 Java 玩家也能加入,NeoForge 除外。
- 分享你的地址。 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 下载页下载这两个,然后:
- 安装 Geyser 和 Floodgate。 在 Paper 或 Spigot 上,把
Geyser-Spigot.jar和Floodgate-Spigot.jar放进plugins/。8 在 Fabric 或 NeoForge 上,把 Geyser 构建和 Floodgate 模组放进mods/;Fabric 还需要 Fabric API。9 - 启动一次服务器。 这会在
plugins/Geyser-Spigot/、config/Geyser-Fabric/或config/Geyser-NeoForge/中生成 Geyser 的config.yml。7 Geyser 会自动找到 Floodgate。10 - 检查 Geyser 的传输方式。 在
bedrock:下,transport的值是nethernet,这是从构建 1273 起的默认值,如下所示。Bedrock 26.60 及更新版本只能这样连接;从构建 1280 起,Geyser 会自动把旧的raknet值改成nethernet。1112 - 编辑
server.properties。 设置enforce-secure-profile=false,否则 Bedrock 玩家能加入但无法聊天,13 并保持online-mode=true。14 - 为 TCP 和 UDP 开放 19132 端口。 在路由器上同时转发两者,或在 Docker 中发布
-p 19132:19132 -p 19132:19132/udp。它不能和 Java 服务器使用同一个端口。15 - 重启并查看控制台。 出现
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。2426Geyser-ViaProxy
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 使用吗?
哪些插件和 Floodgate 冲突?
10.28B 以下的 DynamicBungeeAuth、FastLogin、ExploitFixer、JPremium、LibHatesMods、ProtocolSupport、ProtocolSupportBungee 和 SayNoToMcLeaks,因为 Floodgate 改变了玩家的登录方式。使用 TCPShield 时,除非你用的是它的付费方案,否则需要关闭 only-allow-proxy-connections。35
Footnotes
minecraft.wiki,Bedrock Edition 26.60:2026 年 10 月 27 日发布。 ↩
GeyserMC,Preparing Your Geyser Server for NetherNet,2026 年 10 月 8 日。 ↩ ↩
GeyserMC,Floodgate overview。 ↩
GeyserMC,Download:Geyser 2.12.1 的构建 1298(2026 年 11 月 9 日)已发布 BungeeCord、Fabric、NeoForge、Spigot、Standalone、Velocity 和 ViaProxy 版本。2026 年 11 月 10 日查阅。 ↩
GeyserMC,Supported versions。2026 年 10 月 20 日查阅。 ↩ ↩
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 日测量。 ↩
GeyserMC,Geyser setup guide。2026 年 10 月 20 日查阅。 ↩ ↩
GeyserMC,Floodgate on Paper and Spigot。 ↩
GeyserMC,Floodgate on modded servers。 ↩
GeyserMC,GeyserImpl.java,Geyser 源码。2026 年 10 月 20 日查阅。 ↩
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 日查阅。 ↩
GeyserMC,GeyserConfig.java,Geyser 源码,配置版本 10。
transport接受“nethernet”和“both”,默认 NETHERNET。2026 年 11 月 10 日查阅。 ↩GeyserMC,Geyser and Secure Chat。 ↩ ↩
minecraft.wiki,server.properties。 ↩
GeyserMC,Port forwarding。2026 年 10 月 20 日查阅。 ↩ ↩
GeyserMC,NetherNetServer.java,Geyser 源码。2026 年 10 月 20 日查阅。 ↩ ↩
GeyserMC,Remove RakNet-only transport (#6843):
raknet传输方式会被改为nethernet,并输出“WARNING! Raknet-only transport has now been REMOVED.” ↩Warden,Signaling infrastructure for Minecraft Bedrock。2026 年 10 月 20 日查阅。 ↩ ↩
GeyserMC,Provider.tsx,配置指南中各托管商说明的源码。2026 年 10 月 20 日查阅。 ↩ ↩
GeyserMC,Common Issues。2026 年 10 月 20 日查阅。 ↩ ↩ ↩ ↩
GeyserMC,Using Geyser with Consoles。 ↩
Mojang,NetherNet HTTP Signaling — Partner Onboarding Guide,2026 年 10 月 13 日生成的协议文档。 ↩
GeyserMC,HTTPS for NetherNet。2026 年 10 月 20 日查阅。 ↩ ↩
GeyserMC,Floodgate with Geyser Standalone。 ↩ ↩ ↩
GeyserMC,FabricFloodgateMod.java,Floodgate-Modded 源码;NeoForge 构建使用同一个文件夹。 ↩
GeyserMC,GeyserRemoteConfig.java,Geyser 源码。 ↩
GeyserMC,Floodgate with ViaProxy。 ↩
GeyserMC,GeyserViaProxyPlugin.java,Geyser 源码。 ↩
GeyserMC,Floodgate on proxy servers。 ↩
GeyserMC,Floodgate's default config.yml,Floodgate 源码。 ↩
GeyserMC,Floodgate features。 ↩
GeyserMC,Floodgate account linking。 ↩
GeyserMC,Current Limitations。2026 年 10 月 20 日查阅。 ↩
GeyserMC,Frequently Asked Questions。 ↩ ↩ ↩
GeyserMC,Fixing 'Unable to Connect to World'。 ↩
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 日查阅。 ↩