KBEngine Nex

Appearance

部署与更新 ​

本页汇总部署阶段需要保持一致的运行目录、服务组、网络配置和升级验证流程。单机开发环境应先完成 启动与停止，多环境参数传递见 启动参数与多环境配置。

多机部署注意事项 ​

单机脚本只适合开发和基础验证。多机部署还需要：

  • 所有节点使用相同服务组 UID；
  • KBE_RES_PATH 指向一致版本的 Assets；
  • Machine 能通过广播或 <machine><addresses> 发现其他节点；
  • internalInterface 使用可互通的内网地址；
  • LoginApp/BaseApp 的 externalAddress 和外部端口对客户端可达；
  • 数据库、管理入口和内部组件端口按最小范围放行；
  • 各进程的 cid、gus 不冲突；
  • 使用 systemd、容器编排或团队进程管理系统负责拉起、重启、日志和退出顺序。

不要把内部组件和管理端口直接暴露到公网，也不要以关闭整机防火墙作为组网方案。详见 分布式部署 和 自定义 IP、端口。

更新引擎后的推荐流程 ​

更新源码、vcpkg baseline 或第三方依赖后，推荐按以下顺序验证：

  1. 备份项目 Assets 和数据库；
  2. 阅读更新日志和迁移说明；
  3. 运行对应平台安装脚本重新配置和编译；
  4. 运行 CTest；
  5. 在隔离数据库启动服务端；
  6. 验证 EntityDef、登录、进 Space、RPC、写库、重连和安全关闭；
  7. 客户端可见协议变化时重新生成 SDK；
  8. 完成接近生产负载的 Bots 回归后再部署。

Nex 3.x 使用 KBEngine 1.x 协议基线，但 Python 3.12、第三方扩展、数据库驱动和具体 API 仍需按项目完成迁移验证。