依据所列项目文档编写，核对日期为 2026-10-31。请匹配实际版本、加载器和构建；命令为文档示例，本文不声称进行过托管商性能实测。
01 Geyser 与 Floodgate 分别解决什么
Geyser 使受支持的基岩客户端连接 Java 服务端；Floodgate 处理没有付费 Java 账号的基岩玩家认证，它不是协议转换层本身。通过 Official setup selector / Geyser 官方部署选择器 ↗ 匹配 Paper/Spigot、模组加载器、代理或独立部署。
这不代表所有 Java 整合包都能由基岩玩家游玩。要求安装 Java 客户端玩法模组的包，与仅服务端扩展不同。购买跨平台托管前列出玩家平台和必需模组，再问商家实际部署方式及兼容版本。
02 先核对传输协议，不照抄旧的 UDP-only 教程
2026-10-31 核对的文档描述 NetherNet：配置的 Geyser 端口需要 TCP 用于发现或信令，UDP 用于游戏；较早 RakNet 教程可能只写 UDP。必须匹配已安装 Geyser 和基岩客户端版本，旧教程中的规则可能不完整。
| 检查对象 | 需要匹配 |
|---|---|
| Java 监听 | 实际 Java 服务端地址。 |
| 基岩/Geyser 监听 | 实际分配端口与传输方式。 |
| 路由器或托管分配 | 所选传输要求的全部协议。 |
| 其他应用 | 不能占用 Geyser 所需端口。 |
当前文档示例使用 19132，租服可能分配不同值，应向商家核实。不要盲目开放端口范围，也不要因为数字熟悉就把 Java 端口改成基岩端口。
03 安装匹配的发行包并正常重启
- 备份 Java 服务器并记录当前可用配置。
- 从官方选择器下载适合实际平台的发行包。
- Paper/Spigot 文档说明将 Geyser-Spigot.jar 放入 plugins 后重启。
- 使用真实分配的基岩端点和选定认证方式编辑生成配置。
- 使用 Floodgate 时按对应平台文档操作，密钥资料保持私密。
- 从原服务或面板正常重启，检查实际构建的日志。
认证失败时，不应直接关闭公开后端的账号校验。代理部署还需匹配转发及网络隔离。身份混乱时，移动玩家文件前先看 UUID guide / UUID 指南。
04 区分 Java 故障与基岩故障
先证明 Java 玩家能进入正确世界，再测试支持的基岩客户端，并让外网玩家验收。游戏主机应采用项目文档中的主机连接方式，不保证所有主机都提供任意地址输入框。
Java 正常而基岩失败时，记录基岩版本、Geyser 构建、传输方式、分配地址、认证模式和错误。新 Geyser 可能需要不同协议兼容组件，应看实时支持列表，不把一个版本号永久写成通用要求。两种客户端都失败时，先做 Basic acceptance / 基础开服验收。