7
0
0

别把博客压在一台 VPS 上:用 GitHub Actions 给 Halo 每天自动做异地备份

2026-10-24
2026-10-24
文章摘要
|
蓝色灯光下的数据中心服务器机柜
你的博客数据此刻就住在某个机柜里——而它只有一份(图:数据中心机柜)

前几天本站被 H2 数据库的「吞文」故障连着折腾了两轮,昨天又刚把《给 Halo 博客换颗心脏:从 H2 迁到 PostgreSQL 的完整实战手册》排上日程。翻过那份手册你会发现:所有大动作的第一步都是「先备份」。问题在于——手动备份和健身卡是同一种东西:办的时候都很虔诚,用的时候想不起来。

今天就把「备份」从一个人肉动作升级成全自动流水线:GitHub Actions 每天定时 SSH 到服务器,打包 Halo 数据,推进私有仓库,滚动保留最近 7 份。全程零成本(免费额度绰绰有余),跑通之后你的博客数据至少存两份、躺在两个不同的机房里。这套「Actions + 私有仓库当异地备份盘」的玩法在 GitHub 上的自托管圈子里相当常见,今天把它完整移植到 Halo 上。

一、先算清楚:Halo 的数据到底有几笔账

数据中心走廊里的服务器机架
备份的意义:让数据不再押注在一条走廊上(图:数据中心走廊)

Docker 部署的 Halo,数据分成两笔独立的账:

  • 工作目录:就是 compose 里 -v ./halo2:/root/.halo2 挂出来的那个目录。官方安装文档的说法:未自定义配置时,Halo 会把工作目录(含内置 H2 数据库、附件等)放在 ~/.halo2。里面住着 themes(主题)、plugins(插件)、attachments(你传过的每一张图)、logs、backups(Console 生成的备份文件)、application.yaml(配置)。
  • 数据库:还在用内置 H2 时,数据库文件 halo2/db/halo.mv.db 就躺在工作目录里——打包工作目录等于顺带备了库;迁到 PostgreSQL / MySQL 之后,数据搬进了独立的数据库容器,必须额外 dump 一份,只打包工作目录会丢掉所有文章正文和评论。

所以完整备份的公式是:工作目录打包 +(外部数据库时的)数据库逻辑导出,两笔都齐才叫完整。另外有个容易忽略的细节——Halo 2.20 LTS 的官方发布说明明确建议「备份时排除全文索引目录 indices,防止恢复之后因为索引文件问题无法启动」,索引恢复后会自动重建,带上它反而添乱。

二、官方自带的备份:好用,但只肯让你手动

Halo 从 2.8 起在 Console 内置了一键备份恢复:左侧菜单「备份」→ 右上角「创建备份」。注意它是后台异步执行的,点完别急着关页面,等状态变成「备份完成」再下载。恢复功能相当能打,三个亮点值得单独记:

  • 三种恢复姿势:上传备份文件 / 从远程 URL 拉取 / 扫描工作目录 backups/ 里的文件。官方特别提醒:大文件别走浏览器上传,先传到服务器的 backups/ 目录再选「从备份文件恢复」,最稳。
  • 跨库跨部署:官方文档原话是「恢复不限制部署方式,也不限制数据库」——H2 站的备份可以直接恢复到 PostgreSQL 新站,这也是昨天那篇迁移手册的官方背书。
  • 恢复期间别刷新页面:恢复耗时可能较长;冲突数据会被备份覆盖,非冲突数据不动;完成后按提示重启 Halo。

但免费版有个硬限制:官方文档写得明白,能定时自动备份并同步到云端的「备份增强插件」是 Halo 付费版专享。免费版只能手动点按钮。再补一条安全提醒:约 2.25.4 及更早版本曾被安全研究者披露备份恢复功能存在任意文件写入漏洞——恢复功能只喂自己信任的备份文件,并把 Halo 升到新版再动手。

