如果你最近在翻 Minecraft 相关的内容大概率会看到“互通服务器”“BE”“JE”“eaglecraft 网页版”这几个词被放在一起。先说一个比较容易绕晕的点BE 是基岩版JE 是 Java 版eaglecraft 网页版本质上是一个跑在浏览器里的 Java 版客户端而不是基岩版。所谓“互通”不是让某一种客户端变成另一种而是让 Java 版电脑玩家、基岩版手机玩家、网页版玩家通过各自不同的协议和端口进入同一个服务器世界。这篇文章会按实际落地顺序拆一遍先讲清楚各端角色再讲搭建互通服务器需要准备什么然后从零搭一个能同时让基岩版手机和 Java 版网页客户端进入的服务器最后补上常见问题和排查链路。适合正在选服务端、刚接触 Geyser 插件体系、或者想在低配置机器上做个人测试服的读者。1. 先搞清楚“BE、JE、网页版”在互通里到底承担什么角色1.1 BE、JE、Eaglercraft 网页版分别是哪一端很多人在搜索的时候会以为“互通 手机基岩版直接连 Java 版服务器”这个理解对了一半。真正的执行方式是服务器仍然是 Java 版服务端基岩版玩家通过一个翻译层接入这个翻译层把基岩版的协议转换成 Java 版能识别的协议。常见做法是使用 Geyser 系列插件。所以你需要先分清三类客户端客户端类别底层协议常见入口在互通服中的角色Java 版客户端Java Edition 协议官方启动器、第三方启动器、Eaglercraft 网页版直接连接 Java 版端口默认 25565基岩版客户端Bedrock Edition 协议手机、Win10/11、主机上的基岩版通过 Geyser 连接基岩版端口默认 19132Eaglercraft 网页版Java Edition 协议浏览器本质是 Java 版客户端连接 25565这个区分很重要。如果你把 Eaglercraft 网页版当成“手机端”看待配置方向就会错。它更接近“一个不需要安装启动器的 Java 版客户端”适合用来快速验证服务器能不能连通。1.2 互通服务器的核心Geyser 与 Floodgate 各管什么Geyser 是整套互通方案里最核心的一环。它作为服务端插件运行监听一个 UDP 端口基岩版客户端连接该端口后Geyser 会把基岩版流量翻译成 Java 版流量转发给主服务器。Floodgate 则是配合 Geyser 使用的身份映射插件。它解决的是“基岩版玩家没有 Java 版账号怎么通过正版验证或者怎么生成稳定 UUID”的问题。如果服务器是离线模式很多人会暂时不装 Floodgate也能跑起来。但这样玩家身份不可控谁都能用任意名字进入管理上会有很大隐患。我的建议是只要服务器不是只给一个人玩的纯测试环境就把 Floodgate 装上。这里要特别说明Geyser 和 Floodgate 不是同一个东西。Geyser 负责协议翻译Floodgate 负责玩家标识与登录桥接。只装 Geyser不装 Floodgate也能实现部分互通但账号逻辑会很别扭。1.3 网易版为什么默认不能直接加入这种互通服标题里提到了网易这也是搜索量很高的一个词。网易版是 Mojang 在中国大陆地区由网易代理发行的版本它有自己的账号体系、联机大厅、服务器列表和网络通道和“国际版 Java 版 / 基岩版”的服务器直连方式不一样。网易版客户端通常不能像国际基岩版那样手动填写第三方服务器 IP 和端口。如果你想做互通测试尽量使用国际版 Java 客户端或国际版基岩版客户端。如果你手头只有网易版但又想验证互通服务器最常见的做法是先安装一个 Java 版客户端在测试服上跑通流程然后再处理手机基岩版。不要一开始就把时间花在研究网易版怎么添加第三方地址上成功率和收益都低。2. 搭建互通服务器前先把环境和条件过一遍2.1 硬件与系统低配置机器能不能带起来如果是个人学习、好友联机、小范围测试低配置机器完全能跑。Java 版服务器本身吃内存和 CPU内存不足会直接导致卡顿或崩溃。Geyser 会额外占一部分内存因为需要维护协议转换和玩家数据但通常情况下不会比主服务端更吃配置。我自己一般这样估算纯测试环境2G 内存够用5 到 10 人左右的小服4G 内存比较稳妥。如果还要加地图预生成、多世界、插件商店、登录插件内存需求要更高。系统方面Windows、Linux、macOS 都可以跑。生产环境我更推荐 Linux 服务器尤其是云服务器因为它可以长期稳定运行资源占用也比桌面系统干净。如果你只是在本地 Windows 电脑上做测试把 Java 和防火墙处理好就行。注意不要一上来就开启很大的视距和一堆预生成地图。低配置机器能跑测试不代表能跑重负荷场景。先让服务器稳定运行再逐步加压。2.2 Java、服务端核心和插件版本怎么选Java 版服务端核心决定了整个服务器的基础。原版服务端可以跑但想加 Geyser、Floodgate 这类插件建议使用支持 Bukkit/Spigot/Paper API 的插件服务端核心。Paper 是我个人用得比较多的选择它兼容大量插件性能也比原版服务端好一些。Purpur 也可以但除非你有特定功能需求否则从 Paper 开始更稳妥。下载时要注意Java 版本要匹配服务端核心要求常见服务端核心需要 Java 17 或 Java 21。Geyser 插件有不同的平台版本比如 Paper/Spigot 用 Geyser-SpigotBungeeCord 用 Geyser-BungeeCordVelocity 用 Geyser-Velocity。Floodgate 也要选择对应平台版本不能随意混搭。很多新手在插件版本上翻车。下载插件之前先看它支持的服务端核心和 Minecraft 版本再决定要不要装。插件不兼容通常不会在启动时立刻报错而是会表现为“基岩版连不上”“Floodgate 无效”“玩家加入后立刻掉线”。2.3 服务器端口、防火墙和安全组要提前留好互通服务器至少要涉及两个端口Java 版端口默认 25565TCP 协议。基岩版端口默认 19132UDP 协议。如果你在本地测试用 localhost 或 127.0.0.1 连接不涉及公网端口开放。但要让手机或别人从外部连接就必须在防火墙和云服务器安全组里放行这两个端口。Linux 上使用 UFW 防火墙时可以这样开放sudo ufw allow 25565/tcp sudo ufw allow 19132/udp sudo ufw status云服务器还需要在控制台的安全组规则里放行。注意 TCP 和 UDP 是分开的基岩版端口如果只放了 TCP手机依然连不上。这一条是排查时最容易忽略的地方。监听端口的确认也很重要。服务器启动后可以用命令检查ss -ulpn | grep 19132 ss -tlnp | grep 25565如果 19132 没有监听说明 Geyser 没有正常启动或配置被改坏了。先看这个再考虑其他问题。3. 从零搭建先让 Java 版和 BE 版进入同一个世界3.1 初始化一个 Paper 服务端第一步是准备服务端核心。假设你已经下载了 Paper 核心放到一个独立目录里。首次启动前先编辑 eula.txt把eulafalse改成eulatrue表示同意 EULA。然后在目录下执行java -Xmx2G -jar paper.jar --nogui这里-Xmx2G是分配给服务器的最大内存以自己的机器和场景为准。首次启动会自动生成配置文件和默认世界。生成完成后关闭服务器编辑server.properties。如果只是测试互通可以把服务器设为离线模式server-port25565 online-modefalse motd互通测试服online-modefalse意味着玩家不需要通过官方正版验证适合局域网小范围测试。但这个模式下玩家身份不受官方账号体系约束不要以为是安全的。正式对外开服时要结合插件做身份管理。3.2 安装 Geyser-Spigot 和 Floodgate 并确认启动日志把下载好的 Geyser-Spigot 插件和 Floodgate 插件放进plugins目录重新启动服务器。第一次启动后Geyser 会在plugins/Geyser-Spigot下生成 config.ymlFloodgate 也会生成自己的配置目录。查看启动日志时重点确认以下几行信息Geyser 是否成功加载。Geyser 监听在哪个 IP 和端口。Floodgate 是否成功挂钩 Geyser。如果看到 Geyser 提示监听 0.0.0.0:19132说明基岩版入口已经准备好。如果端口被占用或者插件因为依赖缺失没能加载会直接体现在日志里。Geyser 的 config.yml 里比较关键的是bedrock.port。默认 19132一般不用改。如果改了手机添加服务器时也要填写相同端口。3.3 用手机基岩版添加服务器并验证互通在手机上打开基岩版进入服务器列表选择“添加服务器”或“添加外部服务器”。服务器地址填写你服务器的 IP 或域名端口填写 19132。基岩版默认端口就是 19132所以有些客户端里端口可以留空但为了稳妥最好手动填上。点击加入后如果能看到服务器世界说明 Geyser 的协议翻译工作正常。这时候你在电脑上再开一个 Java 版客户端连接 25565两边进入同一个世界后互相能看到对方互通就算跑通了。我第一次测试时遇到过一个问题手机能进但电脑端玩家看不到手机玩家。后来发现是两边进的是同一个世界但一个在出生点一个因为加入位置不同被隔开了。先传送到同一个坐标再观察比来回乱跑更有效。3.4 用 Eaglercraft 网页版连接 Java 端口完成交叉验证Eaglercraft 网页版在这里的角色是“网页版 Java 客户端”。你只需要在浏览器里打开对应网页客户端选择连接服务器填入 Java 版地址和端口 25565。如果服务器是离线模式通常可以直接进入。如果服务器开启了正版验证模式网页版客户端没有正常的正版登录通道就会卡在登录阶段。这是预期行为不代表互通配置坏了。所以在测试时我一般建议先给 Eaglercraft 网页版准备一个离线模式的测试服或者确认服务器允许离线模式进入。网页版适合做“快速连接验证”但不建议作为主力游戏客户端因为它受浏览器性能限制渲染、输入延迟、资源包支持都和官方客户端有明显差距。关于 Eaglercraft 这类第三方网页客户端有一点要特别提醒它不是 Mojang 官方产品使用范围和授权边界需要你自己确认。我只建议在你自己的测试服务器、你有权限管理的环境里使用不要在不清楚来源的网页客户端里输入密码和隐私信息。4. 网页端接入的边界Eaglercraft 能连但要注意账号模式4.1 网页版客户端和官方启动器的差异很多第一次接触 Eaglercraft 网页版的人会以为它就是一个“不用安装的 Minecraft”。确实它省去了安装启动器和 Java 环境的步骤适合快速演示和轻量测试。但它的边界也很明显功能上不等同于官方客户端。部分模组、资源包、光影能力可能缺失或表现不同。浏览器环境下的输入延迟和显卡渲染能力和官方启动器有差距。第三方网页客户端的服务端可能无法保证隐私安全。所以我的经验是Eaglercraft 网页版用来验证互通流程、临时让朋友进服务器看一眼、或者做教程演示非常方便。但如果要稳定联机、长期游玩、跑复杂插件还是应该回到官方启动器。4.2 正版验证、离线模式和 Floodgate 的账号逻辑这是互通服务器上最容易混乱的部分。如果你的服务器online-modetrue所有 Java 版玩家都需要经过正版账号验证。基岩版玩家没有 Java 版正版账号但通过 Floodgate可以把基岩版玩家映射成一个 Java 版风格的 UUID并允许其绕过 Java 版正版验证完成加入。如果你的服务器online-modefalseJava 版玩家不需要正版验证就能进入服务器。基岩版玩家即使不装 Floodgate也往往可以进入但玩家 UUID 不稳定容易出现同名问题。下面这个表可以帮你快速判断服务器模式Java 版玩家基岩版玩家建议开启正版验证需要正版账号需要 Floodgate 才能正常加入适合正式对外小服离线模式不需要正版账号可加可不加 Floodgate但身份不可控只建议测试环境不推荐在公网开启毫无身份管理的离线模式。“能连上”和“安全稳定地运行”是两回事。4.3 Beta 客户端、协议版本和兼容性标题里还有 beta 这个词。在互通场景里它可能指两件事BE Beta 版本或者服务器处于 beta 测试阶段。如果是 BE Beta 客户端需要特别注意。基岩版测试版和正式版的网络协议可能不一致Geyser 的版本如果没有及时跟随更新Beta 客户端可能会因为协议不兼容而无法连接。遇到这种情况先换回基岩版正式版客户端大概率能解决。如果是服务器处于 beta 测试阶段那更合适的做法是先限制人数只允许信任的测试者加入。不要一开始就公开放出大量端口和相关宣传否则一旦配置有疏忽玩家体验会很差。5. 互通服常见问题和排查顺序5.1 玩家进不来先查端口再查插件版本再查账号模式“进不来”是最常见的求助内容但原因五花八门。我建议按下面的顺序排查不要一上来就重装服务器。第一步确认端口监听。先在服务器本机执行ss -ulpn | grep 19132 ss -tlnp | grep 25565如果端口没有监听说明 Geyser 没有正常加载或者你的服务端核心不是 Geyser 支持的平台。这时候看插件日志确认 Geyser 是否加载成功。第二步检查防火墙和安全组。本地能连不代表公网能连。确认 TCP 25565 和 UDP 19132 都放行。第三步检查客户端填写的地址和端口。基岩版填错端口、Java 版填错端口都会导致连不上。第四步检查账号模式。Java 版正版验证服务器需要正版账号离线模式下如果装了强制正版验证插件也会拒绝非正版玩家。Eaglercraft 网页版连接正版验证服失败多半就是这个原因。5.2 进了世界但看不到对方检查世界维度、客户端类型和插件兼容性如果玩家已经进入服务器但互相看不到先确认是否在同一个维度。主世界、下界、末地是分开的不同维度的玩家当然看不到彼此。传送命令把测试者拉到同一坐标再观察。如果确认在同一个位置还是看不到对方就要考虑客户端类型差异。基岩版和 Java 版虽然通过 Geyser 转换协议但并不是所有行为都 100% 一致。比较常见的现象包括自定义物品、NPC 插件界面、彩色聊天消息显示不一致。某些插件提供的 GUI 界面在基岩版渲染异常。部分动作、粒子效果、实体交互存在细微差异。这些不是“互通坏了”而是协议转换的天然边界。如果是插件兼容性问题常见做法是把问题插件换成支持跨版本/跨端的替代品或者关闭该插件在非 Java 客户端的展示效果。5.3 延迟高、频繁掉线先看服务器资源再看网络路径互通服的延迟问题不能只怪 Geyser。服务器卡顿先看 TPS 和内存占用。TPS 如果长期低于 18服务器本身就处理不过来任何客户端都会卡。降低视距、限制生物数量、减少区块加载是最直接的优化手段。网络方面基岩版走 UDPUDP 在高丢包环境下表现会很差。如果手机玩家频繁掉线先看服务器所在机房的带宽、丢包率和路由。纯软件层面不一定能完全解决。插件数量和自动保存频率也会影响稳定。我见过一个测试服装了几十个插件最终卡到连日志都无法正常输出。互通服联动 Geyser 和 Floodgate 后插件事件处理链路更长每多一个逻辑重的插件都会放大延迟。6. 几个我实测后的建议6.1 不要一上来就加一堆互通相关插件很多教程会一次性让你安装 Geyser、Floodgate、跨服端、代理端、登录插件等一堆组件。如果你是第一次搭我强烈建议只装三样Paper 服务端、Geyser-Spigot、Floodgate。先把最简单的单服务器互通跑通确认 Java 版和基岩版都能进同一个世界然后再根据需求加注册登录、领地、经济、多世界等插件。插件链路越短出问题时越好排查。一上来就搭复杂架构很容易把“端口没开”“插件版本不匹配”“账号模式配置错误”这三个问题混在一起浪费大量时间。6.2 自测流程单机、局域网、公网三步我自己的测试流程是这样的单机测试在同一台电脑上用 Java 版连 127.0.0.1:25565用基岩版手机或者支持基岩版连接的测试入口连 127.0.0.1:19132。局域网测试在同一局域网内的另一台设备连接服务器内网 IP确认防火墙没有把局域网访问挡住。公网测试如果有公网 IP 或云服务器再从外部网络连接同时确认安全组和端口映射是否正确。每一步都只解决一个变量。如果你直接跳到公网测试失败后要么怀疑端口、要么怀疑插件、要么怀疑配置根本定位不到根因。6.3 安全与合规只使用有权限的客户端和服务器最后聊一点容易被忽略的东西。Eaglercraft 这类网页版客户端属于第三方方案用它之前要确认客户端来源、授权边界和服务器使用权限。我个人的原则很简单只在自己拥有权限的测试服务器上使用只使用可信来源的客户端不在不明网页里输入任何账号密码。离线模式虽然测试方便但不代表可以随便对公网开放。建议加上验证插件定期备份世界数据日志也要保留。互通服务器不只是“把手机和电脑连进同一个世界”它同样需要面向长期维护的思路。如果只是学习默认配置够用如果要长期跑下去就要把端口管理、插件版本、身份验证、备份策略都提前想好。踩过几次坑之后你会发现大多数问题不是 Geyser 不行而是前置环境和输入材料没有处理干净。 
长河君 · 2026/9/7 2:31:34 · 阅读 1.2k Minecraft互通服务器搭建指南：基岩版与Java版/网页端并存
如果你最近在翻 Minecraft 相关的内容大概率会看到“互通服务器”“BE”“JE”“eaglecraft 网页版”这几个词被放在一起。先说一个比较容易绕晕的点BE 是基岩版JE 是 Java 版eaglecraft 网页版本质上是一个跑在浏览器里的 Java 版客户端而不是基岩版。所谓“互通”不是让某一种客户端变成另一种而是让 Java 版电脑玩家、基岩版手机玩家、网页版玩家通过各自不同的协议和端口进入同一个服务器世界。这篇文章会按实际落地顺序拆一遍先讲清楚各端角色再讲搭建互通服务器需要准备什么然后从零搭一个能同时让基岩版手机和 Java 版网页客户端进入的服务器最后补上常见问题和排查链路。适合正在选服务端、刚接触 Geyser 插件体系、或者想在低配置机器上做个人测试服的读者。1. 先搞清楚“BE、JE、网页版”在互通里到底承担什么角色1.1 BE、JE、Eaglercraft 网页版分别是哪一端很多人在搜索的时候会以为“互通 手机基岩版直接连 Java 版服务器”这个理解对了一半。真正的执行方式是服务器仍然是 Java 版服务端基岩版玩家通过一个翻译层接入这个翻译层把基岩版的协议转换成 Java 版能识别的协议。常见做法是使用 Geyser 系列插件。所以你需要先分清三类客户端客户端类别底层协议常见入口在互通服中的角色Java 版客户端Java Edition 协议官方启动器、第三方启动器、Eaglercraft 网页版直接连接 Java 版端口默认 25565基岩版客户端Bedrock Edition 协议手机、Win10/11、主机上的基岩版通过 Geyser 连接基岩版端口默认 19132Eaglercraft 网页版Java Edition 协议浏览器本质是 Java 版客户端连接 25565这个区分很重要。如果你把 Eaglercraft 网页版当成“手机端”看待配置方向就会错。它更接近“一个不需要安装启动器的 Java 版客户端”适合用来快速验证服务器能不能连通。1.2 互通服务器的核心Geyser 与 Floodgate 各管什么Geyser 是整套互通方案里最核心的一环。它作为服务端插件运行监听一个 UDP 端口基岩版客户端连接该端口后Geyser 会把基岩版流量翻译成 Java 版流量转发给主服务器。Floodgate 则是配合 Geyser 使用的身份映射插件。它解决的是“基岩版玩家没有 Java 版账号怎么通过正版验证或者怎么生成稳定 UUID”的问题。如果服务器是离线模式很多人会暂时不装 Floodgate也能跑起来。但这样玩家身份不可控谁都能用任意名字进入管理上会有很大隐患。我的建议是只要服务器不是只给一个人玩的纯测试环境就把 Floodgate 装上。这里要特别说明Geyser 和 Floodgate 不是同一个东西。Geyser 负责协议翻译Floodgate 负责玩家标识与登录桥接。只装 Geyser不装 Floodgate也能实现部分互通但账号逻辑会很别扭。1.3 网易版为什么默认不能直接加入这种互通服标题里提到了网易这也是搜索量很高的一个词。网易版是 Mojang 在中国大陆地区由网易代理发行的版本它有自己的账号体系、联机大厅、服务器列表和网络通道和“国际版 Java 版 / 基岩版”的服务器直连方式不一样。网易版客户端通常不能像国际基岩版那样手动填写第三方服务器 IP 和端口。如果你想做互通测试尽量使用国际版 Java 客户端或国际版基岩版客户端。如果你手头只有网易版但又想验证互通服务器最常见的做法是先安装一个 Java 版客户端在测试服上跑通流程然后再处理手机基岩版。不要一开始就把时间花在研究网易版怎么添加第三方地址上成功率和收益都低。2. 搭建互通服务器前先把环境和条件过一遍2.1 硬件与系统低配置机器能不能带起来如果是个人学习、好友联机、小范围测试低配置机器完全能跑。Java 版服务器本身吃内存和 CPU内存不足会直接导致卡顿或崩溃。Geyser 会额外占一部分内存因为需要维护协议转换和玩家数据但通常情况下不会比主服务端更吃配置。我自己一般这样估算纯测试环境2G 内存够用5 到 10 人左右的小服4G 内存比较稳妥。如果还要加地图预生成、多世界、插件商店、登录插件内存需求要更高。系统方面Windows、Linux、macOS 都可以跑。生产环境我更推荐 Linux 服务器尤其是云服务器因为它可以长期稳定运行资源占用也比桌面系统干净。如果你只是在本地 Windows 电脑上做测试把 Java 和防火墙处理好就行。注意不要一上来就开启很大的视距和一堆预生成地图。低配置机器能跑测试不代表能跑重负荷场景。先让服务器稳定运行再逐步加压。2.2 Java、服务端核心和插件版本怎么选Java 版服务端核心决定了整个服务器的基础。原版服务端可以跑但想加 Geyser、Floodgate 这类插件建议使用支持 Bukkit/Spigot/Paper API 的插件服务端核心。Paper 是我个人用得比较多的选择它兼容大量插件性能也比原版服务端好一些。Purpur 也可以但除非你有特定功能需求否则从 Paper 开始更稳妥。下载时要注意Java 版本要匹配服务端核心要求常见服务端核心需要 Java 17 或 Java 21。Geyser 插件有不同的平台版本比如 Paper/Spigot 用 Geyser-SpigotBungeeCord 用 Geyser-BungeeCordVelocity 用 Geyser-Velocity。Floodgate 也要选择对应平台版本不能随意混搭。很多新手在插件版本上翻车。下载插件之前先看它支持的服务端核心和 Minecraft 版本再决定要不要装。插件不兼容通常不会在启动时立刻报错而是会表现为“基岩版连不上”“Floodgate 无效”“玩家加入后立刻掉线”。2.3 服务器端口、防火墙和安全组要提前留好互通服务器至少要涉及两个端口Java 版端口默认 25565TCP 协议。基岩版端口默认 19132UDP 协议。如果你在本地测试用 localhost 或 127.0.0.1 连接不涉及公网端口开放。但要让手机或别人从外部连接就必须在防火墙和云服务器安全组里放行这两个端口。Linux 上使用 UFW 防火墙时可以这样开放sudo ufw allow 25565/tcp sudo ufw allow 19132/udp sudo ufw status云服务器还需要在控制台的安全组规则里放行。注意 TCP 和 UDP 是分开的基岩版端口如果只放了 TCP手机依然连不上。这一条是排查时最容易忽略的地方。监听端口的确认也很重要。服务器启动后可以用命令检查ss -ulpn | grep 19132 ss -tlnp | grep 25565如果 19132 没有监听说明 Geyser 没有正常启动或配置被改坏了。先看这个再考虑其他问题。3. 从零搭建先让 Java 版和 BE 版进入同一个世界3.1 初始化一个 Paper 服务端第一步是准备服务端核心。假设你已经下载了 Paper 核心放到一个独立目录里。首次启动前先编辑 eula.txt把eulafalse改成eulatrue表示同意 EULA。然后在目录下执行java -Xmx2G -jar paper.jar --nogui这里-Xmx2G是分配给服务器的最大内存以自己的机器和场景为准。首次启动会自动生成配置文件和默认世界。生成完成后关闭服务器编辑server.properties。如果只是测试互通可以把服务器设为离线模式server-port25565 online-modefalse motd互通测试服online-modefalse意味着玩家不需要通过官方正版验证适合局域网小范围测试。但这个模式下玩家身份不受官方账号体系约束不要以为是安全的。正式对外开服时要结合插件做身份管理。3.2 安装 Geyser-Spigot 和 Floodgate 并确认启动日志把下载好的 Geyser-Spigot 插件和 Floodgate 插件放进plugins目录重新启动服务器。第一次启动后Geyser 会在plugins/Geyser-Spigot下生成 config.ymlFloodgate 也会生成自己的配置目录。查看启动日志时重点确认以下几行信息Geyser 是否成功加载。Geyser 监听在哪个 IP 和端口。Floodgate 是否成功挂钩 Geyser。如果看到 Geyser 提示监听 0.0.0.0:19132说明基岩版入口已经准备好。如果端口被占用或者插件因为依赖缺失没能加载会直接体现在日志里。Geyser 的 config.yml 里比较关键的是bedrock.port。默认 19132一般不用改。如果改了手机添加服务器时也要填写相同端口。3.3 用手机基岩版添加服务器并验证互通在手机上打开基岩版进入服务器列表选择“添加服务器”或“添加外部服务器”。服务器地址填写你服务器的 IP 或域名端口填写 19132。基岩版默认端口就是 19132所以有些客户端里端口可以留空但为了稳妥最好手动填上。点击加入后如果能看到服务器世界说明 Geyser 的协议翻译工作正常。这时候你在电脑上再开一个 Java 版客户端连接 25565两边进入同一个世界后互相能看到对方互通就算跑通了。我第一次测试时遇到过一个问题手机能进但电脑端玩家看不到手机玩家。后来发现是两边进的是同一个世界但一个在出生点一个因为加入位置不同被隔开了。先传送到同一个坐标再观察比来回乱跑更有效。3.4 用 Eaglercraft 网页版连接 Java 端口完成交叉验证Eaglercraft 网页版在这里的角色是“网页版 Java 客户端”。你只需要在浏览器里打开对应网页客户端选择连接服务器填入 Java 版地址和端口 25565。如果服务器是离线模式通常可以直接进入。如果服务器开启了正版验证模式网页版客户端没有正常的正版登录通道就会卡在登录阶段。这是预期行为不代表互通配置坏了。所以在测试时我一般建议先给 Eaglercraft 网页版准备一个离线模式的测试服或者确认服务器允许离线模式进入。网页版适合做“快速连接验证”但不建议作为主力游戏客户端因为它受浏览器性能限制渲染、输入延迟、资源包支持都和官方客户端有明显差距。关于 Eaglercraft 这类第三方网页客户端有一点要特别提醒它不是 Mojang 官方产品使用范围和授权边界需要你自己确认。我只建议在你自己的测试服务器、你有权限管理的环境里使用不要在不清楚来源的网页客户端里输入密码和隐私信息。4. 网页端接入的边界Eaglercraft 能连但要注意账号模式4.1 网页版客户端和官方启动器的差异很多第一次接触 Eaglercraft 网页版的人会以为它就是一个“不用安装的 Minecraft”。确实它省去了安装启动器和 Java 环境的步骤适合快速演示和轻量测试。但它的边界也很明显功能上不等同于官方客户端。部分模组、资源包、光影能力可能缺失或表现不同。浏览器环境下的输入延迟和显卡渲染能力和官方启动器有差距。第三方网页客户端的服务端可能无法保证隐私安全。所以我的经验是Eaglercraft 网页版用来验证互通流程、临时让朋友进服务器看一眼、或者做教程演示非常方便。但如果要稳定联机、长期游玩、跑复杂插件还是应该回到官方启动器。4.2 正版验证、离线模式和 Floodgate 的账号逻辑这是互通服务器上最容易混乱的部分。如果你的服务器online-modetrue所有 Java 版玩家都需要经过正版账号验证。基岩版玩家没有 Java 版正版账号但通过 Floodgate可以把基岩版玩家映射成一个 Java 版风格的 UUID并允许其绕过 Java 版正版验证完成加入。如果你的服务器online-modefalseJava 版玩家不需要正版验证就能进入服务器。基岩版玩家即使不装 Floodgate也往往可以进入但玩家 UUID 不稳定容易出现同名问题。下面这个表可以帮你快速判断服务器模式Java 版玩家基岩版玩家建议开启正版验证需要正版账号需要 Floodgate 才能正常加入适合正式对外小服离线模式不需要正版账号可加可不加 Floodgate但身份不可控只建议测试环境不推荐在公网开启毫无身份管理的离线模式。“能连上”和“安全稳定地运行”是两回事。4.3 Beta 客户端、协议版本和兼容性标题里还有 beta 这个词。在互通场景里它可能指两件事BE Beta 版本或者服务器处于 beta 测试阶段。如果是 BE Beta 客户端需要特别注意。基岩版测试版和正式版的网络协议可能不一致Geyser 的版本如果没有及时跟随更新Beta 客户端可能会因为协议不兼容而无法连接。遇到这种情况先换回基岩版正式版客户端大概率能解决。如果是服务器处于 beta 测试阶段那更合适的做法是先限制人数只允许信任的测试者加入。不要一开始就公开放出大量端口和相关宣传否则一旦配置有疏忽玩家体验会很差。5. 互通服常见问题和排查顺序5.1 玩家进不来先查端口再查插件版本再查账号模式“进不来”是最常见的求助内容但原因五花八门。我建议按下面的顺序排查不要一上来就重装服务器。第一步确认端口监听。先在服务器本机执行ss -ulpn | grep 19132 ss -tlnp | grep 25565如果端口没有监听说明 Geyser 没有正常加载或者你的服务端核心不是 Geyser 支持的平台。这时候看插件日志确认 Geyser 是否加载成功。第二步检查防火墙和安全组。本地能连不代表公网能连。确认 TCP 25565 和 UDP 19132 都放行。第三步检查客户端填写的地址和端口。基岩版填错端口、Java 版填错端口都会导致连不上。第四步检查账号模式。Java 版正版验证服务器需要正版账号离线模式下如果装了强制正版验证插件也会拒绝非正版玩家。Eaglercraft 网页版连接正版验证服失败多半就是这个原因。5.2 进了世界但看不到对方检查世界维度、客户端类型和插件兼容性如果玩家已经进入服务器但互相看不到先确认是否在同一个维度。主世界、下界、末地是分开的不同维度的玩家当然看不到彼此。传送命令把测试者拉到同一坐标再观察。如果确认在同一个位置还是看不到对方就要考虑客户端类型差异。基岩版和 Java 版虽然通过 Geyser 转换协议但并不是所有行为都 100% 一致。比较常见的现象包括自定义物品、NPC 插件界面、彩色聊天消息显示不一致。某些插件提供的 GUI 界面在基岩版渲染异常。部分动作、粒子效果、实体交互存在细微差异。这些不是“互通坏了”而是协议转换的天然边界。如果是插件兼容性问题常见做法是把问题插件换成支持跨版本/跨端的替代品或者关闭该插件在非 Java 客户端的展示效果。5.3 延迟高、频繁掉线先看服务器资源再看网络路径互通服的延迟问题不能只怪 Geyser。服务器卡顿先看 TPS 和内存占用。TPS 如果长期低于 18服务器本身就处理不过来任何客户端都会卡。降低视距、限制生物数量、减少区块加载是最直接的优化手段。网络方面基岩版走 UDPUDP 在高丢包环境下表现会很差。如果手机玩家频繁掉线先看服务器所在机房的带宽、丢包率和路由。纯软件层面不一定能完全解决。插件数量和自动保存频率也会影响稳定。我见过一个测试服装了几十个插件最终卡到连日志都无法正常输出。互通服联动 Geyser 和 Floodgate 后插件事件处理链路更长每多一个逻辑重的插件都会放大延迟。6. 几个我实测后的建议6.1 不要一上来就加一堆互通相关插件很多教程会一次性让你安装 Geyser、Floodgate、跨服端、代理端、登录插件等一堆组件。如果你是第一次搭我强烈建议只装三样Paper 服务端、Geyser-Spigot、Floodgate。先把最简单的单服务器互通跑通确认 Java 版和基岩版都能进同一个世界然后再根据需求加注册登录、领地、经济、多世界等插件。插件链路越短出问题时越好排查。一上来就搭复杂架构很容易把“端口没开”“插件版本不匹配”“账号模式配置错误”这三个问题混在一起浪费大量时间。6.2 自测流程单机、局域网、公网三步我自己的测试流程是这样的单机测试在同一台电脑上用 Java 版连 127.0.0.1:25565用基岩版手机或者支持基岩版连接的测试入口连 127.0.0.1:19132。局域网测试在同一局域网内的另一台设备连接服务器内网 IP确认防火墙没有把局域网访问挡住。公网测试如果有公网 IP 或云服务器再从外部网络连接同时确认安全组和端口映射是否正确。每一步都只解决一个变量。如果你直接跳到公网测试失败后要么怀疑端口、要么怀疑插件、要么怀疑配置根本定位不到根因。6.3 安全与合规只使用有权限的客户端和服务器最后聊一点容易被忽略的东西。Eaglercraft 这类网页版客户端属于第三方方案用它之前要确认客户端来源、授权边界和服务器使用权限。我个人的原则很简单只在自己拥有权限的测试服务器上使用只使用可信来源的客户端不在不明网页里输入任何账号密码。离线模式虽然测试方便但不代表可以随便对公网开放。建议加上验证插件定期备份世界数据日志也要保留。互通服务器不只是“把手机和电脑连进同一个世界”它同样需要面向长期维护的思路。如果只是学习默认配置够用如果要长期跑下去就要把端口管理、插件版本、身份验证、备份策略都提前想好。踩过几次坑之后你会发现大多数问题不是 Geyser 不行而是前置环境和输入材料没有处理干净。