官网链接

一、使用 Docker Compose 部署

1、创建容器

1. 在系统任意位置创建一个文件夹，此文档以 ~/halo 为例。

   mkdir ~/halo && cd ~/halo

   信息

   注意：后续操作中，Halo 产生的所有数据都会保存在这个目录，请妥善保存。

2. 创建 docker-compose.yaml

   此文档提供几种场景的 Docker Compose 配置文件，请根据你的需要选择一种。

   • 使用外部数据库

3. ~/halo/docker-compose.yaml

   services:
     halo:
       image: registry.fit2cloud.com/halo/halo:2.24
       restart: on-failure:3
       network_mode: "host"
       volumes:
         - ./halo2:/root/.halo2
       environment:
         # JVM 参数，默认为 -Xmx256m -Xms256m，可以根据实际情况做调整，置空表示不添加 JVM 参数
         - JVM_OPTS=-Xmx256m -Xms256m
       command:
         # 修改为自己已有的 MySQL 配置
         - --spring.r2dbc.url=r2dbc:pool:mysql://你的IP:13306/halo
         - --spring.r2dbc.username=root
         - --spring.r2dbc.password=你的密码
         - --spring.sql.init.platform=mysql
         # 外部访问地址，请根据实际需要修改
         - --halo.external-url=http://你的IP:8090/
         # 端口号 默认8090
         - --server.port=8090

   信息

   使用外部数据库时，需要提前手动创建好数据库，以 MySQL 为例：

   create database halo character set utf8mb4 collate utf8mb4_bin;

4. 启动 Halo 服务

   docker compose up -d

   实时查看日志：

   docker-compose logs -f

用浏览器访问 /console 即可进入 Halo 管理页面，首次启动会进入初始化页面。

2、升级 Halo

1. 备份数据，可以参考 备份与恢复 进行完整备份（可选，但推荐备份）。

2. 更新 Halo 服务

   修改 docker-compose.yaml 中配置的镜像版本。

   services:
    halo:
      image: registry.fit2cloud.com/halo/halo-pro:2.24

   docker compose up -d