个人博客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启动 Halo 服务
docker-compose up -d实时查看日志:
docker-compose logs -f用浏览器访问 /console 即可进入 Halo 管理页面,首次启动会进入初始化页面。
使用
根据提示自行设置即可
通知设置
我使用的是QQ邮箱
SMTP 服务器地址 *
端口号 *
465
用户名: 填写你的 QQ 邮箱地址
密码: 填写你在邮箱设置中申请的 SMTP 授权码

主题
我选择的主题是Chirpy AirboZH/halo-theme-chirpy: 一个Halo生态,简约且功能丰富的技术博客主题。
主题使用文档
自定义信息
您可以在Halo Console
设置-基本设置中编辑站点标题和站点副标题和Logo,信息会同步修改在侧栏中您可以在Halo Console
设置-代码注入中编辑页脚
图标
图标使用的是Font Awesome Free,你可以在这里找到所有的图标。
挑选到图标后可以在:
主题配置侧栏页的图标输入框填写图标数据

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

下面提供一些常用图标