liaobaikai/kingbase

Kingbase Docker镜像文档

镜像概述

liaobaikai/kingbase:8.7.3-0160是Kingbase ES V8数据库的Docker镜像，用于便捷部署Kingbase数据库服务。该镜像支持通过环境变量配置数据库参数，数据持久化存储，并可灵活映射端口，适用于开发、测试及生产环境的数据库部署需求。

核心功能与特性

• 数据持久化：通过挂载主机目录实现数据库数据持久化，避免容器重启导致数据丢失。
• 环境变量配置：支持通过环境变量设置数据库密码（KINGBASE_PASSWORD）、大小写不敏感模式（KINGBASE_CASE_INSENSITIVE）等参数。
• 端口映射：可自定义映射容器内数据库端口（默认54321）到主机端口，满足多实例部署需求。
• 快速部署：简化部署流程，通过简单命令即可完成Kingbase数据库实例的创建与运行。

使用场景

• 开发环境：快速搭建本地Kingbase数据库进行应用开发测试。
• 测试环境：部署独立的数据库实例用于功能测试或性能测试。
• 生产环境：结合数据持久化和适当配置，可用于生产环境的数据库服务部署。

使用方法与配置说明

前置准备

1. 创建并配置数据目录（需确保权限）：

   bash
   sudo rm -rf /kingbase/  # 若需清理旧数据（可选）
   sudo mkdir -p /kingbase/data 
   sudo chmod -R 777 /kingbase/  # 赋予目录读写权限
   

基本部署示例（docker run）

示例1：设置密码并映射端口

bash
docker run -dit --name kingbase \
  -e KINGBASE_PASSWORD=Aa123456 \  # 设置数据库密码
  -v /kingbase/data:/opt/Kingbase/ES/V8/data \  # 挂载数据目录
  -p 54321:54321 \  # 映射主机端口54321到容器端口54321
  liaobaikai/kingbase:8.7.3-0160

示例2：启用大小写不敏感模式

bash
docker run -dit --name kingbase2 \
  -v /kingbase2/data:/opt/Kingbase/ES/V8/data \  # 不同数据目录，支持多实例
  -e KINGBASE_CASE_INSENSITIVE=1 \  # 启用大小写不敏感模式（1为启用）
  -p 54322:54321 \  # 映射主机端口54322到容器端口54321（多实例端口区分）
  liaobaikai/kingbase:8.7.3-0160

关键配置参数说明

验证部署

容器启动后，可通过以下命令检查状态：

bash
docker ps  # 查看容器是否运行
docker logs kingbase  # 查看容器日志，确认数据库启动状态

注意事项

• 数据目录权限：需确保主机数据目录有足够权限（如示例中的777），避免容器内进程无法读写数据。
• 多实例部署：通过不同数据目录和端口映射可部署多个独立的Kingbase实例。
• 密码安全：生产环境中建议使用更复杂的密码，并避免明文传递，可考虑使用Docker Secrets等安全方式管理敏感信息。