服务器使用BorgBackup远程仓库,怎样配置备份并验证恢复?
现有服务器已经能够通过 SSH 访问 BorgBackup 远程仓库,日常维护的重点不是再做一遍安装,而是把备份范围、执行频率、数据一致性、保留策略和恢复验证连成一套可重复的流程。本文以 Linux、systemd 和 Borg 1.2 系列为例,说明如何调整日常备份、检查归档结果,并在隔离目录中完成恢复演练;Borg 2.x 的命令和配置可能不同,执行前应先核对本机版本。
备份任务显示成功,不代表数据一定能恢复。可靠的验收至少要同时确认:预期文件进入了归档、归档按计划更新、远程仓库能够读取,并且抽取出的文件或数据库内容通过业务校验。
现状与条件:先确认仓库和备份边界
开始调整前,先以执行备份的系统账户检查 Borg 版本、仓库连通性和已有归档。备份任务若由 root 运行,以下命令也应在相同账户下执行,避免因为 SSH 密钥、环境变量或权限不同而得到不同结果。
borg --version
ssh -i /root/.ssh/borg_ed25519 borg@backup.example.net 'borg --version'
borg list borg@backup.example.net:/srv/borg/server01
示例远程地址表示 SSH 用户 borg 登录备份服务器,并访问其上的 /srv/borg/server01 仓库。远端的 Borg 程序应与本地版本兼容;若连接报版本协商或远端命令错误,先核对双方版本、SSH 登录方式和远端仓库路径,不要直接在生产仓库上执行初始化命令。borg init 用于创建新仓库,不是日常检查命令;对已有仓库重复初始化可能造成配置问题。
确认备份范围
备份范围要按数据用途划分,而不是简单地把整块磁盘都放进去。常见的纳入项包括:
/etc:系统和服务配置,恢复时需要结合原系统版本检查。/home:用户目录,需确认是否包含缓存、临时文件或不需要长期保留的大文件。/srv、/var/www:网站文件、业务附件或自建服务数据。- 应用配置、证书和部署文件:注意密钥、访问令牌等敏感内容的访问权限。
- 数据库逻辑备份或一致性快照:不能把正在写入的数据库文件目录默认视为可直接恢复的备份。
通常不应无差别备份 /proc、/sys、/dev、/run 等运行时文件系统,也要评估缓存、临时目录、可重新生成的数据和挂载的远端目录。尤其是挂载点:备份程序可能进入挂载目录并读取另一套文件系统,造成范围扩大或重复备份。应在实际路径列表中明确是否包含该挂载点。
可先整理一份清单,标注数据所有者、预计变化频率、可接受的数据丢失窗口,以及恢复时所需的程序和凭据。举例来说,配置文件每天变化不多,而订单数据库可能每小时都有写入;两者的备份频率和一致性方式不应只靠同一个“每天运行一次”的文件归档任务解决。
先定义恢复目标,再选频率和保留周期
备份频率决定故障时可能丢失多长时间的数据,保留周期决定能回到多早的状态。以每天一次归档、保留最近 7 个日归档为例,若故障发生在下一次备份前,文件级数据的恢复点可能接近 24 小时前;这不适合要求小时级恢复点的业务。
下面是可作为起点的策略示例,不是通用标准:
| 数据类型 | 备份方式示例 | 频率参考 | 重点检查 |
|---|---|---|---|
| 系统配置和静态文件 | Borg 文件归档 | 每日一次 | 文件是否完整、权限是否保留 |
| 更新频繁的业务目录 | Borg 文件归档或文件系统快照后归档 | 每小时至每日,按恢复点要求确定 | 写入过程中的文件是否一致 |
| 数据库 | 数据库原生逻辑备份或一致性快照,再由 Borg 归档 | 按数据变化量和可接受丢失窗口确定 | 能否导入测试实例并通过查询校验 |
| 可再生成的缓存、临时文件 | 通常排除或单独评估 | 按业务需要 | 排除后是否会影响恢复启动 |
频率提高会增加归档数量、仓库写入和备份窗口;但 Borg 对重复数据采用去重机制,新增归档不等于每次都完整复制全部数据。实际空间仍取决于数据变化、压缩效果、保留策略和仓库维护情况,应通过仓库增长趋势观察,而非简单按源目录总容量乘以归档数量估算。
BorgBackup远程仓库的存储与计算资源,可由A5idc数据提供多地区物理服务器方案支撑。香港存储系列配备多块企业级机械硬盘,适合承载大容量归档数据;香港、日本等地也有SSD或NVMe存储配置,可用于不同规模的仓库与备份任务部署。
日常操作:配置归档、调度与保留策略
用受限账户访问远程仓库
生产备份应使用专用 SSH 密钥和专用远端账户,避免把日常管理员密钥复制到备份服务器。确认该账户只能访问所需仓库范围,并限制本地私钥的读取权限。连接测试通过后,再由备份脚本调用 Borg。
加密仓库还需要保护密钥和口令。口令不要直接写进脚本或命令行参数中,也不要把密钥备份只放在被保护的同一台服务器上。可采用本机仅 root 可读的口令文件,并把导出的 Borg 密钥和恢复说明存放在独立、受控的位置。若主机损坏,恢复端必须同时具备访问仓库的方式和解密所需材料。
明确备份路径,使用可识别的归档名称
下面的脚本展示每日归档的基本结构。请先根据实际系统修改路径和排除项;示例中的主机名用于区分同一仓库内不同服务器的归档。脚本中的路径不存在或权限不足时,应先处理原因,不要通过扩大权限来掩盖问题。
#!/usr/bin/env bash
set -euo pipefail
umask 077
export BORG_REPO="borg@backup.example.net:/srv/borg/server01"
export BORG_PASSCOMMAND="cat /root/.config/borg/passphrase"
archive_name="$(hostname -s)-$(date +%Y-%m-%dT%H%M%S)"
borg create \
--stats \
--list \
--exclude-caches \
--exclude /var/cache \
--exclude /tmp \
"::${archive_name}" \
/etc \
/home \
/srv \
/var/www
borg info "${BORG_REPO}::${archive_name}"
此示例使用 Borg 1.x 的 BORG_REPO 环境变量和归档命名形式。脚本应保存为仅管理员可修改的文件,例如 /usr/local/sbin/borg-backup,并设置合理权限:
install -o root -g root -m 0750 borg-backup /usr/local/sbin/borg-backup
--exclude-caches 会根据缓存目录标记排除相应内容;额外的 --exclude 是示例规则,需确认确实不包含必须恢复的数据。不要为了减少仓库体积而排除数据库文件、上传文件或应用运行必需的目录。调整排除规则后,先用一次归档并检查实际归档内容:
borg list borg@backup.example.net:/srv/borg/server01::server01-2025-01-01T020000
实际归档名应替换为仓库中已有的名称。若列表里缺少预期路径,先修正备份路径或排除规则,再安排日常调度。
Borg 通常会保留文件元数据,但恢复权限仍受运行身份、文件系统能力和目标系统状态影响。对需要保留所有者、权限、ACL 或扩展属性的业务,应使用具备相应读取权限的账户执行备份,并在恢复演练中检查这些属性是否符合要求。
为数据库建立一致性备份
正在写入的数据库目录不是普通静态文件。直接归档运行中的数据文件,可能得到跨越不同写入时点的一组文件;即使 Borg 完成归档,也不能据此断定数据库能正常启动。
常见做法是先通过数据库自身工具生成逻辑备份,再由 Borg 归档该备份文件。也可以使用数据库支持的一致性快照机制,在快照完成后归档快照中的数据。具体命令取决于数据库类型、版本和部署方式,不能把某一套数据库命令直接套用到所有环境。至少应做到:
- 备份任务使用具备必要读取权限的数据库账户,并保护口令和连接信息。
- 逻辑备份写入受限权限的暂存目录,完成后检查命令退出码和文件大小。
- Borg 归档成功后,根据暂存空间和安全策略清理过期逻辑备份;清理操作应限定到明确目录和文件规则,避免误删正在生成的文件。
- 定期把备份导入隔离的测试实例,检查关键表、记录数或业务查询,而不只检查备份文件存在。
如果数据库变化频繁,单纯依赖每日逻辑备份可能无法达到预期恢复点;应根据业务要求增加备份频率或采用数据库支持的增量恢复方案,并分别演练数据库恢复和文件恢复。
安排周期任务并避免并发运行
以下是 systemd 定时任务的示例。假设脚本路径为 /usr/local/sbin/borg-backup,服务设置为一次性任务,定时器安排每天运行。将其用于生产前,应确认本机 systemd 可用、脚本能够在非交互环境中访问仓库,并且不存在另一套 cron 或定时器同时执行同一任务。
# /etc/systemd/system/borg-backup.service
[Unit]
Description=BorgBackup daily archive
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/borg-backup
# /etc/systemd/system/borg-backup.timer
[Unit]
Description=Run BorgBackup daily
[Timer]
OnCalendar=*-*-* 02:30:00
Persistent=true
RandomizedDelaySec=10m
[Install]
WantedBy=timers.target
保存文件后加载并启用定时器:
systemctl daemon-reload
systemctl enable --now borg-backup.timer
systemctl list-timers borg-backup.timer
Persistent=true 可让错过的定时任务在计时器重新启用后补执行,但它不会自动补齐错过期间的每一个时间点。RandomizedDelaySec 可降低多台服务器同一时刻连接仓库的集中程度。不要让多个任务同时对同一仓库执行创建、修剪或检查操作;即使 Borg 有仓库锁,也应以清楚的调度和锁等待策略管理并发,避免形成重复任务或长期排队。
按计划修剪归档,保留历史恢复点
保留策略应满足恢复需求,并与可用空间相匹配。每日保留 7 份、每周保留 4 份、每月保留 6 份,是一种示例策略,意味着可以保留较近的日级恢复点和更久的周、月级恢复点。实际恢复点分布取决于归档执行情况和 Borg 对日、周、月归档的选择规则;不能把它理解成每个自然日都必然有一份归档。
可在备份成功后或单独的维护任务中运行:
export BORG_REPO="borg@backup.example.net:/srv/borg/server01"
export BORG_PASSCOMMAND="cat /root/.config/borg/passphrase"
borg prune \
--list \
--glob-archives 'server01-*' \
--keep-daily=7 \
--keep-weekly=4 \
--keep-monthly=6 \
"$BORG_REPO"
borg compact "$BORG_REPO"
--glob-archives 用于限定修剪范围,示例中的模式应与实际归档名称匹配。执行前应先检查仓库归档列表,并确认该仓库是否还保存其他服务器或其他用途的归档;模式写错可能导致修剪对象超出预期。prune 会移除不符合保留策略的归档引用,compact 则回收仓库中已不再被引用的数据空间。删除归档是有影响的操作,执行前应确认策略、归档范围和仓库可访问性;如需保留的归档已经被删除,通常不能仅靠 Borg 命令撤销,应从其他副本或离线备份恢复。
结果检查:验证归档更新、仓库可读和数据可用
检查任务状态与归档内容
定时器状态只说明调度配置已启用,不说明备份已经成功。运行一次任务并查看退出状态和日志:
systemctl start borg-backup.service
systemctl status borg-backup.service
journalctl -u borg-backup.service --since today
检查仓库中是否出现本次归档,并查看归档信息:
borg list borg@backup.example.net:/srv/borg/server01
borg info borg@backup.example.net:/srv/borg/server01::server01-2025-01-01T023000
验证以下内容是否符合预期:
- 归档名称和时间与计划一致,最新归档时间没有持续落后。
- 文件数量和归档大小没有异常跳变;大小变化应结合业务数据变化判断。
borg list能列出关键目录和目标文件,路径没有因拼写或排除规则错误而缺失。- 日志中没有 SSH 失败、仓库锁等待超时、空间不足或文件读取错误。
- 备份服务器上的仓库空间和文件系统状态正常。
如果仓库内有多个主机的归档,应分别检查各自的归档前缀和更新频率,不能仅凭仓库存在归档就判断本机备份正常。
定期检查仓库,但区分快速检查和数据校验
可以定期运行仓库检查,发现索引或归档结构问题。具体检查耗时和资源开销与仓库规模、存储介质和网络有关,建议先在维护窗口执行并观察影响:
export BORG_REPO="borg@backup.example.net:/srv/borg/server01"
export BORG_PASSCOMMAND="cat /root/.config/borg/passphrase"
borg check "$BORG_REPO"
需要读取并验证归档数据时,可在确认时间和带宽预算后执行更深入的校验:
borg check --verify-data "$BORG_REPO"
--verify-data 可能产生较高的读取和 CPU 开销,不必在每次日常备份后都运行。可将普通检查和深度校验安排在不同维护周期,并监控备份服务器负载。检查结果正常仍不能替代实际恢复演练;真正的恢复验证还要确认抽取内容可用、权限符合要求,且数据库或应用能读取数据。
异常处理:先停止风险扩大,再确定是否需要修复仓库
遇到错误时,先记录任务日志、Borg 版本、仓库地址和失败时间,避免在原因不明时连续重跑可能写入或修改仓库的操作。处理顺序可按以下方式进行:
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
| SSH 拒绝连接或认证失败 | DNS、网络连通性、密钥路径、密钥权限、远端账户 | 修复连接后再测试 borg list |
| 找不到仓库或远端程序报错 | 仓库路径、远端 Borg 版本、SSH 命令限制 | 核对仓库实际位置和版本兼容性 |
| 口令或密钥错误 | 口令读取方式、密钥文件、环境变量、仓库加密信息 | 从安全保管位置恢复正确材料,不要尝试覆盖仓库 |
| 仓库被锁或任务一直等待 | 是否有另一任务运行、异常中断的进程、远端维护任务 | 先确认没有有效任务,再按 Borg 提示处理锁 |
| 归档失败并提示空间不足 | 本机暂存空间、远端文件系统空间、inode、配额 | 先保障空间,再检查保留策略;不要直接删除仓库文件 |
| 某些文件读取失败 | 文件权限、文件是否在备份期间变化、文件系统错误 | 判断文件是否必须备份;修复权限或改用一致性快照 |
| 归档成功但体积异常 | 路径变化、排除规则、数据实际变化、是否误读挂载点 | 对比 borg list 和 borg info,确认备份范围 |
如果 Borg 提示仓库需要修复,先停止会访问该仓库的其他备份、修剪和检查任务,并确保仍有可用的独立数据副本。按照与本机 Borg 版本相符的提示执行维护操作;不要手工删除仓库中的文件,也不要把 borg break-lock 当作常规解锁手段。破锁前必须确认持锁进程确已停止或服务器已经不可用,否则可能造成并发写入和仓库损坏。任何修复或仓库修改操作都应先记录仓库状态,并在可行时先对仓库或其存储介质做独立保护。
如果误执行了 prune,先暂停后续修剪和压缩,并检查远端是否仍有仓库快照、存储快照或其他备份副本。若数据已被压缩回收,已删除归档通常不能从当前仓库直接找回;不要承诺可通过回滚命令恢复。
必要恢复:在隔离位置完成文件和数据库演练
恢复演练应尽量先落到临时目录或隔离主机,不要直接覆盖生产目录。这样可以检查归档内容、权限和数据可用性,同时降低误覆盖当前数据的风险。
恢复单个文件或目录
先确定目标归档并确认待恢复路径:
borg list borg@backup.example.net:/srv/borg/server01
borg list borg@backup.example.net:/srv/borg/server01::server01-2025-01-01T023000
随后创建受限权限的临时目录,抽取所需路径:
install -d -o root -g root -m 0700 /var/tmp/borg-restore-test
borg extract \
--list \
--destination /var/tmp/borg-restore-test \
borg@backup.example.net:/srv/borg/server01::server01-2025-01-01T023000 \
etc/ssh/sshd_config
路径写法应以 borg list 实际显示内容为准。如果归档内的路径结构与预想不同,先检查归档根路径,不要对生产目录执行盲目覆盖。抽取后检查文件内容、大小和权限:
stat /var/tmp/borg-restore-test/etc/ssh/sshd_config
diff -u /etc/ssh/sshd_config \
/var/tmp/borg-restore-test/etc/ssh/sshd_config
差异是否合理取决于恢复时间点。对于配置文件,可在确认内容后通过配置管理或人工审核恢复到生产位置;替换前应另存当前文件,并评估服务是否需要重载。不要直接把演练目录整体移动到系统根目录。
恢复整套目录时先评估影响
整目录恢复可能覆盖当前文件、改变权限或恢复旧配置。应先确认目标系统版本、挂载点、服务状态和恢复范围,并在维护窗口操作。稳妥做法是恢复到新目录,抽样验证后再由管理员按目录逐项迁移。
恢复到生产前,至少保留当前状态的备份或快照,并记录受影响路径。若恢复后服务无法启动,应停止继续覆盖其他目录,使用刚才保存的当前文件或快照回退,再根据日志处理配置差异。系统目录恢复还可能涉及软件包版本、用户和组、挂载配置、证书及外部依赖,不能只凭文件存在判断整机恢复完成。
验证数据库备份是否可导入
数据库备份应恢复到隔离的测试实例,不要直接导入生产库。测试实例应与生产实例区分网络、凭据和数据目录,避免演练任务误写生产数据。根据数据库类型执行对应的导入流程,并检查:

