Docker Compose 部署

环境搭建

• Docker 安装文档：docs.docker.com/engine/inst…
• Docker Compose 安装文档：docs.docker.com/compose/ins…

目前下载Docker，自带Docker Compose

是否安装： docker compose
docker compose version
    

创建容器组

• halohub/halo

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

2. halo下创建 docker-compose.yaml

创建 Halo + MySQL 的实例：

version: "3"

services:
  halo:
    image: halohub/halo:2.4
    container_name: halo
    restart: on-failure:3
    depends_on:
      halodb:
        condition: service_healthy
    networks:
      halo_network:
    volumes:
      - ./:/root/.halo2
    ports:
      - "8090:8090"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 30s
    command:
      - --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
      - --spring.r2dbc.username=root
      # MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - --spring.r2dbc.password=o#123456
      - --spring.sql.init.platform=mysql
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://localhost:8090/
      # 初始化的超级管理员用户名
      - --halo.security.initializer.superadminusername=admin
      # 初始化的超级管理员密码
      - --halo.security.initializer.superadminpassword=P@88w0rd

  halodb:
    image: mysql:8.0.31
    container_name: halodb
    restart: on-failure:3
    networks:
      halo_network:
    command: 
      - --default-authentication-plugin=mysql_native_password
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_general_ci
      - --explicit_defaults_for_timestamp=true
    volumes:
      - ./mysql:/var/lib/mysql
      - ./mysqlBackup:/data/mysqlBackup
    ports:
      - "3306:3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent"]
      interval: 3s
      retries: 5
      start_period: 30s
    environment:
      # 请修改此密码，并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
      - MYSQL_ROOT_PASSWORD=o#123456
      - MYSQL_DATABASE=halo

networks:
  halo_network:

参数详解：

参数名	描述
spring.r2dbc.url	数据库连接地址，详细可查阅下方的 数据库配置
spring.r2dbc.username	数据库用户名
spring.r2dbc.password	数据库密码
spring.sql.init.platform	数据库平台名称，支持 postgresql、mysql、h2，需要与 SPRING_R2DBC_URL 对应
halo.external-url	外部访问链接，如果需要在公网访问，需要配置为实际访问地址
halo.security.initializer.superadminusername	初始超级管理员用户名
halo.security.initializer.superadminpassword	初始超级管理员密码

1. 启动 Halo 服务

   docker-compose up -d
   

   实时查看日志：

   docker-compose logs -f
   

用浏览器访问 $HALO_EXTERNAL_URL/console/（外部访问链接）即可进入 Halo 管理端。管理员用户名为 admin，登录密码为上方设置的 HALO_SECURITY_INITIALIZER_SUPERADMINPASSWORD。

浏览器访问： http://localhost:8090/

更新容器组

1. 停止运行中的容器组

   cd ~/halo && docker-compose down
   

2. 备份数据（重要）

   cp -r ~/halo ~/halo.archive
   

   需要注意的是，halo.archive 文件名不一定要根据此文档命名，这里仅仅是个示例。

3. 更新 Halo 服务

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

   services:
     halo:
       image: halohub/halo:2.4
       container_name: halo
   

   docker-compose pull halo
   

   docker-compose up -d