KaiwuDB 3.1.0 在 Ubuntu 22.04 的单机部署与 TLS 配置实践
KWDB 3.1.0 版本在运维脚本和配置管理上做了不少优化,让单机部署变得更加便捷。不过新手在环境适配、依赖缺失或配置不当方面仍容易遇到问题。本文以 Ubuntu 22.04 为基础环境,从实战角度出发,完整拆解 KWDB 3.1.0 单机部署的全流程,包括环境核查、依赖配置、脚本执行及性能验证,旨在帮助开发者快速落地并解决常见故障。
环境准备
系统信息核查
先确认基础环境是否符合要求。建议内存至少 4G(8G 更稳),磁盘预留 50G+(SSD 优于 HDD),文件系统推荐 ext4。
lsb_release -a
uname -a
lscpu | sed -n '1,20p'
free -h
df -hT
timedatectl status
端口检查
默认端口 26257 和 8080 需确保未被占用,避免冲突。
sudo ss -tuln | egrep '(:26257|:8080)\b' || true
若端口被占用,需在 deploy.cfg 中修改端口或停止占用服务。
目录规划
建议将安装包与数据目录分离,便于后续维护。
sudo mkdir -p /app/kwdb/{soft,data}
sudo chown -R "$USER":"$USER" /app/kwdb
cd /app/kwdb/soft
获取安装包
前往 Gitee Releases 页面下载对应版本包:https://gitee.com/kwdb/kwdb/releases
推荐使用 wget 直接下载至 /app/kwdb/soft 目录:
VERSION="3.1.0"
FILE="KWDB-${VERSION}-ubuntu22.04-intel-x86_64-debs.tar.gz"
URL="https://gitee.com/kwdb/kwdb/releases/download/V${VERSION}/${FILE}"
wget -O "$FILE" "$URL"
若习惯本地下载,也可通过 scp 或 WinSCP 上传至服务器。


