【KWDB 2025 创作者计划】_保姆级教你Ubuntu快速部署实操落地

前言

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

开源库地址：kwdb: KWDB 是一款面向 【AIoT 场景】的【分布式多模数据库】，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。

环境说明

系统：Ubuntu 22.04 64位 vcpu：4核(8vCPU) GiB：16 GiB

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

完整安装记录

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

# 准备初始安装的cmake与go
1、sudo apt update
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 update 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/profile

7、安装kwdb·并设置密码

./deploy.sh install --single

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

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

systemctl daemon-reload

9、启动kwdb

systemctl start kaiwudb.service

10、查看kwdb状态

systemctl status kaiwudb

11、登录到命令行的kwdb

/usr/local/kaiwudb/bin/kwbase sql --host=更换自己的IP:26257 --certs-dir=/etc/kaiwudb/certs

12、视频演示详情

可以通过B站来看到：

KWDB单机安装Ubuntu版本

总结

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

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

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