使用 Docker 部署 Halo 博客系统

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

:::

一、Halo 介绍

1)Halo 简介

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

:::info
在线体验

:::

2)Halo 特点

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

3)本次实践说明

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

二、检查本地 Docker 环境

1)检查 Docker 版本

bash 复制代码
// 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 状态

bash 复制代码
systemctl status docker

3)检查 Docker compose 版本

bash 复制代码
docker-compose -v

三、下载 Halo 镜像

bash 复制代码
docker pull halohub/halo:2.11.0

四、下载 application.yaml 文件

1)创建数据目录

bash 复制代码
mkdir -p /data/halo/.halo2 && mkdir -p /data/halo/mysql && cd /data/halo

2)下载 application.yaml

bash 复制代码
wget https://dl.halo.run/config/application-template.yaml --no-check-certificate -O ./application.yaml

3)复制 application.yaml 文件

bash 复制代码
[root@blog halo] cp application.yaml .halo2/

五、使用 Docker-Cli 部署 Halo

1)Docker-Cli 部署 Halo

bash 复制代码
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

bash 复制代码
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 服务

bash 复制代码
systemctl restart network && systemctl restart docker

七、部署 Halo 博客系统

1)编辑 docker-compose.yaml

bash 复制代码
[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 相关容器

bash 复制代码
docker compose up -d

docker start halo halodb

3)查看 Halo 容器状态

bash 复制代码
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)查看主题效果

相关推荐
Karoku06631 分钟前
【企业级分布式系统】Zabbix监控系统与部署安装
运维·服务器·数据库·redis·mysql·zabbix
为什么这亚子34 分钟前
九、Go语言快速入门之map
运维·开发语言·后端·算法·云原生·golang·云计算
布值倒区什么name1 小时前
bug日常记录responded with a status of 413 (Request Entity Too Large)
运维·服务器·bug
。puppy2 小时前
HCIP--3实验- 链路聚合,VLAN间通讯,Super VLAN,MSTP,VRRPip配置,OSPF(静态路由,环回,缺省,空接口),NAT
运维·服务器
颇有几分姿色2 小时前
深入理解 Linux 内存管理:free 命令详解
linux·运维·服务器
光芒再现dev2 小时前
已解决,部署GPTSoVITS报错‘AsyncRequest‘ object has no attribute ‘_json_response_data‘
运维·python·gpt·语言模型·自然语言处理
AndyFrank2 小时前
mac crontab 不能使用问题简记
linux·运维·macos
成都古河云3 小时前
智慧场馆:安全、节能与智能化管理的未来
大数据·运维·人工智能·安全·智慧城市
算法与编程之美3 小时前
文件的写入与读取
linux·运维·服务器
Amelio_Ming4 小时前
Permissions 0755 for ‘/etc/ssh/ssh_host_rsa_key‘ are too open.问题解决
linux·运维·ssh