Skip to content

单机部署

本教程适用于 在单机 / 云服务器上部署 KBEngine 服务端,包括引擎编译、资源上传、防火墙配置、安全组设置以及启动服务等完整流程。

1. 编译引擎与数据库

请参考文档进行引擎编译、环境安装及数据库初始化:

🔗 https://www.kbelab.com/manual/install.html


2. 上传 server_assets

将你的游戏服务端资源文件夹 server_assets/ 上传到 KBEngine 根目录 KBEngine-Nex/ 下,例如:

/home/ubuntu/KBEngine-Nex/server_assets


3. 防火墙配置(单机/本地部署)

KBEngine 运行过程中需要开放如下端口:

LoginApp + BaseApp(客户端通信端口):

  • 20013-20025/tcp

BaseApp 客户端 UDP 通讯:

  • 20005-20009/udp

Machine 服务相关端口:

  • 20086/tcp (machine 接收广播端口)
  • 20087/tcp (machine 服务发现广播端口)
  • 20088/tcp (machine 对外提供 TCP 服务端口)

Linux 防火墙配置示例

TIP

服务器本机防火墙可以选择关闭或者放行必要端口,二选其一即可

各系统使用的防火墙各不一样,此处以firewalld为例,其他防火墙使用方式请自行百度

关闭防火墙:

shell
sudo systemctl stop firewalld
sudo systemctl disable firewalld

放行必要端口:

shell
sudo firewall-cmd --add-port=20013-20025/tcp --permanent
sudo firewall-cmd --add-port=20005-20009/udp --permanent
sudo firewall-cmd --add-port=20086/tcp --permanent
sudo firewall-cmd --add-port=20087/tcp --permanent
sudo firewall-cmd --add-port=20088/tcp --permanent
sudo firewall-cmd --reload

4. 云服务器安全组

仅需要对外开放客户端通信端口:

必须开放:

  • 20013-20025/tcp
  • 20005-20009/udp

不应暴露公网的端口:

  • 20086/tcp
  • 20087/tcp
  • 20088/tcp

Machine 端口仅用于服务器内部服务发现。


5. 启动服务

进入 server_assets/scripts 目录: sh ./start_server.sh

查看日志: tail -f logs/* -n 200

关闭服务: sh ./stop_server.sh


部署成功标志

  • machine.log、baseapp.log、cellapp.log 中无报错
  • 客户端可正常连接 loginapp