原文链接：【KWDB 2025 创作者计划】_保姆级教你Ubuntu快速部署实操落地_ITPUB博客

作者：红目香薰

前言

KWDB是一款面向 AIoT 场景的分布式多模数据库产品，这里我对其整个部署的前期准备、部署过程与落地使用做一个博客文档式的说明，我这里尽量用多一些的图片来完成整个过程的梳理与操作演示，希望能给大家带来一定的帮助。

开源库地址： https://gitee.com/kwdb/kwdb

AIoT：即人工智能物联网（Artificial Intelligence of Things） ，是人工智能（AI）与物联网（IoT）技术的融合。

环境说明

系统：Ubuntu 22.04 64位

vcpu：4核(8vCPU)

GiB： 16 GiB

基础环境内容：cmake环境、go环境、升级libprotobuf-dev到最新版本，并添加export GO111MODULE=off避免依赖冲突。

完整安装记录

这里是下面操作的整个提示内容：

# 准备初始安装的cmake与go

1、sudo apt ｕｐｄａｔｅ

2、sudo apt install cmake

3、sudo snap install go --classic

# 升级libprotobuf-dev到最新版本

4、apt install libprotobuf-dev

# 下载编译好的kwdb压缩包

5、wget https://gitee.com/kwdb/kwdb/releases/download/V2.2.0/KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz

# 解压压缩包

6、tar zxvf KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz

# 进入到kwdb与修改配置

7、cd kwdb_install/

# 修改配置文件 关闭集群，这里只对单机进行安装，填写一下ip地址即可、将127.0.0.1更换成你的服务器IP地址

~/.bashrc   与  /etc/profile 需要添加  【export GO111MODULE=off】    避免依赖冲突

source ~/.bashrc

source /etc/profile

# 安装kwdb·要输入密码

8、./deploy.sh install --single

# 重新加载系统服务的配置文件

9、systemctl daemon-reload

# 启动kwdb

10、systemctl start kaiwudb.service

# 查看状态

11、systemctl status kaiwudb

# 登录到命令行的kwdb

12、/usr/local/kaiwudb/bin/kwbase sql --host=101.201.153.231:26257 --certs-dir=/etc/kaiwudb/certs

完整Ubuntu部署过程

接下来就是完整的操作过程，希望能对大家有所帮助。

1、准备初始安装的cmake与go

分别是更新apt的信息到最新版本，安装cmake与go。

2、升级libprotobuf-dev到最新版本

这里在运行依赖中有直接的说明，所以我们单独处理一下。

更新到最新版本：

3、下载编译好的kwdb压缩包

下载地址： https://gitee.com/kwdb/kwdb/releases/tag/V2.2.0

下载命令：wget 地址

例如：

4、解压kwdb压缩包

5、修改配置文件

这里可以ls看一下文件内

操作命令：

6、修改配置文件-避免依赖冲突

~/.bashrc   与  /etc/profile 需要添加  【export GO111MODULE=off】    避免依赖冲突

修改完毕后重新执行一下：

7、安装kwdb·并设置密码

这里运行的时候稍微等一会，然后会让你输入pwd，我这里输入了：111111    为了好记。

8、重新加载系统服务的配置文件

9、启动kwdb

10、查看kwdb状态

11、登录到命令行的kwdb

12、视频演示详情

这里我留下了视频，服务器使用的是阿里云的ECS，这里一定要注意的是必须使用8vcpu以上的资源，否则是无法正常安装的，我在演示之前测试过，不成，后来就改成了8vcpu，看好是8vcpu，不是8cpu，要求是4核，但是阿里的vcpu相当于0.5核，故而采用的是8vcpu来创建的服务。

可以通过B站来看到：https://www.bilibili.com/video/BV1tyZSYuEd1/

总结

整个过程我也是通过群里的各种询问解决的，很感谢有这么一个社区团队，大家都很热情的呢。

本篇文章的流程完整的展示了单机版本的KWDB安装过程，经过多次测试校验，本流程没有异常情况，可放心食用。

期待创造更多的价值，希望大家点点赞，外加多评论评论，有什么不了解的留言，我接着写教程。

KWDB开源库地址：https://gitee.com/kwdb/kwdb

KWDB学习地址：https://www.kaiwudb.com/learning/

KWDB活动地址：https://mp.weixin.qq.com/s/ZKQo7eQj_AtwamONCSl07A