先给结论
Java 版 server.properties 中的 online-mode 决定服务器是否向官方认证服务验证玩家账号。开启时,玩家身份与正版账号绑定;关闭时,客户端可以使用任意用户名登录,冒名、绕过封禁和盗取权限的风险显著增加。在 Velocity 等代理架构中,后端通常关闭直接验证,但必须由代理负责验证并安全转发身份。服务器应优先使用正版验证,并正确配置代理转发。
一、online-mode 做了什么
online-mode 开启时,服务器会通过官方认证流程确认连接的玩家拥有对应正版账号。
玩家的唯一标识与正版账号绑定,用户名变化也不会影响身份识别。
权限、封禁、经济和领地等插件通常依赖这个稳定身份。
关闭 online-mode 后,服务器不再验证账号真实性,客户端可以声称自己是任意用户名。
因此 online-mode 不只是一个进服设置,而是整个身份体系的基础。
二、关闭验证的直接风险
他人可以使用管理员的用户名登录,如果没有额外验证,就可能获得管理员权限。
被封禁玩家可以换一个用户名重新进入,封禁难以长期有效。
玩家资产与用户名绑定时,冒名者可能取走他人的物品或经济余额。
日志中的用户名不再可靠,纠纷处理与追责会变得困难。
这些风险并不只针对大型公开服,小服一旦地址泄露同样会受到影响。
三、代理架构中的特殊情况
在 Velocity 或 BungeeCord 网络中,玩家先连接代理,代理负责与官方认证服务完成验证。
后端子服通常关闭 online-mode,因为它们不直接面对玩家,而是接收代理转发的身份。
这时后端必须启用正确的转发方式,并只接受来自代理的连接。
如果后端端口对公网开放,玩家可以绕过代理直接连接后端,并伪造身份进入。
代理架构的安全关键是:代理验证、转发可信、后端不暴露。
四、转发方式与密钥
Velocity 的现代转发方式通常使用共享密钥,代理与后端都需要配置相同的密钥。
密钥必须足够复杂,并且不能出现在公开配置、截图或仓库中。
配置后要测试玩家通过代理进入时,后端能获得正确的玩家 UUID 与用户名。
同时测试直接连接后端是否会被拒绝。
代理或后端升级后,重新检查转发配置是否仍然生效。
五、为什么不建议用登录插件替代
部分离线服务器会使用登录插件让玩家设置密码,以降低冒名风险。
这种方式能缓解部分问题,但仍会带来账号密码泄露、弱密码、找回流程和身份迁移等管理负担。
离线身份与正版账号身份不同,插件数据迁移到正版模式时可能出现身份不一致。
对于长期运营的服务器,正版验证加正确代理转发通常更可靠。
具体是否合规与适合,还应结合官方条款与当地法律要求自行判断。
六、检查清单
单服服务器确认 online-mode 为开启状态。
代理服务器确认代理开启验证,后端按代理方案配置并启用转发。
后端子服端口不对公网开放,只允许代理访问。
管理员账号权限依赖 UUID 而非仅依赖用户名。
定期测试直接连接后端、冒名登录和封禁绕过场景是否会被阻止。
七、常见问题
有人问关闭 online-mode 能让更多人进服吗。短期可能降低门槛,但会显著削弱身份安全。
还有人问代理后端为什么关闭验证。因为验证由代理完成,但前提是转发安全且后端不暴露。
也有人遇到进服后 UUID 变化。检查代理转发方式和后端配置是否一致。
最后一个常见问题是管理员被冒名。立即检查 online-mode、代理转发和后端端口暴露情况。
执行步骤
- 确认服务器是单服还是代理架构。
- 单服开启 online-mode。
- 代理架构下由代理负责正版验证。
- 在代理与后端配置一致且足够复杂的转发密钥。
- 限制后端端口只允许代理访问。
- 测试通过代理进入时 UUID 与用户名正确。
- 测试直接连接后端会被拒绝。
- 让权限与封禁基于 UUID 而非仅基于用户名。
验收标准
- 单服 online-mode 已开启。
- 代理验证与转发配置正确。
- 后端端口未暴露公网。
- 转发密钥未公开泄露。
- 无法通过冒名进入管理员账号。
- 封禁无法通过更换用户名绕过。
常见误区
- 为了降低门槛关闭正版验证。
- 代理后端端口对公网开放。
- 转发密钥过于简单或被公开。
- 只按用户名授予管理员权限。
- 升级代理后不重新测试转发。
- 把登录插件当作完整身份方案。
online-mode 是 Java 版服务器身份安全的根基。单服开启验证,代理服由代理验证并安全转发,后端绝不暴露,权限与封禁才有可靠依据。