个人博客Halo使用方法

安装

安装Halo的方法有多种,可以参考Halo文档

这里使用Docker Compose+mysql数据库部署

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

mkdir ~/halo && cd ~/halo

创建 docker-compose.yaml

~/halo/docker-compose.yaml

version: "3"

services:
  halo:
    image: halohub/halo:2.13
    container_name: halo
    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
    command:
      - --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
      - --spring.r2dbc.username=root
      # MySQL 的密码,请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - --spring.r2dbc.password=o#DwN&JSa56
      - --spring.sql.init.platform=mysql
      # 外部访问地址,请根据实际需要修改
      - --halo.external-url=http://localhost:8090/

  halodb:
    image: mysql:8.1.0
    container_name: halodb
    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
    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#DwN&JSa56
      - MYSQL_DATABASE=halo

networks:
  halo_network:

如果已经搭建过外部数据库,那么内容是这样

~/halo/docker-compose.yaml

version: "3"

services:
  halo:
    image: halohub/halo:2.13
    container_name: halo
    restart: on-failure:3
    network_mode: "host"
    volumes:
      - ./halo2:/root/.halo2
    command:
      # 修改为自己已有的 MySQL 配置
      - --spring.r2dbc.url=r2dbc:pool:mysql://localhost:3306/halo
      - --spring.r2dbc.username=root
      - --spring.r2dbc.password=
      - --spring.sql.init.platform=mysql
      # 外部访问地址,请根据实际需要修改
      - --halo.external-url=http://localhost:8090/
      # 端口号 默认8090
      - --server.port=8090
  1. 启动 Halo 服务

    docker-compose up -d
    

    实时查看日志:

    docker-compose logs -f
    
  2. 用浏览器访问 /console 即可进入 Halo 管理页面,首次启动会进入初始化页面。

使用

根据提示自行设置即可

通知设置

我使用的是QQ邮箱

SMTP 服务器地址 *

imap.qq.com

端口号 *

465

用户名: 填写你的 QQ 邮箱地址

密码: 填写你在邮箱设置中申请的 SMTP 授权码

主题

我选择的主题是Chirpy AirboZH/halo-theme-chirpy: 一个Halo生态,简约且功能丰富的技术博客主题。

主题使用文档

自定义信息

  • 您可以在Halo Console 设置-基本设置 中编辑站点标题和站点副标题和Logo,信息会同步修改在侧栏中

  • 您可以在Halo Console 设置-代码注入 中编辑页脚

图标

图标使用的是Font Awesome Free,你可以在这里找到所有的图标。

挑选到图标后可以在:

  1. 主题配置侧栏页的图标输入框填写图标数据

  1. 编辑菜单项的元数据中填写Key为icon的图标数据

下面提供一些常用图标

图标

代码

链接地址

标签

fas fa-tag

/tags

分类(交错线条)

fas fa-bars-staggered

/categories

归档(收件箱)

fas fa-inbox

/archives

哇哇哇哇哇哇哇哇