很多技术文章都教你「备份很重要」,但很少告诉你真的还原时会发生什么。今天我就要做这个没人喜欢干的脏活累活:把 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
但实际遇到了两个问题:
- 连接数限制:还原过程中数据库连接被占满,需要修改
halodb容器的 shared_preload_libraries 参数增加连接数,或者分批导入。 - 版本兼容:用 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 配置被旧数据覆盖,还是测试环境的地址。需要手动修改为生产地址。
经验教训
- 定期还原演练很重要:我这次遇到的问题,在真实的紧急恢复时会非常致命。
- 备份文件应包含环境说明:注明数据库版本、Halo 版本、备份时间等元数据。
- 配置应单独备份:数据库连接字符串等环境相关配置,应与数据备份分开管理。
- 流程文档化:把还原步骤写成脚本,避免手忙脚乱。
我花了三小时才完整还原成功,但这一步的价值远超时间成本。备份不只是把数据存起来,而是确保能在需要时快速恢复。
你真的还原过自己的备份吗?如果没有,不妨找个周末试试。