结论:免费版想定时,得自己造定时器。GitHub Actions 正好是那个免费、可靠、还带完整执行日志的定时器。

三、备份脚本:H2 和 PG 是两种姿势

先写服务器侧的备份逻辑,两种数据库阶段各有正确姿势。

H2 阶段(还在用内置库):数据库文件和容器同生死,容器跑着的时候直接拷贝文件有一致性风险(可能拷到写了一半的状态)。最稳的做法是挑凌晨停容器 30 秒:

docker stop halo
tar -czf halo2-$(date +%F).tar.gz -C /opt/halo2 --exclude='halo2/indices' halo2
docker start halo

PG 阶段(迁库之后):pg_dump 在线逻辑备份,完全不停站——这也是迁 PostgreSQL 的隐性福利之一:

docker exec halodb pg_dump -U halo -d halo | gzip > halo-db-$(date +%F).sql.gz

小知识:官方 postgres 镜像里本地 socket 连接默认是信任模式,所以 docker exec 进容器直接 pg_dump 不用喂密码。工作目录照旧打包,两份一起带走。/opt/halo2 这个路径按你的实际挂载调整(宝塔 Docker 部署的,在面板「容器编排」里能看到自己项目挂的是哪个目录;compose 里 PG 服务名 halodb 对应的容器名可以用 docker ps 确认,顺手在 compose 里加一行 container_name: halodb 固定住更省心)。

四、GitHub Actions:把备份串成每天自动的流水线

整体架构一句话:私有仓库 halo-backup 里放一个 workflow 和一个服务器脚本;Actions 定时醒来,SSH 到你的服务器执行脚本,备份包通过管道流回 runner,最后 git push 回私有仓库。准备工作四步:

  • 建私有仓库 halo-backup——必须 Private!备份里有文章、配置、评论邮箱这类隐私数据。
  • 配 SSH 密钥:ssh-keygen -t ed25519 -f backup_key -N '' 生成专用密钥对;公钥追加到服务器 ~/.ssh/authorized_keys;私钥的整个文件内容存进仓库 Secret,命名 SSH_KEY;服务器地址(形如 user@1.2.3.4)存成另一个 Secret SERVER_HOST。
  • 把服务器脚本提交进仓库:scripts/server_backup.sh,内容如下。
  • 写 workflow:.github/workflows/backup.yml,内容如下。
#!/usr/bin/env bash
# scripts/server_backup.sh —— 在服务器上执行,产物输出到 stdout
set -euo pipefail
STAMP=$(date +%F)
STAGE=$(mktemp -d)

# ① 数据库逻辑备份(PG 在线热备;H2 用户见下方替换说明)
docker exec halodb pg_dump -U halo -d halo | gzip > "$STAGE/halo-db-$STAMP.sql.gz"

# ② 工作目录打包:排除全文索引,连带带走 Console 生成过的 backups/
tar -czf "$STAGE/halo-workdir-$STAMP.tar.gz" -C /opt/halo2 --exclude='halo2/indices' halo2

# ③ 两个包合并成一个流输出,由 GitHub 侧接收
tar -czf - -C "$STAGE" .
rm -rf "$STAGE"

H2 用户把第 ① 步删掉,改成在 ② 前后用 docker stop halo / docker start halo 夹住——凌晨四点停 30 秒,没人会发现。

# .github/workflows/backup.yml
name: halo-backup
on:
  schedule:
    - cron: '50 20 * * *'   # ⚠️ Actions 的 cron 是 UTC:20:50 UTC = 北京 04:50
  workflow_dispatch:          # 手动触发按钮,调试和演练用

permissions:
  contents: write             # 允许 GITHUB_TOKEN 推送本仓库

jobs:
  backup:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: 从服务器拉取备份
        env:
          SSH_KEY: ${ secrets.SSH_KEY }
          HOST: ${ secrets.SERVER_HOST }
        run: |
          mkdir -p ~/.ssh
          printf '%s
