转载工具服务器管理Floodgate 基岩身份接入｜Geyser 搭配、白名单与密钥安全插件2.2.5-b141 / 模组2.2.7-b69

资源作者：GeyserMC 团队｜中文整理：方块社
本文根据官方文档独立整理，非官方发布。本站未做连接、性能或安全实测；只提供官方外链，不镜像插件或模组文件。 资料核验日期：2026-10-10。下载前请重新核对平台与版本。

与 Geyser 搭配，但不是同一个功能

Geyser 负责基岩版与 Java 版的协议桥接；Floodgate 负责混合认证集成，让拥有 Minecraft 基岩版账号的玩家，以基岩身份加入配置了该体系的 Java 在线认证服务器，无需额外拥有 Java 版账号。

它不是让任意 Java 未验证客户端进入服务器的“免登录插件”，也不能用来进入没有部署 Floodgate 的任意 Java 服。安装方必须能够管理目标服务端，并正确设置整套认证和网络链路。

可以先参考本站的 Geyser 入门介绍，再按自己的部署方式配置 Floodgate。

官方皮肤示例

来源：GeyserMC 官方功能文档，展示基岩皮肤转换示例。这是作者文档中的历史游戏截图，不是本站实测，也不是所有自定义皮肤的兼容保证。

先选对下载渠道

使用方式	核验到的版本与入口
Spigot / BungeeCord / Velocity 插件	官方下载 API：2.2.5 build 141，下载页面选 Floodgate 与平台
Fabric / NeoForge 模组	Modrinth Floodgate-Modded：2.2.7-b69，对应 Minecraft 26.3
Geyser Standalone	Floodgate 安装到目标 Java 服务端，Standalone 侧按官方指南配置密钥与认证

插件版与模组版有不同发行编号，不要把 Modrinth 上最新模组当成 Paper、Spigot 或代理的插件 JAR。同样，不要因为项目历史支持很多版本，就把最新模组放进任意旧版本客户端或服务端。

Java 环境要满足 Geyser、服务端、代理与具体构建要求。当前 Geyser-Spigot 文档要求 Java 21+，最新 Floodgate-Modded 26.3 构建源码目标是 Java 25；不要拿核心旧编译基线当作整套环境下限。

单台兼容插件服的基本路线

1. 备份并在测试服确认 Geyser 本身能正常启动。
2. 从官方 Floodgate 下载页选择对应插件平台。
3. 停服，将 JAR 放入 plugins，完整启动生成文件。
4. 将 Geyser 配置中的 auth-type 设为 floodgate，按官方指南完整重启。
5. 使用真实基岩账号连接，测试身份、皮肤、权限和白名单。

这是单台插件服的概览，不是完整配置模板。Fabric、NeoForge 和代理网络请切换官方安装指南对应的平台页；Fabric 官方说明还需要 Fabric API。

代理网络：不要每台都盲目装一遍

代理网络通常先在代理端安装 Floodgate。后端若需要 Floodgate API、正确的基岩皮肤等功能，则依官方说明配置后端插件与数据转发。

这一过程可能涉及 send-floodgate-data、玩家转发设置及把代理的 key.pem 安全复制给可信后端。这些选项必须按对应代理指南组合配置，不能单独抄一个选项就认定链路安全。

认证密钥与后端防护最重要

• **绝不能公开 key.pem。**官方警告，持有该密钥的人可借 Floodgate 绕过 Java 认证；不要随日志、配置包或求助附件发出去。
• 不要为了连得上就笼统把所有服务端改成 online-mode=false。单服保持正确在线认证；代理后端依其转发指南设置并禁止公网直接访问。
• Velocity 转发密钥与 Floodgate 密钥不是同一份秘密，必须各自保护。
• 使用防火墙限制可信代理访问后端；同机部署可按指南绑定本地地址。玩家转发验证不能代替防火墙。
• 保留合理的基岩用户名区分前缀，检查 Java 与基岩同名账号的权限、数据归属，避免错误合并。

白名单与账号关联

官方提供 /fwhitelist 管理基岩白名单，例如：

/fwhitelist add <基岩版Gamertag>
/fwhitelist remove <基岩版Gamertag>

这里填写实际 Gamertag，不需要额外加用户名前缀。具体权限和参数以安装版本官方帮助为准。

项目还提供可选账号关联、皮肤与表单 API 等能力。账号关联涉及身份与玩家数据，不建议在正式服未经备份就尝试切换；请先阅读官方 Linking 说明。

官方入口与许可

• 官方 Floodgate 分平台下载
• Fabric / NeoForge 官方模组发行
• 官方概述
• 安装指南
• 功能文档
• 命令与权限
• Velocity 后端安全
• Floodgate MIT 许可

代码采用 MIT，复制或分发须保留版权与许可声明。图标来自官方模组项目，截图来自官方功能文档，仅作项目识别及必要说明，权利归相应作者；程序许可不自动覆盖 Minecraft 截图、商标等全部权利。本文不宣称官方背书，配图仅缩放与压缩，没有虚构游戏界面。