buildo/h2database

H2数据库Docker镜像

镜像概述和主要用途

本镜像为H2 Database Engine提供Docker化部署方案。H2是一款轻量级嵌入式关系型数据库，支持内存和磁盘存储模式，具备高效、易用的特点，广泛应用于开发、测试及小型应用场景。

版本信息

当前仅构建最新稳定版镜像，根据H2官网下载页，版本为1.4.195（2017-04-23）。

核心功能和特性

• 暴露默认TCP端口9092，支持标准JDBC连接
• 内置Web管理界面，默认端口8082
• 支持环境变量配置数据库文件存储路径
• 提供初始化脚本机制，自动执行.sql和.sh脚本完成数据库初始化

使用场景和适用范围

• 开发环境中快速搭建轻量级数据库服务
• 测试环境需要临时数据库实例
• 嵌入式应用或微服务的本地数据存储
• 教学或演示场景中需要简单部署的数据库

使用方法和配置说明

基本运行方式

通过以下命令启动H2数据库容器：

sh
docker run --name my-h2 -d buildo/h2database

容器默认暴露TCP端口9092，可通过容器链接使其他容器自动访问。从其他容器连接的JDBC字符串格式：

jdbc:h2:tcp://my-h2/my-db-name

使用Web管理界面

若需访问H2 Web界面，需绑定8082端口：

sh
docker run --name my-h2 -p 8082:8082 -d buildo/h2database

在浏览器中打开http://localhost:8082/，使用以下连接参数：

• 驱动类：org.h2.Driver
• JDBC URL：jdbc:h2:my-db-name
• 用户名：（留空）
• 密码：（留空）

环境变量配置

• H2DATA：指定数据库文件存储路径。未设置时默认使用/h2-data，该路径会自动创建为***Docker卷。

示例：指定自定义数据存储路径

sh
docker run --name my-h2 -e H2DATA=/custom-path -d buildo/h2database

初始化脚本

本镜像采用与https://hub.docker.com/_/postgres/%E7%B1%BB%E4%BC%BC%E7%9A%84%E5%88%9D%E5%A7%8B%E5%8C%96%E6%9C%BA%E5%88%B6%EF%BC%9A

1. 在容器内创建/docker-entrypoint-initdb.d目录（若不存在）
2. 放置一个或多个*.sql或*.sh脚本到该目录
3. 容器启动时，入口脚本会自动执行所有*.sql文件并加载*.sh脚本

SQL脚本使用

*.sql文件名将作为数据库名称。例如，创建/docker-entrypoint-initdb.d/baz.sql文件：

sql
CREATE TABLE FOOBAR (ID INT PRIMARY KEY);

容器启动时会自动创建名为baz的数据库，并执行该脚本创建FOOBAR表。

Shell脚本使用

对于复杂初始化操作，可使用.sh脚本。例如创建/docker-entrypoint-initdb.d/init.sh：

sh
#!/bin/bash

java -cp /h2/bin/h2.jar org.h2.tools.RunScript \
  -script /docker-entrypoint-initdb.d/baz \
  -url "jdbc:h2:/h2-data/custom-db-name"

确保脚本具有可执行权限，容器启动时将自动执行该脚本。