服务器如何配置BorgBackup远程仓库?SSH权限与备份恢复怎样验证

发布人:A5数据发布时间:2026-11-01 20:20阅读量:74

要把服务器数据备份到 BorgBackup 远程仓库,需要先在备份服务器上准备独立账户和存储目录,再用受限 SSH 密钥让业务服务器访问仓库。首次部署不能只以 borg create 返回成功作为终点:还要确认 SSH 密钥不能获得普通登录权限、仓库能通过检查,并且能够从归档中提取文件。

以下以两台 Debian 12 或 Ubuntu 22.04/24.04 服务器为例:业务服务器称为“客户端”,备份服务器域名示例为 backup.example.net,使用默认 SSH 端口 22。客户端以 root 执行备份,以便读取示例中的 /etc 和 /srv/appdata;备份服务器使用独立账户 borgstore 保存仓库。实际操作前,请替换域名、目录和账户名,并确认这些目录符合自己的备份范围。

在这类需要将Borg仓库部署在独立服务器上的场景中,A5idc数据可提供香港、美国、日本、新加坡等地区的物理服务器资源,覆盖常规计算、存储型与多带宽线路方案。其存储系列配备大容量企业级硬盘,部分方案采用NVMe或SSD,适合承载备份仓库、归档数据及恢复测试环境;多地区资源与不同网络线路,也可为跨区域业务的数据备份部署提供服务器基础。

准备条件:确认版本、空间和恢复所需的信息

两端都需要安装 BorgBackup,且本例使用 Borg 1.x 命令格式。先分别在两台服务器执行:

sudo apt update
sudo apt install borgbackup openssh-client
borg --version

备份服务器还需运行 SSH 服务;如尚未安装,可由管理员安装并按现有安全策略启用:

sudo apt install openssh-server
sudo systemctl status ssh

预期结果是两端 borg --version 均显示 borg 1.x,备份服务器的 ssh 服务处于运行状态。如果发行版仓库提供的主版本不同,先确认两端兼容性,不要直接照搬下文的初始化和恢复命令。

开始配置前,还应核对以下条件:

  • 客户端能解析并连接 backup.example.net:22;备份服务器只需开放其 SSH 服务使用的端口,不需要另开 Borg 端口。
  • 客户端确实存在 /srv/appdata,且备份范围已确定。本文以 /etc 和 /srv/appdata 为例;不要把不需要的临时文件或其他备份副本一起纳入。
  • 备份服务器上的目标文件系统有足够可用空间。首次归档的实际占用取决于源文件、压缩效果及仓库已有数据,不能只按源目录的标称容量判断。
  • 有独立于备份仓库的渠道保管 SSH 私钥、Borg 加密口令和仓库密钥导出文件。远程仓库可访问,不等于具备恢复所需的全部凭据。

以下命令针对首次部署。若目标机器已有同名账户、仓库或 SSH 配置,应先检查现状,不要覆盖。

第一步:在备份服务器建立独立仓库账户

在备份服务器执行:

sudo adduser --system --group --home /srv/borg --shell /bin/sh borgstore
sudo install -d -m 0700 -o borgstore -g borgstore /srv/borg
sudo install -d -m 0700 -o borgstore -g borgstore /srv/borg/.ssh
sudo install -d -m 0700 -o borgstore -g borgstore /srv/borg/repos
sudo -u borgstore touch /srv/borg/.ssh/authorized_keys
sudo chmod 0600 /srv/borg/.ssh/authorized_keys
sudo /usr/bin/borg --version

这里的 borgstore 仅用于这台客户端的仓库。目录权限为 0700,避免其他普通系统账户浏览仓库;authorized_keys 权限为 0600,以满足 SSH 对密钥文件权限的要求。

执行后检查属主和权限:

sudo stat -c '%U:%G %a %n' \
  /srv/borg /srv/borg/.ssh /srv/borg/repos \
  /srv/borg/.ssh/authorized_keys

前三个目录应由 borgstore 持有且权限为 700,密钥文件应由 borgstore 持有且权限为 600。如果权限不符,先核对命令中的路径和账户,再针对该路径修正;不要递归修改整台服务器的 SSH 文件权限。

第二步:生成密钥,并限制 SSH 只能运行 Borg

在客户端生成专用密钥。该私钥将允许客户端访问备份仓库,应由执行备份的 root 保管,不要复制到备份服务器:

sudo install -d -m 0700 /root/.ssh
sudo ssh-keygen -t ed25519 -f /root/.ssh/borg_client01 -N '' \
  -C 'borg-client01'
sudo cat /root/.ssh/borg_client01.pub

