使用 Restic 进行加密备份
使用 Restic 将 Linux 服务器备份到兼容 S3 的存储:加密、systemd 定时计划、保留策略、校验与恢复测试。
本页内容
本指南将说明如何使用 Restic 将您的 VPS 或独立服务器备份到兼容 S3 的存储。Restic 会在服务器上先加密数据再发送,只传输发生变化的部分,并保留多个恢复点,即快照(snapshots)。
您将配置每日备份、保留策略、每周一次的完整性检查,以及最重要的恢复测试。在该测试成功之前,请认为您还没有备份。
先决条件
- 运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04,且拥有
sudo权限的服务器 - 兼容 S3 的存储上的一个存储桶(bucket),以及访问密钥和秘密密钥
- 系统时钟准确:请参阅我们的指南配置 NTP
- 一个位于服务器之外的位置,用于保存仓库密码,例如密码管理器
无需开放任何入站端口。服务器只需能够通过出站端口 443 以 HTTPS 访问存储即可。
选择存储
示例使用兼容 S3 的 HostMyServers Object Storage,该页面上公布的端点为 https://s3.lyn.io.hostmyservers.net。存储桶名为 mes-sauvegardes,目录 web01 代表您的服务器:请调整这两个名称。
如果使用其他兼容 S3 的提供商,只需将 RESTIC_REPOSITORY 中的地址替换为其提供的地址。
安装 Restic
发行版的软件包可能比较陈旧。请安装项目发布的官方二进制文件。截至撰写本文时,最新版本是 0.19.1:请查看版本页面,必要时调整 RESTIC_VERSION。
RESTIC_VERSION="0.19.1"
ARCH="$(dpkg --print-architecture)"
FILE="restic_${RESTIC_VERSION}_linux_${ARCH}.bz2"
cd /tmp
curl -fsSLO "https://github.com/restic/restic/releases/download/v${RESTIC_VERSION}/${FILE}"
curl -fsSLO "https://github.com/restic/restic/releases/download/v${RESTIC_VERSION}/SHA256SUMS"
sha256sum --check --ignore-missing SHA256SUMS校验必须显示 OK。然后安装二进制文件:
bunzip2 "$FILE"
sudo install -m 755 "${FILE%.bz2}" /usr/local/bin/restic
restic version如果没有 bunzip2,请使用 sudo apt install -y bzip2 安装。
准备配置
-
创建配置目录和仓库密码:
终端sudo install -d -m 700 /etc/restic sudo sh -c 'umask 077; openssl rand -base64 32 > /etc/restic/password' sudo cat /etc/restic/password -
创建环境文件:
终端sudo install -m 600 /dev/null /etc/restic/restic.env sudo nano /etc/restic/restic.env配置RESTIC_REPOSITORY='s3:https://s3.lyn.io.hostmyservers.net/mes-sauvegardes/web01' RESTIC_PASSWORD_FILE='/etc/restic/password' AWS_ACCESS_KEY_ID='您的访问密钥' AWS_SECRET_ACCESS_KEY='您的秘密密钥'如果您的提供商要求指定区域,请添加
AWS_DEFAULT_REGION='您的区域'。 -
列出需要备份的目录。只填写已存在的路径:
终端sudo nano /etc/restic/paths文本/etc /home /root /var/www /var/backups -
列出需要忽略的内容:
终端sudo nano /etc/restic/excludes文本/home/*/.cache /root/.cache /var/www/*/cache **/node_modules *.tmp -
创建一个加载该配置的小命令:
终端sudo nano /usr/local/sbin/restic-env终端#!/bin/sh set -a . /etc/restic/restic.env set +a exec /usr/local/bin/restic "$@"终端sudo chmod 700 /usr/local/sbin/restic-env
创建仓库并运行第一次备份
-
初始化仓库:
终端sudo restic-env init -
模拟备份,以检查将被纳入的文件:
终端sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --dry-run --verbose -
运行备份:
终端sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto -
检查结果:
终端sudo restic-env snapshots sudo restic-env ls latest /etc/hostname sudo restic-env checkcheck必须以no errors were found结束。
测试恢复
请现在就进行此测试,之后至少每季度一次。它分为三个级别,从最快到最完整。
级别 1:单个文件
sudo rm -rf /var/tmp/restic-test
sudo restic-env restore latest --target /var/tmp/restic-test --include /etc/hostname
sudo diff /etc/hostname /var/tmp/restic-test/etc/hostname && echo "Identical"级别 2:完整目录
sudo restic-env restore latest:/etc --target /var/tmp/restic-test/etc-full
sudo diff -r /etc /var/tmp/restic-test/etc-full | head -n 20
sudo stat -c '%U:%G %a %n' /etc/shadow /var/tmp/restic-test/etc-full/shadowdiff 中只应出现自备份以来被修改的文件。shadow 的属主和权限必须一致。然后删除该目录,因为其中包含敏感数据:
sudo rm -rf /var/tmp/restic-test级别 3:在另一台服务器上恢复
这项测试可以证明,在服务器彻底丢失之后,您仍然能够重新开始。请在另一台机器上进行:
-
按上述方法安装 Restic。
-
根据您在外部保存的副本,重新创建
/etc/restic/restic.env、/etc/restic/password和/usr/local/sbin/restic-env。 -
恢复到一个专用目录,而不覆盖系统:
终端sudo restic-env snapshots --host web01 sudo restic-env restore latest --host web01 --target /var/restore -
检查您的文件,然后按照相应的指南,从导出文件中恢复数据库。
请记录测试日期和所需时间:这是对您实际恢复时间的良好估计。此处的 web01 对应原服务器的主机名,由 restic-env snapshots 显示。
使用 systemd 安排备份计划
-
创建备份服务:
终端sudo nano /etc/systemd/system/restic-backup.service配置[Unit] Description=Restic backup Wants=network-online.target After=network-online.target [Service] Type=oneshot EnvironmentFile=/etc/restic/restic.env Environment=HOME=/root Environment=RESTIC_CACHE_DIR=/var/cache/restic CacheDirectory=restic CacheDirectoryMode=0700 Nice=10 IOSchedulingClass=idle ExecStart=/usr/local/bin/restic backup --retry-lock 1h --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto -
创建其定时器:
终端sudo nano /etc/systemd/system/restic-backup.timer配置[Unit] Description=Daily Restic backup [Timer] OnCalendar=*-*-* 03:30:00 RandomizedDelaySec=20min Persistent=true [Install] WantedBy=timers.target -
创建维护服务,它会先应用保留策略,再检查仓库:
终端sudo nano /etc/systemd/system/restic-maintenance.service配置[Unit] Description=Restic retention and check Wants=network-online.target After=network-online.target [Service] Type=oneshot EnvironmentFile=/etc/restic/restic.env Environment=HOME=/root Environment=RESTIC_CACHE_DIR=/var/cache/restic CacheDirectory=restic CacheDirectoryMode=0700 Nice=10 IOSchedulingClass=idle ExecStart=/usr/local/bin/restic forget --retry-lock 1h --tag auto --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune ExecStart=/usr/local/bin/restic check --retry-lock 1h --read-data-subset=5%%%符号被写了两次,因为 systemd 在其单元文件中赋予它特殊含义。 -
创建其定时器:
终端sudo nano /etc/systemd/system/restic-maintenance.timer配置[Unit] Description=Weekly Restic maintenance [Timer] OnCalendar=Sun *-*-* 05:00:00 RandomizedDelaySec=20min Persistent=true [Install] WantedBy=timers.target -
启用这两个定时器,并通过该方式运行一次备份:
终端sudo systemctl daemon-reload sudo systemctl enable --now restic-backup.timer restic-maintenance.timer sudo systemctl start restic-backup.service sudo systemctl status restic-backup.service --no-pager systemctl list-timers 'restic-*'
使用 sudo journalctl -u restic-backup.service -n 50 --no-pager 查看日志。请记得监控这些服务:备份连续数周悄无声息地失败,是一种常见的风险。如果失败,systemctl --failed 会将它们列出来。
了解保留策略
| 选项 | 保留内容 |
|---|---|
--keep-daily 7 |
在最近 7 个有快照的日子中,每一天的最后一个快照 |
--keep-weekly 4 |
在最近 4 个有快照的周中,每一周的最后一个快照 |
--keep-monthly 6 |
在最近 6 个有快照的月中,每一个月的最后一个快照 |
forget 会移除快照,随后 --prune 会释放相应的空间。在更改这些值之前,请先模拟结果:
sudo restic-env forget --tag auto --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --dry-run--read-data-subset=5% 每次运行时都会下载并检查约 5 % 数据的随机样本。若要检查全部数据,请使用 --read-data,它耗时更长,传输量也更大。
降低风险
- 存储在服务器上的密钥可以用来删除仓库。如果攻击者控制了服务器,他也能够触及您的备份。
- HMS 方案在其介绍页面上宣布提供版本控制(versioning)和生命周期规则。版本控制可以让您找回被覆盖或被删除的对象,但保留的版本会计入计费的容量。
- 第二个仓库密钥可以避免只依赖一个密码。请使用
sudo restic-env key add添加,并同样将它保存在服务器之外。
更新 Restic
官方二进制文件会在验证其签名之后自行更新:
sudo restic self-update
restic version您的数据仍保留在仓库中。重大更新之后,请再次运行 sudo restic-env check 以及一次级别 1 的恢复测试。
故障排除
wrong password or no key found
/etc/restic/password 的内容与仓库不匹配。请从您的外部副本恢复密码。如果没有任何有效的密码,数据将无法找回。
repository does not exist: unable to open config file
该地址上尚未初始化仓库,或者地址有误。请检查 RESTIC_REPOSITORY、存储桶名称和目录。只有确认这是一个新仓库时,才运行 sudo restic-env init。
repository is already locked
另一项操作正在进行,或者之前的某项操作被中断了。请先确认使用该仓库的所有服务器上都没有 Restic 在运行:
pgrep -a restic
sudo restic-env list locks然后只移除已过期的锁:
sudo restic-env unlockSignatureDoesNotMatch、InvalidAccessKeyId 或 AccessDenied
密钥不正确,或无权访问该存储桶。请检查 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 以及您的服务所显示的端点。如果错误提到区域,请添加 AWS_DEFAULT_REGION,其值由您的存储提供商给出,或通过客户中心联系支持团队。
RequestTimeTooSkewed
服务器的时钟存在偏差。请使用 timedatectl 检查,然后按照我们的指南配置 NTP 进行校正。
NoSuchBucket
存储桶不存在,或名称拼写有误。请在您的客户中心创建它,然后重新运行 init。
no such host 或超时
请检查端点、DNS 解析以及通往 443 端口的出站连接:
curl -I https://s3.lyn.io.hostmyservers.net任何 HTTP 响应,即使是 403 错误,也说明该服务可以访问。
服务以退出码 3 结束
快照已创建,但部分文件无法读取。日志中列出了这些文件。请修正权限,排除临时文件,然后重新运行备份。
仓库在 check 时报告错误
请不要运行 forget 或 prune,保持当前状态,并按照官方故障排除流程操作。