Halo部署教程

本站点使用Docker Compose部署参考：官方部署教程

环境搭建

系统：Centos7.9

安装 Docker

卸载旧版本（若有）

旧版本的 Docker 被称为 docker 或者 docker-engine，使用下面的命令卸载：

sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

设置仓库

安装所需的软件包：

sudo yum install -y yum-utils

设置 Docker 的稳定仓库：

sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

安装 Docker 引擎

安装最新版本的 Docker 引擎、容器运行时和 Docker Compose：

sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

将Docker的镜像仓库更换为halo官方维护的镜像源(可以忽略，docker-compose.yaml中可以指定镜像源)

创建或编辑配置文件：

使用文本编辑器打开/etc/docker/daemon.json文件，如果该文件不存在则创建它。
```
sudo vi /etc/docker/daemon.json
```

添加或修改仓库地址：

在daemon.json文件中，添加或修改registry-mirrors字段，将其值设置为你想要的仓库地址。示例内容如下：
```
{
    "registry-mirrors": ["https://registry.fit2cloud.com", "https://halohub", "https://ghcr.io"]
}
```
保存并关闭文件。

配置完成后，就可以使用 Halo 镜像了。例如，拉取 halohub/halo 镜像：

docker pull halohub/halo

启动 Docker

安装完成后，启动 Docker 服务：

sudo systemctl start docker

设置 Docker 开机自启：

sudo systemctl enable docker

验证安装

查看docker版本来验证 Docker 是否正确安装：

docker --version

安装 Docker Compose

使用 Docker 插件（推荐）

如果你在安装 Docker 时已经安装了 docker-compose-plugin，那么 Docker Compose 已经可用。可以通过以下命令验证：

docker compose version

初始化Halo运行目录

mkdir /home/halo && cd /home/halo

创建docker-compose.yaml

version: "3"

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.19
    container_name: halo
    restart: on-failure:3
    network_mode: "host"
    volumes:
      - ./:/root/.halo2
    command:
      - --spring.r2dbc.url=r2dbc:pool:mysql://localhost:3306/blog?usessl=false
      - --spring.r2dbc.username=*****
      # MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - --spring.r2dbc.password=*****
      - --spring.sql.init.platform=mysql
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=https://vvhz.com/
      # 初始化的超级管理员用户名
      - --halo.security.initializer.superadminusername=****
      # 初始化的超级管理员密码
      - --halo.security.initializer.superadminpassword=*****
      - --server.port=8099

启动Halo服务

docker-compose up -d

实时查看日志

docker-compose logs -f

更新容器组

可以提前备份数据

更新Halo服务

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

例如：

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.20

修改完重新启动