原文链接：【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。
sudo apt ｕｐｄａｔｅ
sudo apt install cmake
sudo snap install go --classic
2、升级libprotobuf-dev到最新版本
这里在运行依赖中有直接的说明，所以我们单独处理一下。
更新到最新版本：
apt install libprotobuf-dev
3、下载编译好的kwdb压缩包
下载地址： https://gitee.com/kwdb/kwdb/releases/tag/V2.2.0
下载命令：wget 地址
例如：
wget https://gitee.com/kwdb/kwdb/releases/download/V2.2.0/KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz
4、解压kwdb压缩包
tar zxvf KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz
5、修改配置文件
这里可以ls看一下文件内
操作命令：
cd kwdb_install/vi deploy.cfg
6、修改配置文件-避免依赖冲突
~/.bashrc 与 /etc/profile 需要添加 【export GO111MODULE=off】 避免依赖冲突
修改完毕后重新执行一下：
source ~/.bashrc
source /etc/profile7、安装kwdb·并设置密码
./deploy.sh install --single这里运行的时候稍微等一会，然后会让你输入pwd，我这里输入了：111111 为了好记。
8、重新加载系统服务的配置文件
systemctl daemon-reload9、启动kwdb
systemctl start kaiwudb.service10、查看kwdb状态
systemctl status kaiwudb
11、登录到命令行的kwdb
/usr/local/kaiwudb/bin/kwbase sql --host=更换自己的IP:26257 --certs-dir=/etc/kaiwudb/certs
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
评论(0)