- 导入过程退出状态及日志中是否存在错误。
- 数据库能否启动,关键表和索引是否可访问。
- 关键业务查询、记录数量或时间范围是否符合该归档时间点。
- 应用使用测试配置连接测试实例时,核心读操作是否正常。
- 恢复所需的数据库版本、插件、编码、密钥和配置是否齐备。
恢复演练的记录应包含归档时间、恢复耗时、验证项、失败原因和修正措施。若演练发现只备份了文件、没有保存数据库恢复所需的版本或密钥,应将其补入备份范围或恢复文档,并重新演练。
上线或验收检查清单
- [ ] 本地与远端 Borg 版本、SSH 身份和仓库路径已确认,已有仓库没有被误初始化。
- [ ] 备份路径和排除规则经过归档列表检查,数据库采用了适合其写入特性的备份方式。
- [ ] 备份频率与业务可接受的数据丢失窗口相匹配,保留周期覆盖所需的历史恢复点。
- [ ] 加密口令、密钥和 SSH 私钥有受控权限,并在独立位置保留恢复所需材料。
- [ ] systemd 定时任务能够非交互执行,日志可查询,没有重复调度或并发维护任务。
- [ ] 归档按预期更新,仓库检查和空间监控已纳入日常维护。
- [ ]
prune范围、归档匹配规则和保留参数已经核对,执行前有独立副本或明确的风险评估。 - [ ] 至少完成一次隔离目录文件恢复,以及适用时的数据库导入演练。
- [ ] 恢复记录包含验证结果、耗时、权限检查和未解决问题,失败项修复后重新验收。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9227.html



