oscarfonts/h2

docker-h2

概述

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

核心功能与特性

• 基于 https://hub.docker.com/r/_/openjdk/ 构建
• 数据存储目录固定为 /opt/h2-data
• 整合了 https://github.com/zhilvis/docker-h2 和 https://github.com/zilvinasu/h2-dockerfile 的实现

2.x版本说明

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

该属性的使用方式可参考H2源码中 SessionRemote.java 的构造函数：https://github.com/h2database/h2database/blob/master/h2/src/main/org/h2/engine/SessionRemote.java

可信构建

Docker Hub上的 https://hub.docker.com/r/oscarfonts/h2/ 版本包括：

• https://github.com/oscarfonts/docker-h2/blob/master/2.3.232/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/2.2.224/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/2.1.210/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/2.0.204/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/1.4.199/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/1.1.119/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/alpine/Dockerfile
• https://github.com/oscarfonts/docker-h2/blob/master/geodb/Dockerfile

使用方法

拉取镜像

bash
docker pull oscarfonts/h2

运行容器

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

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

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

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

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

bash
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 版本中不可用，详情参见 https://github.com/h2database/h2database/issues/1894%E3%80%82

访问Web控制台

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

查看容器日志

bash
docker logs -f MyH2Instance

命令行界面（CLI）访问

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

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

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