🕹️ 单机部署

大约 1 分钟

本教程适用于 在单机 / 云服务器上部署 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 防火墙配置示例

提示

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

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

关闭防火墙：

sudo systemctl stop firewalld
sudo systemctl disable firewalld

放行必要端口：

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