一:KaiwuDB学习过程中遇到的问题和建议

说明:

作为一名KaiwuDB的初学者，我对KaiwuDB数据库的理解还比较浅显，文章中所提出的各种建议和问题，主要是基于个人当前的学习和观察得出的。由于知识储备有限，其中可能存在理解不准确甚至错误的地方，还请大家多多包涵和指正。本文仅代表我个人的一些初步想法，希望能借此机会与各位前辈和同行交流学习，共同进步。

1.1 操作系统支持范围

社区版:支持Anolis、Ubuntu、UOS、Windows Server

企业版:支持Anolis、KylinOS、Ubuntu、UOS、Windows Server

KaiwuDB目前仅支持Anolis、KylinOS、Ubuntu、UOS、Windows Server这几种操作系统，这种有限的支持范围在实际应用中可能带来一系列问题。极大限制了用户的选择空间，许多企业已基于CentOS、Red Hat、其他国产操作系统等更主流操作系统构建了成熟的IT基础设施，迁移到KaiwuDB需要额外投入人力、时间和资金进行系统改造，增加了用户的迁移成本和风险。其次，狭窄的兼容性不利于产品的市场推广和生态建设，潜在用户群体被大幅压缩，难以在多样化的部署环境中获得应用，从而削弱了与其他数据库产品的竞争力。此外，缺乏对主流操作系统的支持也可能让用户质疑产品的成熟度和开放性，进而影响其长期采用的信心。

1.2 操作系统支持说明

在官方文档里，部署准备阶段找到如下说明:

https://www.kaiwudb.com/kaiwudb_docs/#/quickstart/install-kaiwudb/quickstart-bare-metal.html#%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F

个人认为这句话的初衷或许是希望保持一定的开放性，避免将用户完全拒之门外，但其措辞在实际应用中可能存在一定的风险。
从用户视角来看，“也许可以运行"这样的表述容易产生一种"可以试试"的心理暗示，尤其对于刚接触的新手，可能会理解为"虽然没有明确支持，但应该是能用的”。如果用户因此在不适配的操作系统上安装并投入生产环境，后续遇到性能不稳定、功能异常甚至数据安全等问题时，责任划分将变得十分模糊。
这句话客观上可能误导用户对"可用性"的判断，让用户误以为"能装上就是被允许的"。个人认为，如果官网能在措辞上更加明确，比如将这句话改为"仅在列出的操作系统上经过完整测试与支持，其他环境不建议用于生产"，既能保持严谨性，也能帮助用户建立正确的预期。毕竟，数据库是生产系统的核心基础设施，任何关于兼容性的表述都需要慎之又慎，模糊地带带来的往往是用户信任的流失。

1.3 软件依赖

https://www.kaiwudb.com/kaiwudb_docs/#/oss_dev/quickstart/install-kaiwudb/quickstart-bare-metal.html#%E8%BD%AF%E4%BB%B6%E4%BE%9D%E8%B5%96

官方文档里软件依赖部分，写的libgflags 使用系统默认版本，但安装时实际提示需要kwdb-server depends on libgflags2.2 (>= 2.2.2)。

建议写明软件依赖版本，类似于Oracle 11g安装文档部分:

https://docs.oracle.com/cd/E11882_01/install.112/e47689/pre_install.htm#BABCFJFG

Oracle Database Package Requirements for Linux x86-64
详细记录了每个操作系统类型、版本和对应的Package Requirements:

1.4 脚本部署

Management KaiwuDB user

在使用 deploy.sh 脚本部署 KaiwuDB 时，脚本会自动创建操作系统用户（如 kaiwudb），其用户 ID 和组 ID 由系统动态分配：

useradd -g $g_user -m -s /bin/bash $g_user

这种默认行为在涉及存在共享存储（如 NFS）的多节点场景下可能引发权限冲突：不同服务器上自动生成的 kaiwudb 用户的 UID/GID 可能不一致，导致某一节点写入的共享文件在其他节点上因用户 ID 不匹配而被视为“其他用户”，从而出现读写失败或权限拒绝的错误。
为保障跨节点数据访问的一致性，建议在脚本中增加参数选项，允许用户在创建用户时手动指定统一的 UID 和 GID，确保所有节点使用相同的标识符访问共享存储，从根本上避免因 ID 不一致带来的权限问题。

安装后台日志

在使用 deploy.sh 脚本部署 KaiwuDB 时，目前仅输出前台日志，缺乏完整的后台日志记录，这给安装过程的监控和问题排查带来了不便。一旦部署中途出错，用户只能看到屏幕上的有限输出，可能难以回溯具体是在哪个阶段、哪一步操作失败，也无法获取详细的错误上下文，尤其对于复杂环境下的部署，这种信息缺失大大增加了排障难度。建议脚本增加独立的日志文件输出功能，详细记录每个部署阶段（如环境检查、依赖安装、用户创建、配置文件生成、服务启动等）的具体操作、执行结果、开始与结束时间，以及关键输出或错误信息。这样既能帮助用户实时了解部署进度，也便于在出现问题时快速定位原因，提升部署体验和运维效率。

二:KaiwuDB介绍

KaiwuDB 是一款面向 AIoT 场景的分布式、多模融合、支持原生 AI 的数据库产品，支持同一实例同时建立时序库和关系库并融合处理多模数据，具备时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。面向工业物联网、数字能源、车联网、智慧产业等领域，KaiwuDB 提供一站式数据存储、管理与分析的基座。

2026年3月份，墨天轮中国数据库流行度排行，在20个时序数据库中，KaiwuDB排第二名，仅落后TDengine 36分。