' "$SSH_KEY" > ~/.ssh/id_ed25519
          chmod 600 ~/.ssh/id_ed25519
          ssh -o StrictHostKeyChecking=accept-new "$HOST"             'bash -s' < scripts/server_backup.sh > "halo-backup-$(date +%F).tar.gz"
          ls -lh halo-backup-*.tar.gz

      - name: 滚动保留最近 7 份
        run: ls -1t halo-backup-*.tar.gz | tail -n +8 | xargs -r rm --

      - name: 提交并推送
        run: |
          git config user.name "backup-bot"
          git config user.email "backup-bot@users.noreply.github.com"
          git add halo-backup-*.tar.gz
          git commit -m "backup: $(date +%F)" || echo "没有新备份,跳过"
          git push

三个设计点值得讲透:

  • 为什么不用长期 PAT:actions/checkout@v4 默认把 GITHUB_TOKEN 凭据保存进本地 git 配置,配合 permissions: contents: write,git push 直接可用。这个 token 在 job 结束时自动失效——比在 Secret 里养一个永久 PAT 安全一个量级。
  • 为什么定 20:50 不定整点:错开整点的任务挤兑高峰(后面第五节会讲迟到问题)。
  • 为什么备份走 SSH 管道流回:不在服务器上留中转文件、免掉第二次 scp 跳转,备份包直接落到 runner 的工作目录里。

五、五个必知的坑(外加一条铁律)

  • cron 是 UTC,北京减 8:GitHub Actions 的 schedule 至今不支持时区字段,官方文档写得很干脆。想北京 04:50,就写 UTC 的前一天 20:50。换算错了,备份就会在大白天停你的 H2 容器。
  • schedule 会迟到:官方文档明确说明高负载时段定时任务可能推迟执行,别拿它当秒表。这也是留 workflow_dispatch 手动按钮的原因——补跑一键完成。
  • 公共仓库 60 天无活动会自动停用定时任务:官方文档原文「In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days」。每天自动 commit 恰好天然保活;不过你的备份仓库本来就该是 Private,不受这条影响。
  • 额度不用焦虑:私有仓库 Actions 免费额度 2000 分钟/月,每天一次、一次两三分钟的 job 用不到 5%。
  • git 历史只增不减:上一步的 rm 只删工作区文件,旧备份仍躺在 git 历史里,仓库体积会缓慢增长。个人博客一年也就几百 MB,无所谓;真在意可以把产物改成传 GitHub Release 附件,或每季度重建一次仓库。

最后一条铁律比所有技巧都重要:备份不演练,等于没备份。每季度挑一天,把最新备份拉到本地,用 Docker 起个临时 Halo,走一遍「从备份文件恢复」。这样顺手就把备份的 3-2-1 原则凑齐了——服务器一份、GitHub 一份、本地演练时下载的那份是第三份。

写在最后

本站接下来的动作顺序已经想好:先用今天这套流水线把「每天一份异地备份」跑起来,再按昨天那份手册动迁库手术——先上保险,再换心脏。数据这东西的规律一向是:出事之前,所有的备份都显得多余;出事之后,所有的备份都嫌不够。愿你永远用不上恢复功能,但每天早上打开仓库的 Actions 页面看到一颗绿勾时,多少会睡得踏实一点。

参考来源:Halo 官方文档(docs.halo.run「备份与恢复」「使用 Docker Compose 部署」)、Halo 官网 2.20 LTS 发布说明(indices 排除建议)、GitHub Actions 官方文档(docs.github.com「Events that trigger workflows」「Disabling and enabling a workflow」)、GitHub 社区与开发者博客对 Actions 时区/延迟问题的讨论、安全研究社区对 Halo 旧版备份恢复漏洞的披露。


以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

别把博客压在一台 VPS 上:用 GitHub Actions 给 Halo 每天自动做异地备份
/archives/tech-blog-2026-10-24
作者
番茄酱唉
发布于
2026-10-24
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!