中文

Linux 与网络

使用 rclone 同步文件

使用 rclone 将文件同步到 S3 存储或 SFTP 服务器:客户端加密、归档、systemd 定时计划与恢复测试。

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

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南将说明如何使用 rclone 将您的 VPS 或独立服务器上的文件发送到兼容 S3 的存储或其他服务,例如 SFTP 服务器。数据在发出之前会先加密,同步任务将按计划执行,并且您会验证自己确实能够取回数据。

先决条件

  • 运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04,且拥有 sudo 权限的服务器
  • 一个带访问密钥和秘密密钥的 S3 存储桶,或一台 SFTP 服务器
  • 系统时钟准确:请参阅我们的指南配置 NTP
  • 一个位于服务器之外的位置,用于保存 rclone 配置和密码

无需开放任何入站端口。服务器必须能够访问外部的 443 端口(S3),或远程服务器的 SSH 端口(SFTP)。

安装 rclone

项目方不建议使用发行版的软件包,因为它们往往比较陈旧。请安装官方软件包。截至撰写本文时,当前版本是 1.76.0:请查看下载页面,必要时调整 RCLONE_VERSION。

终端
RCLONE_VERSION="v1.76.0"
ARCH="$(dpkg --print-architecture)"
FILE="rclone-${RCLONE_VERSION}-linux-${ARCH}.deb"
cd /tmp
curl -fsSLO "https://downloads.rclone.org/${RCLONE_VERSION}/${FILE}"
curl -fsSLO "https://downloads.rclone.org/${RCLONE_VERSION}/SHA256SUMS"
sha256sum --check --ignore-missing SHA256SUMS
sudo apt install -y "./${FILE}"
rclone version

对于该软件包,校验必须显示 OK。出现有关格式不正确的行的警告属于正常现象,因为该文件同时包含其签名。

配置 S3 存储

示例使用兼容 S3 的 HostMyServers Object Storage,该页面上公布的端点为 https://s3.lyn.io.hostmyservers.net。存储桶名为 mes-sauvegardes:请调整该名称。

  1. 创建配置文件,仅 root 可读:

    终端
    sudo install -d -m 700 /root/.config /root/.config/rclone
    sudo install -m 600 /dev/null /root/.config/rclone/rclone.conf
    sudo nano /root/.config/rclone/rclone.conf
  2. 添加以下内容:

    配置
    [hms-s3]
    type = s3
    provider = Other
    access_key_id = 您的访问密钥
    secret_access_key = 您的秘密密钥
    endpoint = https://s3.lyn.io.hostmyservers.net
    acl = private

    对于其他兼容 S3 的提供商,请修改 endpoint,并在其要求时添加 region = 您的区域。

  3. 测试访问,并在存储桶尚不存在时创建它:

    终端
    sudo rclone lsd hms-s3:
    sudo rclone mkdir hms-s3:mes-sauvegardes

添加加密

crypt 类型会在发送之前对内容以及文件名和目录名进行加密。它作为存储之上的一层使用。

  1. 生成两个密钥,并创建加密存储 hms-crypt:

    终端
    CRYPT_PASS="$(openssl rand -hex 32)"
    CRYPT_SALT="$(openssl rand -hex 32)"
    sudo rclone config create hms-crypt crypt remote=hms-s3:mes-sauvegardes/crypt filename_encryption=standard directory_name_encryption=true password="$CRYPT_PASS" password2="$CRYPT_SALT" --obscure
    printf 'password: %s\npassword2: %s\n' "$CRYPT_PASS" "$CRYPT_SALT"
    unset CRYPT_PASS CRYPT_SALT
  2. 将显示的两个值复制到您的密码管理器中,然后也将 rclone.conf 文件备份到服务器之外:

    终端
    sudo cat /root/.config/rclone/rclone.conf
  3. 检查名称在远程端确实已被加密:

    终端
    echo "rclone test" | sudo tee /tmp/rclone-test.txt > /dev/null
    sudo rclone copy /tmp/rclone-test.txt hms-crypt:test
    sudo rclone ls hms-crypt:test
    sudo rclone ls hms-s3:mes-sauvegardes/crypt
    sudo rclone purge hms-crypt:test

    第一份列表显示 rclone-test.txt,第二份显示的是无法辨认的名称。

