使用飞牛云记录一次建站的过程

关键的是docker-compose 和数据库的连接

官网教程： 使用 Docker Compose 部署 | Halo 文档

一、环境准备

系统要求：飞牛云 fnOS 0.8.41

二、安装 Docker 与 Docker Compose

1. 安装 Docker

飞牛云内置，无需安装

2. 安装 Docker Compose

飞牛云内置。注意 docker compose 是新版本，老版本的"docker-compose"相关的命令无法使用

三、创建项目目录与配置文件

1. 新建项目目录

mkdir ~/halo && cd ~/halo

2. 创建 docker-compose.yml 文件

version: "3"

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.20
    restart: on-failure:3
    depends_on:
      halodb:
        condition: service_healthy
    networks:
      halo_network:
    volumes:
      - ./halo2:/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
    environment:
      # JVM 参数，默认为 -Xmx256m -Xms256m，可以根据实际情况做调整，置空表示不添加 JVM 参数
      - JVM_OPTS=-Xmx256m -Xms256m
    command:
      - --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
      - --spring.r2dbc.username=root
      # MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - --spring.r2dbc.password=改成你的mysql密码
      - --spring.sql.init.platform=mysql
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://localhost:8090/

  halodb:
    image: mysql:8.0.41-debian
    restart: on-failure:3
    networks:
      halo_network:
    command: 
      - --default-authentication-plugin=caching_sha2_password
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_general_ci
      - --explicit_defaults_for_timestamp=true
    volumes:
      - ./mysql:/var/lib/mysql
      - ./mysqlBackup:/data/mysqlBackup
    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=改成你的mysql密码
      - MYSQL_DATABASE=halo
    cap_add:
      - SYS_NICE

networks:
  halo_network:

四、启动服务

1. 启动容器

docker compose up -d

2. 检查运行状态

docker compose ps
# 应看到两个服务状态为 "running"

五、初始化 Halo 博客

1. 打开浏览器访问：http://127.0.0.1:8090

2. 按照向导完成管理员账号设置

3. 选择 MySQL 数据库（系统已自动配置）

六、关键配置说明

1. 数据库连接参数

• URL中的 halo 对应 Docker 服务名

2. 数据持久化

• halo2 卷存储主题/插件/配置文件

• mysql 卷确保数据库不丢失

七、日常维护命令

1. 停止服务

docker compose down

2. 更新 Halo 版本

docker compose pull halo
docker compose up -d

3. 查看日志

docker compose logs -f halo

八、其他

1. 配置 Nginx 反向代理并启用 HTTPS

2. 定期执行数据库备份：