从得分趋势来看，KaiwuDB热度，正处于上升阶段。

三:KaiwuDB 3.1.0 数据库一键部署

KaiwuDB 3.1.0 信息：

3.1 安装前准备

硬件要求

操作系统要求

但是，并不是每个版本都支持这些操作系统，以3.1.0版本为例:

通过安装介质名称来看，似乎只支持Ubuntu22.04、Windows、Mac操作系统。

说明:
未提及的操作系统版本也许可以运行 KWDB，但尚未得到 KWDB 官方支持。

本次使用Ubuntu 22.04.5 LTS操作系统:
下载Ubuntu 22.04.5 LTS操作系统:

https://ubuntu.com/download/server

https://ubuntu.com/download/alternative-downloads

下载 Ubuntu Desktop 22.04.5:
安装操作系统:

…

配置ssh

systemctl status ssh
apt install ssh
systemctl start ssh

操作系统信息:

root@cjc-db-09:~# cat /etc/os-release
PRETTY_NAME="Ubuntu 22.04.5 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.5 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=jammy

软件依赖

使用脚本部署时，KWDB 会对依赖进行检查。如果缺少依赖会退出安装并提示依赖缺失。如果目标机器不能联网，用户需要在能联网的机器上根据目标机器的操作系统下载好所有依赖文件，然后将依赖文件复制到目标机器上进行安装。
不同操作系统及安装包的依赖略有不同，请根据实际安装包类型及操作系统，在部署前安装好相应的依赖。下表列出需要在目标机器安装的依赖。

但实际上还需要安装 libgflags2.2，系统默认并没有安装，需要手动安装，报错如下:

Unpacking kwdb-server (3.1.0-ubuntu-22.04) ... 
dpkg: dependency problems prevent configuration of kwdb-server: 
kwdb-server depends on libgflags2.2 (>= 2.2.2); 
however: Package libgflags2.2 is not installed.

3.2 下载KaiwuDB 3.1.0 安装介质

获取安装包:
获取系统环境对应的 DEB 或 RPM 安装包，将安装包复制到待安装 KWDB 的目标机器上，然后解压缩安装包。

说明:
目前 KWDB 开源仓库提供了以下系统与架构的 DEB 或 RPM 安装包，如需其它系统或架构的安装包，请联系 KWDB 技术支持

Ubuntu V20.04 x86_64
Ubuntu V20.04 ARM_64

下载安装包:

https://www.kaiwudb.com/resource/

https://gitee.com/kwdb/kwdb/releases

下载:

KWDB-3.1.0-ubuntu22.04-intel-x86_64-debs.tar.gz

3.3 一键部署 KaiwuDB 3.1.0

查看安装介质:82MB

root@cjc-db-09:/soft# ls -lrth
total 82M
-rw-rw-r-- 1 cjc cjc 82M  2月 28 17:15 KWDB-3.1.0-ubuntu22.04-intel-x86_64-debs.tar.gz

解压安装介质:

root@cjc-db-09:/soft# tar -zxvf KWDB-3.1.0-ubuntu22.04-intel-x86_64-debs.tar.gz
root@cjc-db-09:/soft/kwdb_install# ls -lrth
total 44K
drwxr-xr-x 2 root root 4.0K  2月  2 18:18 utils
-rwxr-xr-x 1 root root  27K  2月  2 18:18 deploy.sh
-rw-r--r-- 1 root root  530  2月  2 18:18 deploy.cfg
-rwxr-xr-x 1 root root 2.0K  2月  2 18:18 add_user.sh
drwxr-xr-x 2 root root 4.0K  2月  2 18:35 packages

文件说明:

https://www.kaiwudb.com/kaiwudb_docs/#/oss_dev/quickstart/install-kaiwudb/quickstart-bare-metal.html#%E5%AE%89%E8%A3%85%E5%8C%85%E5%92%8C%E7%BC%96%E8%AF%91%E7%89%88%E6%9C%AC

脚本部署
部署和启动 KWDB
使用脚本部署 KWDB 时，系统将对配置文件、运行环境、硬件配置和软件依赖进行检查。如果相应硬件未能满足要求，系统将继续安装，并提示硬件规格不满足要求。如果软件依赖未能满足要求，系统将中止安装，并提供相应的提示信息。

安装libgflags2.2:

root@cjc-db-09:/soft/kwdb_install# apt install libgflags2.2

否则会报错:

执行单机部署安装命令:

./deploy.sh install --single

安装很快，不超过10秒。

3.4 安装后检查

启动:
启动 KWDB 节点

./deploy.sh start

查看状态:

root@cjc-db-09:/soft/kwdb_install# ./deploy.sh status
[STATUS COMPLETED]:KaiwuDB is runnning now.

root@cjc-db-09:/soft/kwdb_install# kw-status
  id |     address     |   sql_address   | build |            started_at            |            updated_at            |   locality   |    start_mode     | is_available | is_live
-----+-----------------+-----------------+-------+----------------------------------+----------------------------------+--------------+-------------------+--------------+----------
   1 | 127.0.0.1:26257 | 127.0.0.1:26257 | 3.1.0 | 2026-02-28 09:38:12.766979+00:00 | 2026-02-28 09:39:15.782976+00:00 | region=NODE1 | start-single-node | true         | true
(1 row)

登录数据库:

四:参考

KaiwuDB 文档中心:

https://www.kaiwudb.com/kaiwudb_docs/#/oss_dev/

KaiwuDB 版本说明:

https://gitee.com/kwdb/kwdb/releases

墨天轮:

https://www.modb.pro/dbRank

欢迎关注我的公众号《 IT小Chen》