使用 Docker 部署 Halo 博客系统

:::info
项目地址： https://github.com/halo-dev/halo

:::

一、Halo 介绍

1）Halo 简介

Halo 是一款强大易用的开源建站工具，它让你无需太多的技术知识就可以快速搭建一个博客、网站或者内容管理系统。具备可插拔架构、主题套用、富文本编辑器等多重特性，支持用户根据自己的喜好选择不同类型的插件及主题模板来定制化自己的站点功能及外观。让内容创作和发布更加便捷生动。

:::info
在线体验

:::

• 环境地址：https://demo.halo.run
• 后台地址：https://demo.halo.run/console
• 用户名：demo
• 密码：P@ssw0rd123...

2）Halo 特点

• 使用 Spring Boot 框架，方便部署和更新。
• 完备的 Markdown 编辑器以及文章/页面系统，包含分类/标签/预览图等。
• 内置图库，需要主题支持。
• 完备的附件管理。
• 比较完备的评论系统，内置的评论系统还需要不断完善，另外还支持部分三方评论系统（ 如 Valine，Disqus 等 ），可以随意切换，支持任何主题。
• 完备的模板（主题）系统（目前已有四款主题）。
• 完善的系统设置，包括 SEO，文章设置，评论设置，邮箱设置等。

3）本次实践说明

1. 本次部署 Halo 版本为 Halo V2.11.0 版本，与 V1 版本安装有所不同。
2. 本次部署为日常个人使用或测试，生产环境请勿使用。

二、检查本地 Docker 环境

1）检查 Docker 版本

// 1) 低版本 Docker 安装
yum install docker -y

----
// < '推荐' >
// 2) 高版本 Docker 安装
curl -fsSL https://get.docker.com/ | sh

----
// 关闭防火墙
systemctl disable --now firewalld
setenforce 0

// 启用 Docker
systemctl enable --now docker

----
// 3) 安装 Docker-Compose
curl -L https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose -v

2）检查 Docker 状态

systemctl status docker

3）检查 Docker compose 版本

docker-compose -v

三、下载 Halo 镜像

docker pull halohub/halo:2.11.0

四、下载 application.yaml 文件

1）创建数据目录

mkdir -p /data/halo/.halo2 && mkdir -p /data/halo/mysql && cd /data/halo

2）下载 application.yaml

wget https://dl.halo.run/config/application-template.yaml --no-check-certificate -O ./application.yaml

3）复制 application.yaml 文件

[root@blog halo] cp application.yaml .halo2/

五、使用 Docker-Cli 部署 Halo

1）Docker-Cli 部署 Halo

docker run \
  -it -d \
  --name halo \
  -p 8090:8090 \
  -v ~/.halo2:/root/.halo2 \
  -e HALO_EXTERNAL_URL=http://localhost:8090/ \
  -e HALO_SECURITY_INITIALIZER_SUPERADMINUSERNAME=admin \
  -e HALO_SECURITY_INITIALIZER_SUPERADMINPASSWORD=P@ssw0rd123456 \
  halohub/halo:2.11.0

2）相关参数解释

**注意：**此命令默认使用自带的 H2 Database 数据库。如需使用 PostgreSQL，请参考：使用 Docker Compose 部署
-it：开启输入功能并连接伪终端

-d：后台运行容器

--name：为容器指定一个名称

-p：端口映射，格式为 主机(宿主)端口:容器端口，可在 application.yaml 配置。

-v：工作目录映射。形式为：-v 宿主机路径：/root/.halo2，后者不能修改。

-e：环境变量

HALO_EXTERNAL_URL：外部可访问的链接。例如：https://域名/

HALO_SECURITY_INITIALIZER_SUPERADMINPASSWORD：超级管理员用户（admin）的初始化密码。如果该环境变量没有设置，系统将会生成随机密码并打印在日志中。

六、开启 ipv4.ip_forward

1）开启 ipv4.ip_forward

在 /usr/lib/sysctl.d/00-system.conf 文件中添加 net.ipv4.ip_forward=1

vim /usr/lib/sysctl.d/00-system.conf
# Kernel sysctl configuration file
#
# For binary values, 0 is disabled, 1 is enabled.  See sysctl(8) and
# sysctl.conf(5) for more details.

# Disable netfilter on bridges.
net.bridge.bridge-nf-call-ip6tables = 0
net.bridge.bridge-nf-call-iptables = 0
net.bridge.bridge-nf-call-arptables = 0
net.ipv4.ip_forward=1

2）重启 Docker 服务

systemctl restart network && systemctl restart docker

七、部署 Halo 博客系统

1）编辑 docker-compose.yaml

[root@blog halo] vim docker-compose.yaml 
version: "3"

services:
  halo:
    image: halohub/halo:2.11.0
    container_name: halo
    restart: always
    depends_on:
      halodb:
        condition: service_healthy
    networks:
      halo_network:
    volumes:
      - /data/halo/.halo2:/root/.halo2
    ports:
      - "8930:8090"
    environment:
      - SPRING_R2DBC_URL=r2dbc:pool:mysql://halodb:3306/halo
      - SPRING_R2DBC_USERNAME=root
      # MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - SPRING_R2DBC_PASSWORD=P@ssw0rd
      - SPRING_SQL_INIT_PLATFORM=mysql
      # 外部访问地址，请根据实际需要修改
      - HALO_EXTERNAL_URL=http://192.168.80.8:8930/
      # 初始化的超级管理员用户名
      - HALO_SECURITY_INITIALIZER_SUPERADMINUSERNAME=admin
      # 初始化的超级管理员密码
      - HALO_SECURITY_INITIALIZER_SUPERADMINPASSWORD=halo

  halodb:
    image: mysql:8.0.27
    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=halo
      - MYSQL_DATABASE=halo

networks:
  halo_network:

2）创建 Halo 相关容器

docker compose up -d

docker start halo halodb

3）查看 Halo 容器状态

docker ps -a

八、Halo 的初始化配置

1）进入 Halo 首页

:::info
http://192.168.80.8:8090/console/setup

:::

2）设置站点名称

登录 Halo 后台，设置站点名称，并选择初始化。

九、访问 Halo 博客系统

1）进入 Halo 后台首页

2）Halo 系统设置

3）插件安装

4）安装 Halo 主题

5）查看主题效果