中文

Linux 与网络

使用 Restic 进行加密备份

使用 Restic 将 Linux 服务器备份到兼容 S3 的存储:加密、systemd 定时计划、保留策略、校验与恢复测试。

阅读约 7 分钟, 更新于 2026年11月18日

本页内容

本指南将说明如何使用 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 安装。

准备配置

  1. 创建配置目录和仓库密码:

    终端
    sudo install -d -m 700 /etc/restic
    sudo sh -c 'umask 077; openssl rand -base64 32 > /etc/restic/password'
    sudo cat /etc/restic/password
  2. 创建环境文件:

    终端
    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='您的区域'。

  3. 列出需要备份的目录。只填写已存在的路径:

    终端
    sudo nano /etc/restic/paths
    文本
    /etc
    /home
    /root
    /var/www
    /var/backups
  4. 列出需要忽略的内容:

    终端
    sudo nano /etc/restic/excludes
    文本
    /home/*/.cache
    /root/.cache
    /var/www/*/cache
    **/node_modules
    *.tmp
  5. 创建一个加载该配置的小命令:

    终端
    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

创建仓库并运行第一次备份

  1. 初始化仓库:

    终端
    sudo restic-env init
  2. 模拟备份,以检查将被纳入的文件:

    终端
    sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --dry-run --verbose
  3. 运行备份:

    终端
    sudo restic-env backup --files-from /etc/restic/paths --exclude-file /etc/restic/excludes --exclude-caches --tag auto
  4. 检查结果:

    终端
    sudo restic-env snapshots
    sudo restic-env ls latest /etc/hostname
    sudo restic-env check

    check 必须以 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/shadow

diff 中只应出现自备份以来被修改的文件。shadow 的属主和权限必须一致。然后删除该目录,因为其中包含敏感数据:

终端
sudo rm -rf /var/tmp/restic-test

级别 3:在另一台服务器上恢复

这项测试可以证明,在服务器彻底丢失之后,您仍然能够重新开始。请在另一台机器上进行:

  1. 按上述方法安装 Restic。

  2. 根据您在外部保存的副本,重新创建 /etc/restic/restic.env、/etc/restic/password 和 /usr/local/sbin/restic-env。

  3. 恢复到一个专用目录,而不覆盖系统:

    终端
    sudo restic-env snapshots --host web01
    sudo restic-env restore latest --host web01 --target /var/restore
  4. 检查您的文件,然后按照相应的指南,从导出文件中恢复数据库。

请记录测试日期和所需时间:这是对您实际恢复时间的良好估计。此处的 web01 对应原服务器的主机名,由 restic-env snapshots 显示。

使用 systemd 安排备份计划

  1. 创建备份服务:

    终端
    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
  2. 创建其定时器:

    终端
    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
  3. 创建维护服务,它会先应用保留策略,再检查仓库:

    终端
    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 在其单元文件中赋予它特殊含义。

  4. 创建其定时器:

    终端
    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
  5. 启用这两个定时器,并通过该方式运行一次备份:

    终端
    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 unlock

SignatureDoesNotMatch、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,保持当前状态,并按照官方故障排除流程操作。

参考资料