docker-h2

概述

docker-h2 是一个Docker化的H2数据库服务镜像，旨在提供便捷的H2数据库部署和运行环境，支持Web控制台访问、TCP连接及数据持久化存储。

核心功能与特性

• 基于 OpenJDK官方镜像 构建
• 数据存储目录固定为 /opt/h2-data
• 整合了 zhilvis/docker-h2 和 zilvinasu/h2-dockerfile 的实现

2.x版本说明

2.x主要版本包含多项变更，包括信息模式表（information schema tables）的调整。为兼容v1版本的信息模式（因相关线上资料较少），h2.server.properties 中新增配置项 OLD_INFORMATION_SCHEMA=true，可启用v1版本的信息模式。

该属性的使用方式可参考H2源码中 SessionRemote.java 的构造函数：<[***]>

可信构建

Docker Hub上的 自动构建 版本包括：

• latest, 2.3.232 (2.3.232/Dockerfile)
• 2.2.224 (2.2.224/Dockerfile)
• 2.1.210 (2.1.210/Dockerfile)
• 2.0.204 (2.0.204/Dockerfile)
• 1.4.199 (1.4.199/Dockerfile)
• 1.1.119 (1.1.119/Dockerfile)
• alpine (alpine/Dockerfile)
• geodb (geodb/Dockerfile)

使用方法

拉取镜像

docker pull oscarfonts/h2

运行容器

基本部署（端口映射与数据持久化）

暴露TCP数据库端口（1521）和Web控制台端口（81），并挂载数据卷以持久化存储：

docker run -d -p 1521:1521 -p 81:81 -v /path/to/local/data_dir:/opt/h2-data --name=MyH2Instance oscarfonts/h2

自定义配置（环境变量方式）

通过 H2_OPTIONS 环境变量添加额外启动参数（如允许连接时自动创建数据库）：

docker run -d -p 1521:1521 -p 81:81 -v /path/to/local/data_dir:/opt/h2-data -e H2_OPTIONS=-ifNotExists --name=MyH2Instance oscarfonts/h2

注意：-ifNotExists 选项在 1.1.119 版本中不可用，详情参见 H2数据库issue #1894。

访问Web控制台

Web控制台地址：http://localhost:81

查看容器日志

docker logs -f MyH2Instance

命令行界面（CLI）访问

镜像中提供 h2cli 脚本用于CLI访问（已加入 $PATH），支持以下参数：

• -u/--user：登录用户（默认：sa）
• -d/--dbname：数据库名称（默认：test）
• -p/--port：连接端口（默认：1521）

注意：alpine 版本镜像不包含CLI功能。