xiexiangyu/kingbase

人大金仓数据库Docker镜像文档

镜像概述

本镜像基于人大金仓数据库KingbaseES_V008R006C006B0021_Lin64版本构建，旨在提供便捷的数据库部署和运行环境。通过Docker容器化方式，简化人大金仓数据库的安装配置流程，支持灵活的参数自定义，适用于开发、测试及小型生产环境。

核心功能与特性

• 版本固定：基于KingbaseES_V008R006C006B0021_Lin64版本构建，确保数据库版本一致性
• 灵活配置：支持通过环境变量自定义数据库关键参数
• 多编码支持：提供UTF8、GBK、GB***等多种数据库编码选项
• 多兼容模式：支持兼容PostgreSQL模式（pg/0）和Oracle模式（oracle/1），高版本还支持MySQL模式
• 大小写敏感性控制：可配置数据库大小写敏感特性（仅Oracle模式下支持不敏感）
• 块大小自定义：支持初始化时设置数据库块大小（1-32KB，2的整数次幂）

使用场景

• 开发环境快速搭建：无需复杂安装流程，一键启动数据库实例
• 测试环境配置验证：便捷测试不同编码、兼容模式下的应用兼容性
• 小型生产环境部署：适合数据量不大、对部署便捷性要求高的场景
• 教学与演示：快速构建标准化的人大金仓数据库环境

使用方法与配置说明

环境变量配置

Docker Run部署示例

bash
docker run -d \
  --name kingbase \
  -p 54321:54321 \
  -e DB_USER=sysadmin \
  -e DB_PASSWORD=MySecurePass123 \
  -e ENCODING=GBK \
  -e DB_MODE=oracle \
  -e ENABLE_CI=NO \
  -e BLOCK_SIZE=16 \
  kingbase-es:v8.6.6.21

Docker Compose配置示例

yaml
version: '3'
services:
  kingbase:
    image: kingbase-es:v8.6.6.21
    container_name: kingbase
    ports:
      - "54321:54321"
    environment:
      - DB_USER=sysadmin
      - DB_PASSWORD=MySecurePass123
      - ENCODING=UTF8
      - DB_MODE=pg
      - ENABLE_CI=YES
      - BLOCK_SIZE=8
    volumes:
      - kingbase_data:/opt/kingbase/data
    restart: unless-stopped

volumes:
  kingbase_data:

使用说明

1. 启动容器后，数据库服务将在容器内的54321端口运行，可通过宿主机映射端口访问
2. 首次启动时会自动初始化数据库，根据环境变量配置完成参数设置
3. 建议通过持久化卷（volume）挂载数据库数据目录，避免容器删除导致数据丢失
4. 生产环境中必须修改默认密码（DB_PASSWORD），并根据实际需求调整编码和兼容模式
5. 如需更改块大小（BLOCK_SIZE），需在首次初始化时设置，后续无法修改