使用 Docker 部署(使用H2数据库)
概述
此文档介绍如何使用 Docker 部署 Halo 应用,默认使用 H2 数据库,适用于体验和测试环境。生产环境中不推荐使用 H2 数据库,因其可能因操作不当导致数据损坏。如果必须使用,建议定期备份数据。
警告:如需使用其他数据库(如 PostgreSQL)部署,请参考官方文档使用 Docker Compose 部署。
环境搭建
- Docker 安装:请参考官方文档 在Debian12上安装Docker · GitBook
使用 Docker 镜像
1. 创建容器
运行以下命令以创建并启动 Halo 容器:
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 -e JVM_OPTS="-Xmx256m -Xms256m" registry.fit2cloud.com/halo/halo:2.21
说明:此命令使用默认的 H2 数据库。如需使用 PostgreSQL,请参考官方文档使用 Docker Compose 部署。
命令参数说明:
-it
:启用交互式终端并分配伪终端。-d
:后台运行容器。--name
:指定容器名称(如halo
)。-p
:端口映射,格式为主机端口:容器端口
,可在application.yaml
中配置。-v
:工作目录映射,格式为 宿主机路径:/root/.halo2
,容器内路径 :/root/.halo2
不可更改。-e JVM_OPTS
:设置 JVM 参数,例如内存分配。
2. 访问 Halo 管理页面
使用浏览器访问 http://服务器IP:8090/console
,首次访问将进入初始化页面。
提示:
如果需要配置域名访问,建议在初始化前配置好反向代理和域名解析。
如果通过
http://服务器IP:8090
无法访问,请检查:
- 服务器安全组是否已开放 8090 端口。
- 若使用 Linux 面板,检查面板的安全组配置,确保端口已添加。
升级版本
1. 备份数据
在升级前,建议参考官方文档备份与恢复进行完整备份。
2. 拉取新版本镜像
docker pull registry.fit2cloud.com/halo/halo:2.21
3. 停止并删除现有容器
docker stop halo
docker rm halo
4. 重新创建容器
使用与创建容器相同的命令,替换为新版本号(如果有更新):
docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 registry.fit2cloud.com/halo/halo:2.21