Administrator
发布于 2026-11-19 / 1 阅读
0
0

Halo 备份与恢复:我把备份真的还原了一遍

很多技术文章都教你「备份很重要」,但很少告诉你真的还原时会发生什么。今天我就要做这个没人喜欢干的脏活累活:把 Halo 博客的备份真正还原一遍,看看会遇到哪些坑。

备份方案:日常自动化

我的 Halo 运行在 Docker Compose 环境下,备份脚本是 backup.sh:

#!/bin/bash
BACKUP_DIR="/mnt/-1/halo/backups"
DATE=$(date +%Y%m%d_%H%M%S)
cd /mnt/-1/halo

# 1. 导出 PostgreSQL 数据库
docker compose exec -T halodb pg_dump -U halo -d halodb > $BACKUP_DIR/halo_db_$DATE.sql

# 2. 打包 data 目录(附件、主题、配置)
tar -czf $BACKUP_DIR/halo_data_$DATE.tar.gz data/

# 3. 清理旧备份(保留14天)
find $BACKUP_DIR/ -type f -mtime +14 -delete

这个脚本每天凌晨通过 crontab 执行,确保数据安全。

还原环境准备

为了不影响线上服务,我在测试环境还原。首先停止 Halo 容器:

cd /mnt/-1/halo
docker compose down

将生产环境的备份文件复制到测试环境。这一步看似简单,但备份文件权限成了第一个坑:tar 打包后文件属主变为 root,解压时需要 --same-owner 参数或手动调整权限。

数据库还原的坑

数据库还原命令看起来简单:

docker compose exec -T halodb psql -U halo -d halodb < halo_db_20241215_0000.sql

但实际遇到了两个问题:

  1. 连接数限制:还原过程中数据库连接被占满,需要修改 halodb 容器的 shared_preload_libraries 参数增加连接数,或者分批导入。
  2. 版本兼容:用 PostgreSQL 16 导出的数据,还原到测试环境的 PostgreSQL 15 时报错语法不兼容。最终只能保持版本一致。

文件系统还原

解压data目录:

tar -xzf halo_data_20241215_0000.tar.gz -C /mnt/-1/halo/

这里有个重要细节:Halo 的配置文件 data/config/application.yaml 包含了数据库连接信息,如果用旧配置连接新数据库,启动会失败。需要检查配置是否正确。

附件文件没问题,但主题文件的还原需要注意:如果主题在 Halo 后台有配置数据,只还原文件是不够的,相关配置在数据库的 themes 表中,需要一并还原。

启动验证

启动容器后,访问 http://localhost:8091 一切正常,文章、页面、设置都在。

但 RSS 订阅链接出错了!原因是数据库还原时,site_url 配置被旧数据覆盖,还是测试环境的地址。需要手动修改为生产地址。

经验教训

  1. 定期还原演练很重要:我这次遇到的问题,在真实的紧急恢复时会非常致命。
  2. 备份文件应包含环境说明:注明数据库版本、Halo 版本、备份时间等元数据。
  3. 配置应单独备份:数据库连接字符串等环境相关配置,应与数据备份分开管理。
  4. 流程文档化:把还原步骤写成脚本,避免手忙脚乱。

我花了三小时才完整还原成功,但这一步的价值远超时间成本。备份不只是把数据存起来,而是确保能在需要时快速恢复。

你真的还原过自己的备份吗?如果没有,不妨找个周末试试。


评论