命令中的 -N '' 便于后续非交互备份,但意味着私钥文件本身没有额外口令保护。客户端 root 权限和该文件的离线副本都必须受到相应保护。确认文件权限:

sudo stat -c '%a %n' /root/.ssh/borg_client01

私钥通常应为 600。如果文件已经存在,ssh-keygen 会询问是否覆盖;不要覆盖仍被其他备份任务使用的密钥。

把客户端输出的公钥整行交给备份服务器管理员。在备份服务器上编辑 /srv/borg/.ssh/authorized_keys,将该公钥写成下面的格式;示例中的 ssh-ed25519 ... 要替换为真实公钥内容:

command="/usr/bin/borg serve --restrict-to-path /srv/borg/repos",restrict ssh-ed25519 AAAA... borg-client01

编辑后再次确认文件属主和权限。command= 强制该密钥运行 borg serve,restrict 关闭端口转发、伪终端等 SSH 附加能力,--restrict-to-path 把 Borg 操作限制在指定目录内。限制的是这把密钥,不是备份服务器的全部 SSH 登录方式。不要为了测试而取消这些限制,也不要将多个互不信任客户端放进同一个可写目录;新增客户端时应分别设计账户和目录权限。

第二步:生成密钥,并限制 SSH 只能运行 Borg配图

客户端还需要可信的 SSH 主机密钥。可以先获取候选公钥并查看指纹:

sudo ssh-keyscan -t ed25519 backup.example.net \
  > /root/.ssh/borg-hostkey.candidate
sudo ssh-keygen -lf /root/.ssh/borg-hostkey.candidate

ssh-keyscan 只能获取网络返回的密钥,不能单独证明服务器身份。将显示的指纹与备份服务器管理员通过可信渠道提供的指纹核对一致后,再加入客户端的 known_hosts:

sudo sh -c 'cat /root/.ssh/borg-hostkey.candidate >> /root/.ssh/known_hosts'
sudo chmod 0600 /root/.ssh/known_hosts

如果指纹不一致,应停止操作并核对域名解析、连接目标及服务器密钥变更情况,不要用关闭主机密钥检查的方式继续部署。

第三步:初始化远程仓库并保存恢复凭据

以下命令均在客户端执行。先为当前 shell 设置 SSH 调用方式和仓库地址;换一个终端后需要重新设置,或将其纳入后续受控的备份任务配置。

export BORG_RSH='ssh -i /root/.ssh/borg_client01 -o IdentitiesOnly=yes -o BatchMode=yes -o StrictHostKeyChecking=yes'
export BORG_REPO='borgstore@backup.example.net:/srv/borg/repos/client01'

初始化加密仓库:

borg init --encryption=repokey-blake2 "$BORG_REPO"

按提示设置并确认 Borg 加密口令。口令不要直接写在命令行参数、公开脚本或工单中。预期结果是命令成功退出,备份服务器的 /srv/borg/repos/client01 下出现仓库文件。用 Borg 自身验证比只检查目录更有意义:

borg info "$BORG_REPO"

正常情况下,它应显示该仓库的信息。此时尚无备份归档是正常现象。如果出现 Permission denied (publickey),先检查公钥是否完整写入、私钥路径和文件权限;如果提示主机密钥验证失败,先核对指纹和 known_hosts;如果出现远程 Borg 命令不存在或协议不兼容,检查备份服务器 /usr/bin/borg 是否存在以及两端版本。不要通过扩大仓库权限来掩盖连接或版本错误。

仓库初始化后,导出一份恢复所需的仓库密钥资料,并限制文件权限:

borg key export "$BORG_REPO" /root/borg-client01-key.export
chmod 0600 /root/borg-client01-key.export

将导出文件和加密口令按既定保管方式分别留存,不要只放在这台客户端上。repokey-blake2 的密钥保存在仓库内,但仓库损坏、迁移和应急恢复仍需要考虑密钥副本;密钥导出文件不能代替加密口令。

第四步:创建首份归档,并逐项验证

先确认示例源目录存在。/etc 和 /srv/appdata 是两个不同的备份对象:前者包含系统配置,后者仅代表本例选定的业务数据目录。若实际业务数据不在这里,必须先替换路径。

test -d /etc && test -d /srv/appdata

命令成功退出后,为本次归档生成名称并执行备份:

ARCHIVE="first-$(date -u +%Y%m%dT%H%M%SZ)"
borg create --stats --compression lz4 \
  "$BORG_REPO::$ARCHIVE" /etc /srv/appdata
printf '本次归档:%s\n' "$ARCHIVE"

