blacklabelops/hsqldb

用于软件开发的HSQLDB Docker镜像

![Circle CI]([***]

镜像版本：blacklabelops/hsqldb:latest

已安装软件：

• Java 8
• HSQLDB
• SQLTool

快速使用

该镜像可在开发环境中快速启动轻量级HSQLDB服务，用于本地测试与开发。

Docker Run示例

bash
docker run -d -p 9001:9001 --name hsqldb blacklabelops/hsqldb

启动后通过JDBC URL访问：jdbc:hsqldb:hsql://localhost/test，默认用户名sa，密码为空。

Docker Compose推荐

下载配置文件并修改环境变量：

bash
curl -O https://raw.githubusercontent.com/blacklabelops/hsqldb/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/blacklabelops/hsqldb/master/docker-compose.env
docker-compose up -d

https://github.com/blacklabelops/hsqldb/blob/master/docker-compose.env%E5%8C%85%E5%90%AB%E6%89%80%E6%9C%89%E6%94%AF%E6%8C%81%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%88%97%E8%A1%A8%E3%80%82

连接HSQLDB

通过UI连接

从容器复制UI文件并本地启动：

bash
docker cp hsqldb:/opt/hsqldb/hsqldb.jar .
java -jar hsqldb.jar

需本地安装Java JRE。UI中选择“HSQL Database Engine Server”，输入JDBC URL：jdbc:hsqldb:hsql://localhost/test（boot2docker需替换localhost为VM IP）。

使用SQLTool客户端

SQLTool是HSQLDB命令行客户端，文档见HSQLDB官方文档。

容器内连接

bash
docker exec -it hsqldb bash -c "java -jar /opt/hsqldb/sqltool.jar db"

挂载脚本目录连接

bash
docker run -it --rm \
  --link hsqldb:hsqldb \
  -v $(pwd)/dbscripts:/scripts \
  blacklabelops/hsqldb sqltool

/scripts目录为权限合适的卷。

主机连接（boot2docker）

先启动服务器指定主机IP：

bash
docker run -d --name hsqldb \
  -e "HSQLDB_DATABASE_HOST=192.168.99.100" \
  -p 9001:9001 \
  blacklabelops/hsqldb

sqltool.rc将包含正确主机地址。

主机执行：

bash
docker cp hsqldb:/opt/hsqldb .
cp ./hsqldb/sqltool.rc ~
java -jar ./hsqldb/sqltool.jar test

配置说明

设置用户名密码

通过环境变量指定：

bash
docker run -d --name hsqldb \
  -e "HSQLDB_USER=sa" \
  -e "HSQLDB_PASSWORD=password" \
  -p 9001:9001 \
  blacklabelops/hsqldb

默认用户sa，密码为空。

修改数据库别名

bash
docker run -d --name hsqldb \
  -e "HSQLDB_DATABASE_ALIAS=xdb" \
  -p 9001:9001 \
  blacklabelops/hsqldb

JDBC URL变为jdbc:hsqldb:hsql://localhost/xdb。

外部挂载数据库文件

bash
docker run -d --name hsqldb \
  -v $(pwd)/database:/opt/database \
  -p 9001:9001 \
  blacklabelops/hsqldb

$(pwd)为Linux当前目录命令。

额外HSQLDB参数

支持以下环境变量：

• 禁用跟踪：HSQLDB_TRACE=false
• 启用静默：HSQLDB_SILENT=true
• 禁用远程连接：HSQLDB_REMOTE=false
• 设置主机：HSQLDB_DATABASE_HOST=192.168.99.100

示例：

bash
docker run -d --name hsqldb \
  -e "HSQLDB_TRACE=false" \
  -e "HSQLDB_SILENT=true" \
  -e "HSQLDB_REMOTE=false" \
  -e "HSQLDB_DATABASE_HOST=192.168.99.100" \
  -p 9001:9001 \
  blacklabelops/hsqldb

Java虚拟机参数

设置JVM启动参数：

bash
docker run -d --name hsqldb \
  -e "JAVA_VM_PARAMETERS=-Xmx512m -Xms256m" \
  -p 9001:9001 \
  blacklabelops/hsqldb

需使用Java 8参数，参考JRE 8 Linux文档。

参考链接

• HSQLDB官方网站
• Docker官网
• Docker Compose文档
• Oracle Java 8