jamals86/kalamdb

KalamDB Docker镜像

KalamDB是一个SQL优先的实时后端。此镜像运行KalamDB服务器并包含KalamDB CLI工具，可在单个容器中启动本地服务器、完成认证并通过HTTP执行SQL。

• 官网：<[***]>
• 文档：<[***]>
• Docker文档：<[***]>
• API参考：<[***]>
• 源码：https://github.com/kalamstack/KalamDB

镜像内容

该镜像包含以下组件：

• kalamdb-server（服务器）
• kalam-cli（命令行工具）
• kalam（指向kalam-cli的符号链接）
• 默认服务器配置文件：/config/server.toml
• 持久化数据路径：/data

容器监听端口8080。

快速启动

本地启动KalamDB：

bash
docker run -d \
  --name kalamdb \
  -p 8080:8080 \
  -e KALAMDB_SERVER_HOST=0.0.0.0 \
  -e KALAMDB_ROOT_PASSWORD=kalamdb123 \
  -e KALAMDB_JWT_SECRET=replace-with-a-32-character-secret \
  -e KALAMDB_SECURITY_CORS_ALLOWED_ORIGINS="*" \
  -v kalamdb_data:/data \
  jamals86/kalamdb:latest

执行SQL操作

使用KALAMDB_ROOT_PASSWORD中设置的密码以root身份登录：

bash
TOKEN="$(
  curl -fsS -X POST http://localhost:8080/v1/api/auth/login \
    -H "Content-Type: application/json" \
    -d '{"user":"root","password":"kalamdb123"}' \
  | sed -n 's/.*"access_token":"\([^"]*\)".*/\1/p'
)"

也可使用镜像内置的CLI工具执行SQL：

bash
docker exec kalamdb kalam --url http://127.0.0.1:8080

或本地安装CLI工具：

bash
curl -fsSL https://kalamdb.org/install.sh | bash

然后连接数据库：

bash
kalam --url http://localhost:8080 --user root --password

Docker Compose部署

仓库提供本地运行的Docker Compose文件：

单节点部署

bash
curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/single/docker-compose.yml \
  -o docker-compose.yml

KALAMDB_JWT_SECRET=replace-with-a-32-character-secret docker compose up -d

单节点Compose将KalamDB暴露在：http://localhost:8088

3节点本地集群部署

bash
curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/cluster/docker-compose.yml \
  -o docker-compose.yml

KALAMDB_JWT_SECRET=replace-with-a-32-character-secret docker compose up -d

集群Compose暴露：

• 节点1 HTTP API：http://localhost:8081
• 节点2 HTTP API：http://localhost:8082
• 节点3 HTTP API：http://localhost:8083

数据持久化

KalamDB在容器内/data路径存储运行时数据。快速启动命令使用命名卷挂载：-v kalamdb_data:/data

• 停止容器但保留数据：docker stop kalamdb
• 删除容器但保留卷：docker rm kalamdb
• 删除容器和卷：docker rm -f kalamdb && docker volume rm kalamdb_data

常用命令

• 查看日志：docker logs -f kalamdb
• 进入容器shell：docker exec -it kalamdb bash
• 检查版本和帮助：

  bash
  docker exec kalamdb kalamdb-server --help
  docker exec kalamdb kalam --version
  docker exec kalamdb kalam --help
  

配置说明

本地Docker使用的常用环境变量：

如需更多配置，可挂载自定义服务器配置文件。详情见：<[***]>

后续步骤

• 阅读文档：<[***]>
• 查看API参考：<[***]>
• 浏览Docker部署文件：https://github.com/kalamstack/KalamDB/tree/main/docker/run