--stats 显示的是本次操作的统计信息;归档大小不应直接当作远程文件系统新增占用。命令成功退出后,分别检查“归档存在”和“源路径已收录”:

borg list "$BORG_REPO"
borg list "$BORG_REPO::$ARCHIVE" etc/hostname
borg list "$BORG_REPO::$ARCHIVE" srv/appdata

第一条应能找到刚才的归档名;后两条用于查看指定路径的归档条目。Borg 在归档中保存的绝对源路径会表现为不带开头 / 的路径,例如 etc/hostname。如果 /srv/appdata 为空,不能仅凭目录条目证明业务文件已备份,应改为核对该目录中一份实际存在的文件。

接着检查仓库及归档结构:

borg check "$BORG_REPO"

该检查可能随仓库规模增长而耗时,应在首次归档后留出运行时间。它通过不等于每个业务文件都已被正确选入,也不能替代实际提取。

第五步:在隔离目录做一次恢复测试

不要直接把测试归档提取到 /:那可能覆盖当前系统文件。以下操作只提取示例文件 /etc/hostname,目标位置限定在客户端新建的测试目录内。

第五步:在隔离目录做一次恢复测试配图

sudo install -d -m 0700 /root/borg-restore-check
cd /root/borg-restore-check
borg extract --list "$BORG_REPO::$ARCHIVE" etc/hostname
test -f /root/borg-restore-check/etc/hostname

预期结果是提取列表包含 etc/hostname,且测试目录中出现该文件。若源文件从备份至测试期间没有变化,还可以比较内容:

cmp /etc/hostname /root/borg-restore-check/etc/hostname

cmp 成功退出表示两份文件内容一致;若当前系统的主机名文件已被修改,比较不同不必然说明归档损坏,应对照备份时间和变更记录判断。业务数据也应选取一份已确认纳入归档的代表性文件,在隔离目录按同样方式提取并校验。只看 borg list 而不做提取,无法完成恢复验收。

恢复测试结束后,先确认 /root/borg-restore-check 中只有本次测试生成的文件,再按本机变更管理要求清理;不要在未核对路径时执行递归删除。

失败时按连接、权限、仓库、文件逐层定位

首次运行遇到错误时,按较低风险的检查顺序处理,避免一开始就改 SSH 全局配置或仓库权限。

  1. 连接或主机密钥失败:核对域名、端口、备份服务器 SSH 服务状态及可信指纹。超时通常先指向网络或端口可达性;主机密钥不匹配则需要确认目标身份,不能直接接受新密钥。
  2. 公钥认证失败:核对客户端使用的是否为 /root/.ssh/borg_client01,并检查备份服务器 authorized_keys 的公钥内容、属主和权限。修改前保存原有密钥行,避免影响该账户已有任务。
  3. 能建立 SSH 连接但 Borg 报远程命令或路径错误:核对强制命令中的 /usr/bin/borg、两端 Borg 主版本及 --restrict-to-path 范围。普通 ssh borgstore@backup.example.net 并不是登录测试:受限密钥本来就不应获得交互式 shell。
  4. 仓库可访问但创建或恢复失败:先检查备份服务器可用空间、仓库目录属主,再核对加密口令、归档名和源文件是否存在。若 borg check 报错,先保留仓库现状和错误输出,不要立即删除或重建仓库。

验收与回滚检查项

部署完成后,应能逐项回答以下问题:

  • 客户端和备份服务器运行的是预期的 Borg 1.x;客户端通过已核对指纹的 SSH 主机密钥连接。
  • borgstore 的公钥被限制为运行 borg serve,仓库目录不对其他普通账户开放。
  • borg info 能读取远程仓库,borg list 能找到首份归档及预期源文件,borg check 成功完成。
  • 至少一份归档文件已提取到隔离目录,能够打开;需要内容一致性验收时,已与对应备份时点的文件核对。
  • SSH 私钥、Borg 加密口令和密钥导出文件已有明确的保管位置与授权人员。

如需回滚首次部署,先停止计划任务及其他对该仓库的写入,确认是否已有需要保留的归档。不要直接删除 /srv/borg/repos/client01:删除会影响仓库内全部归档且难以恢复。可先将仓库移至备份服务器上的隔离位置并记录原路径;确认不再需要后,再按数据保留制度处理。需要恢复配置时,将仓库移回原路径并复核属主、权限与 borg info。撤销客户端访问则从 authorized_keys 中只移除这把客户端公钥对应的一行,并保留变更前副本;客户端上的私钥和密钥导出文件也应按凭据处置流程处理,而不是在尚未确认恢复需求时直接清除。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7023.html

相关推荐