使用 Docker 部署(使用H2数据库)

概述

此文档介绍如何使用 Docker 部署 Halo 应用,默认使用 H2 数据库,适用于体验和测试环境。生产环境中不推荐使用 H2 数据库,因其可能因操作不当导致数据损坏。如果必须使用,建议定期备份数据

警告:如需使用其他数据库(如 PostgreSQL)部署,请参考官方文档使用 Docker Compose 部署

环境搭建

使用 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
梦葉樱 all right reserved,powered by Gitbook该文件最后修改时间: 2025-08-01 20:16:02

results matching ""

    No results matching ""