《一文讲透》第1期：KWDB 单点安装部署

Hi，各位开发者伙伴：

为帮助大家少走弯路，轻松上手 KWDB（KaiwuDB 社区版） ，我们的《一文讲透》专栏正式营业啦！每一篇都会为大家分享超详细实用的数据库操作步骤与实战演练！

KWDB 是一款面向 AIoT 场景的分布式多模数据库产品，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力。

大家可以放心地使用 KWDB 来解决在物联网、能源电力、车联网、智慧政务等各类场景下遇到的数据处理难题。有遇到问题都可以在文末扫码联系小K 为你解答！🙆

今天，我们将围绕以下2部分内容，与大家一起完成 KWDB 的安装部署：

✅单点裸机部署

✅单点容器部署 （分别使用安装脚本和 YAML 文件）

开始前一定记得先下载安装包哦

（ https://gitee.com/kwdb/kwdb/releases），我们的 Gitee 仓库地址（ https://gitee.com/kwdb/kwdb ）

单节点裸机部署

一、前提准备

1、硬件
如下为部署 KWDB 所需的硬件规格：

项目 要求
CPU 和内存 建议不低于 4 核 8G。
磁盘 - 推荐使用 SSD 或者 NVMe 设备，尽量避免使用 NFS、CIFS、CEPH 等共享存储。

• 磁盘必须能够实现 500 IOPS 和 30 MB/s 处理效率。
  文件系统 建议使用 ext4 文件系统。
  ✔️Tip：实际部署时，用户可以根据实际的业务规模和性能要求规划硬件资源。

2、操作系统
KWDB 支持在以下服务器操作系统进行安装部署。

操作系统 版本 架构
Ubuntu V20.04 ARM_64
V20.04 x86_64
V22.04 x86_64
KylinOS V10 x86_64
V10 ARM_64
UOS V20 x86_64
✔️Tip：如使用上述未提及的操作系统，可能会存在问题，可及时与我们联系解决。

3、软件依赖
安装时，KWDB 会对依赖进行检查。如果缺少依赖会退出安装并提示依赖缺失。如果目标机器不能联网，用户需要在能联网的机器上根据目标机器的操作系统下载好所有依赖文件，然后将依赖文件复制到目标机器上进行安装。

不同操作系统及安装包的依赖略有不同，请根据实际安装包类型及操作系统，在部署前安装好相应的依赖。下表列出需要在目标机器安装的依赖：

依赖 版本 说明
OpenSSL v1.1.1+ N/A
Protobuf v3.5.0+ N/A
GEOS v3.3.8+ 可选依赖
xz-libs v5.2.0+ N/A
squashfs-tools any N/A
libgcc v7.3.0+ N/A
mount any N/A
squashfuse any 可选依赖
4、端口要求
下表列出 KWDB 服务需要映射的端口。在安装部署前，确保目标机器的以下端口没有被占用且没有被防火墙拦截。在安装部署时，用户可以修改 deploy.cfg 文件中的端口配置参数。

端口号 说明
8080 数据库 Web 服务端口
26257 数据库服务端口、节点监听端口和对外连接端口
5、安装包处理
获取系统环境对应的 DEB 或 RPM 安装包（https://gitee.com/kwdb/kwdb/releases/tag/V2.0.3.2），将安装包复制到待安装 KWDB 的目标机器上，然后解压缩安装包：

tar -zxvf <package_name>
解压后生成的目录包含以下文件：

文件 说明
add_user.sh 安装、启动 KWDB 后，为 KWDB 数据库创建用户。
deploy.cfg 安装部署配置文件，用于配置部署节点的 IP 地址、端口等配置信息。