KWDB 在虚拟机下的 unbuntu24.04x86-64 版本下编译安装实践

作者：jiao_zg

前言：

随着物联网，智能制造，人工智能，机器人等技术的发展，单纯的关系型数据库已经不能满足所有的存储场景了。时序数据库，大模型数据在一些场合下也需要和关系型数据库共同搭配，才能完成一些融合业务。这些信息化，物联网，大模型等应用对数据的需要使用诸如关系型数据库，时序数据库等不同的类型的数据库产品，这无论是部署还是维护都会带来一些开销。本文介绍一款方便用在物联网，机器人方向的一款数据库产品：kwdb.它融合了关系型数据库，时序数据库等多种类型的数据库，很适合用在iot应用中。本文在unbuntu24.04.2 x64操作系统中，通过编译安装KWDB数据库，并编写简单demo，为IOT的场景搭建基础的专用数据库。

一、环境准备

硬件：台式机pc windwos虚拟机

系统：unbuntu24.04.2 x64

kwdb:V2.2.0

二、部署规划

2.1.部署模式:

裸机，单机部署，非安全模式启动测试

为了便于测试，本文主要讲解单机部署方式。

2.2.部署方式：

源码编译

本文使用Ubuntu进行演示。本文将安装过程记录下来，并把遇到的坑记录下来，分享给大家。

2.3.环境依赖及版本

KWDB 支持在 Linux 操作系统进行安装部署，下表列出了编译和运行 KWDB 所需的软件依赖。

编译依赖：

运行依赖：

温馨提示：上述的版本请保证从操作系统到组件版本的一致性，否则可能会出现各种问题，请保持版本的一致性。如果不确定当前系统组件的安装版本，可以通过组件的命令 --version 进行查看，或者自行了解组件版本查看的方法，确定好组件版本之后再进行后续步骤，如果版本过高或者过低，都需要进行额外的降低版本或者升级版本的操作，请注意不要嫌麻烦，否则可能后续会造成更多的麻烦。如果根据本文进行操作，请保证使用的操作系统和本文一致，否则可能会出现其他类型的错误。如果没有对应的操作系统版本，可以到unbuntu官网下载，本文使用的初始版本就是直接下载后的，（例如对应的cmake是4.1版本，先降级到3.28后再降级到3.23版本，操作比较特殊）使用虚拟机安装好之后即可验证了。

4.源码下载

在 KWDB 代码仓库下载代码，并将其存储到 GOPATH 声明的目录。

5.安装路径：

/home/jiao/go

三、环境准备及依赖安装

安装 编译依赖，运行依赖，操作工具包等

3.1.安装 编译依赖

参考2.3的表格

为了方便执行，本文将所有的依赖项统一放到一个命令里执行，请注意可能和你的系统版本有差异，所以可能会出现部分组件已安装或者找不到的情况，没关系，如果有报错的情况可后面单独执行安装。

sudo apt update && sudo apt install -y ca-certificates golang cmake autoconf golang-yacc build-essential checkinstall libssl-dev libprotobuf-dev li