使用标准加密时,请将文件名限制在约 143 个字符以内,以避免出现问题。

选择合适的命令

命令 效果 风险
rclone copy 复制新增或修改过的文件,不删除任何内容 低
rclone sync 使目标与源一致,包括删除操作 高
rclone move 先复制,再从源中删除 高
rclone check 比较源与目标 无
rclone cryptcheck 将本地文件与加密存储进行比较 无

运行第一次同步

示例同步的是 /srv/data。请将该路径替换为您自己的目录。

  1. 创建排除列表:

    终端
    sudo nano /etc/rclone-sync.filter
    文本
    - *.tmp
    - .cache/**
    - node_modules/**
  2. 同步之前务必先模拟:

    终端
    sudo rclone sync /srv/data hms-crypt:current --filter-from /etc/rclone-sync.filter --dry-run --verbose
  3. 如果列表符合您的预期,就开始发送:

    终端
    sudo rclone sync /srv/data hms-crypt:current --filter-from /etc/rclone-sync.filter --progress
  4. 检查结果:

    终端
    sudo rclone cryptcheck /srv/data hms-crypt:current --one-way --filter-from /etc/rclone-sync.filter

测试恢复

请现在就进行此测试,之后定期进行。只有当您知道如何读取并解密远程副本时,它才有用。

  1. 将全部内容恢复到一个临时目录并进行比较:

    终端
    sudo rm -rf /var/tmp/rclone-restore
    sudo rclone copy hms-crypt:current /var/tmp/rclone-restore --progress
    sudo diff -r /srv/data /var/tmp/rclone-restore | head -n 20

    只应出现被排除或自同步以来被修改的文件。

  2. 同时也测试恢复单个文件,并相应调整其路径:

    终端
    sudo rclone copyto hms-crypt:current/dossier/fichier.txt /var/tmp/fichier-restaure.txt
  3. 在另一台机器上测试恢复:安装 rclone,从您的外部副本中将 rclone.conf 放回 /root/.config/rclone/,然后运行同样的 rclone copy 命令。该测试可以证明您保存的配置副本是完整的。

  4. 然后删除测试文件:

    终端
    sudo rm -rf /var/tmp/rclone-restore /var/tmp/fichier-restaure.txt

安排同步计划

下面的脚本会将每个被替换或被删除的文件移动到带日期的归档目录中,并保留最近 30 个归档。

  1. 创建脚本:

    终端
    sudo nano /usr/local/sbin/rclone-sync.sh
    终端
    #!/bin/bash
    set -euo pipefail
    
    SOURCE="/srv/data"
    REMOTE="hms-crypt:"
    KEEP_ARCHIVES=30
    STAMP="$(date +%F_%H%M%S)"
    
    rclone sync "$SOURCE" "${REMOTE}current" \
      --backup-dir "${REMOTE}archive/$STAMP" \
      --filter-from /etc/rclone-sync.filter \
      --max-delete 1000 \
      --fast-list \
      --log-level INFO \
      --stats 5m \
      --stats-one-line
    
    { rclone lsf --dirs-only "${REMOTE}archive" 2>/dev/null || true; } |
      sort | head -n -"$KEEP_ARCHIVES" |
      while IFS= read -r dir; do
        rclone purge "${REMOTE}archive/${dir%/}"
      done

    如果将有超过 1 000 个文件被删除,--max-delete 1000 会中断操作。当源目录被错误地置空时(例如某个磁盘没有挂载),此限制可以保护您的数据。请根据您的数据量进行调整。

  2. 创建服务:

    终端
    sudo chmod 700 /usr/local/sbin/rclone-sync.sh
    sudo nano /etc/systemd/system/rclone-sync.service
    配置
    [Unit]
    Description=rclone sync
    Wants=network-online.target
    After=network-online.target
    
    [Service]
    Type=oneshot
    Environment=HOME=/root
    Nice=10
    IOSchedulingClass=idle
    ExecStart=/usr/local/sbin/rclone-sync.sh
  3. 创建定时器:

    终端
    sudo nano /etc/systemd/system/rclone-sync.timer
    配置
    [Unit]
    Description=Daily rclone sync
    
    [Timer]
    OnCalendar=*-*-* 04:15:00
    RandomizedDelaySec=20min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  4. 启用定时器并运行第一次:

    终端
    sudo systemctl daemon-reload
    sudo systemctl enable --now rclone-sync.timer
    sudo systemctl start rclone-sync.service
    sudo journalctl -u rclone-sync.service -n 30 --no-pager

要找回旧版本,请列出归档,然后复制所需的文件:

终端
sudo rclone lsf hms-crypt:archive
sudo rclone copyto hms-crypt:archive/2026-11-18_041500/dossier/fichier.txt /var/tmp/ancienne-version.txt

HMS 方案页面上宣布的版本控制可以作为这一机制的补充。此时保留的版本会计入计费的容量。

使用其他服务:SFTP 示例

rclone 支持众多服务,其文档中列出了它们。下面介绍如何通过 SFTP 连接另一台服务器,此处为 backup.您的域名.com。

  1. 创建一把专用密钥,将其安装到远程服务器上,并记录其指纹:

    终端
    sudo install -d -m 700 /root/.ssh
    sudo ssh-keygen -t ed25519 -N '' -C 'rclone' -f /root/.ssh/rclone_sftp
    sudo ssh-copy-id -i /root/.ssh/rclone_sftp.pub 您的用户名@backup.您的域名.com
    sudo ssh -i /root/.ssh/rclone_sftp 您的用户名@backup.您的域名.com true

    首次连接时,请先将显示的指纹与远程服务器的指纹进行比对,再接受。

  2. 将以下内容添加到 /root/.config/rclone/rclone.conf:

    配置
    [backup-sftp]
    type = sftp
    host = backup.您的域名.com
    user = 您的用户名
    port = 22
    key_file = /root/.ssh/rclone_sftp
    known_hosts_file = /root/.ssh/known_hosts
  3. 测试访问:

    终端
    sudo rclone mkdir backup-sftp:rclone
    sudo rclone lsd backup-sftp:
  4. 若也要加密这些数据,请创建第二个 crypt 存储:

    终端
    CRYPT_PASS="$(openssl rand -hex 32)"
    CRYPT_SALT="$(openssl rand -hex 32)"
    sudo rclone config create sftp-crypt crypt remote=backup-sftp:rclone/crypt password="$CRYPT_PASS" password2="$CRYPT_SALT" --obscure
    printf 'password: %s\npassword2: %s\n' "$CRYPT_PASS" "$CRYPT_SALT"
    unset CRYPT_PASS CRYPT_SALT

    请将这些值保存在服务器之外,然后在脚本中指定 REMOTE="sftp-crypt:",以使用该目标。

更新 rclone

终端
rclone selfupdate --check
sudo rclone selfupdate --package deb
rclone version

更新之后,请手动运行同步并查看其日志。

故障排除

didn't find section in config file

冒号前的名称与配置中的任何段都不匹配,或者 rclone 读取的是另一个文件。使用 sudo 时,请检查:

终端
sudo rclone config file
sudo rclone listremotes

SignatureDoesNotMatch、InvalidAccessKeyId 或 AccessDenied

请检查两个密钥以及您的服务所显示的端点。如果错误提到区域,请添加 region,其值由您的存储提供商给出,或通过客户中心联系支持团队。

RequestTimeTooSkewed

服务器的时钟存在偏差。请使用 timedatectl 检查,然后按照我们的指南配置 NTP 操作。

NoSuchBucket 或 directory not found

存储桶或路径不存在。请使用 sudo rclone lsd hms-s3: 检查其名称。对于源目录,请确认它在服务器上确实存在。

failed to authenticate decrypted block - bad password?

crypt 密码与数据不匹配,或者远程文件已损坏。请从您的外部副本恢复 rclone.conf,不要使用新的密钥重新创建加密存储。

--max-delete threshold reached

删除的数量超过了您设置的上限,操作随即停止。请先确认源是完整的,然后使用 --dry-run 检查。只有在这些删除确实是您想要的情况下,才提高该上限。

file name too long

加密后的名称超出了存储的限制。请缩短相关名称,目标是最多 143 个字符。

服务失败且没有明确的信息

请手动运行脚本,并在 rclone sync 命令中加上 --log-level DEBUG 以提高详细程度,然后查看:

终端
sudo systemctl status rclone-sync.service --no-pager
sudo journalctl -u rclone-sync.service -n 100 --no-pager

参考资料