前言
通过之前的文章,我们选好了VPS,把Halo博客也初步搭起来了。现在博客走上正轨之后,有一件事比任何优化都要更优先,那就是备份!
我们的文章、攒下的访客评论和上传的附件,全部都在这台VPS上,一旦它出了什么错,比如磁盘坏了、病毒入侵,厂商跑路等等,要是没有做好数据备份,那就只能从头再来了。本文就来讲一下如何备份我们的Halo博客,在保障我们数据安全的同时,还能轻松恢复数据。
Halo博客的数据都存在哪
Halo 2.x运行时会在用户目录下维护一个工作目录,默认路径是~/.halo2,里面的结构大致是:
这里有一个关键分岔:用的是什么数据库。Halo默认使用自带的H2数据库,数据文件就在工作目录的db/里——这种情况下,备份整个工作目录就等于备份了全部。如果部署时外接了PostgreSQL或MySQL,数据库里的内容就不在工作目录里了,需要单独用pg_dump或mysqldump导出。
如果是用1Panel一键部署的Halo,工作目录会被自动挂载到宿主机上,1Panel的应用目录里就能看到(在容器详情的挂载信息里可以确认具体路径)。直接在宿主机上操作挂载目录就行,不需要进容器里面找。

最省事的备份:Halo自带的备份
Halo 后台内置了备份和恢复功能。在控制台左侧菜单找到「备份」,点右上角的「创建备份」即可。注意备份请求是异步执行的,点完不会立刻出结果,需要等一段时间,列表里状态变成"备份完成"才算数。
备份文件会生成在工作目录的backups/文件夹里,可以从后台直接下载到本地。恢复功能也内置了,支持三种方式:上传备份文件恢复、从远程URL拉取恢复、以及从工作目录的backups/目录里扫描已有备份恢复。恢复过程可能比较久,期间不要刷新页面。
自带备份适合日常定期手动做一次,但有两个短板:一是备份文件还在服务器上,服务器要是整个没了,备份跟着一起没了;二是手动点,容易忘。这两个问题,我们下面分开解决。
全量兜底:打包整个工作目录
想要一份"拿在手里才放心"的备份,直接把工作目录整体打包。打包前先停掉Halo容器,避免数据库文件在写入状态下被打包(正在写的库文件直接tar,有一定概率备份出一个损坏的副本):
docker stop halo
tar -czvf halo-backup-$(date +%F).tar.gz -C /opt/1panel/apps/halo .
docker start halo 第二行里$(date +%F)会自动填上当天日期,生成的文件名类似halo-backup-2026-11-16.tar.gz;-C参数让tar先切到Halo数据目录再打包,避免备份出一串带着绝对路径的嵌套文件夹。路径以你实际的挂载目录为准,容器名字以docker ps里看到的为准。停机、打包、重启,整个过程通常就几十秒,一个月做一次不算折腾。
如果用的是外接数据库,记得补一条数据库导出,以PostgreSQL为例:
docker exec halo-db pg_dump -U halo halo > halo-$(date +%F).sql 三份副本才叫备份
备份文件下载到本地电脑,只是最低要求。真正可靠的备份要遵循3-2-1原则:3份数据,2种介质,1份异地。落实到Halo博客上,比较舒服的一种备份组合是:VPS本地留一份(快速恢复用)、本地电脑存一份、再放一份到异地。
异地副本的首选是对象存储。博客的全量备份通常也就几十MB到几百MB,比如我现在用的VMRack的对象存储,每月免费送5GB存储加10GB下行流量,放一个滚动更新的备份目录绰绰有余,基本不产生额外开销。往对象存储上传可以用rclone,配置一次之后就是一条命令的事,具体做法可以参考Tuio小站的文章《通过对象存储做定时备份与异地容灾》,里面从配置到自动化写得很全。
让备份自动跑起来
定时手动备份,实在太麻烦了。我们有这两条路来让备份自动化:
在Halo这边装增强备份插件,支持定时备份和远程同步,适合想全程在Halo后台管理的站长。远程同步的目标建议用对象存储的私有桶,不要把备份所在的存储桶设成公开访问,因为公开等于裸奔,别人拿到链接就能随意访问你的数据。
走服务器层面:用1Panel的计划任务定期执行打包脚本,把工作目录tar一份,再通过rclone同步到对象存储,滚动保留最近的几份文件。1Panel计划任务的具体教程可以参考Tuio小站的这篇文章《如何在 1Panel 上备份数据教程》。
备份做完了,验证一次
备份生成了,不等于备份就能用。强烈建议在第一次设置完备份流程之后,做一次恢复验证:在本地或测试机上用一份备份文件完整走一遍恢复流程(Halo自带的恢复功能,或者迁移场景下直接解包工作目录),确认文章、评论、附件都在。
这个恢复演练,一方面可以证明"这份备份文件真的能救命",另一方面也可以提前熟悉恢复流程,如自己的Halo 博客真的出了问题,也能快速恢复。建议每隔几个月做一次,顺便验证一次最新的备份文件。
顺带一提,如果哪天要给博客换服务器,这套备份就是全部底气。
总结
Halo博客的备份,核心就三件事:
先搞清数据在哪——默认H2数据库的话在VPS里打包整个
~/.halo2工作目录就是全量备份;如果外接了其他数据库就要单独从数据库中导出一份。备份方式用自带功能做日常、整体打包做兜底。文件按3-2-1放三份,通过对象存储做异地副本,再用插件或计划任务让备份自动跑,
最后验证一次恢复流程。做完这一套,服务器出什么问题,你的博客都只是"停一会儿",而不是直接"没了"。
希望这篇文章能够帮助你保护好自己的博客。
