使用 rclone 同步文件
使用 rclone 将文件同步到 S3 存储或 SFTP 服务器:客户端加密、归档、systemd 定时计划与恢复测试。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南将说明如何使用 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:请调整该名称。
-
创建配置文件,仅
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 -
添加以下内容:
配置[hms-s3] type = s3 provider = Other access_key_id = 您的访问密钥 secret_access_key = 您的秘密密钥 endpoint = https://s3.lyn.io.hostmyservers.net acl = private对于其他兼容 S3 的提供商,请修改
endpoint,并在其要求时添加region = 您的区域。 -
测试访问,并在存储桶尚不存在时创建它:
终端sudo rclone lsd hms-s3: sudo rclone mkdir hms-s3:mes-sauvegardes
添加加密
crypt 类型会在发送之前对内容以及文件名和目录名进行加密。它作为存储之上的一层使用。
-
生成两个密钥,并创建加密存储
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 -
将显示的两个值复制到您的密码管理器中,然后也将
rclone.conf文件备份到服务器之外:终端sudo cat /root/.config/rclone/rclone.conf -
检查名称在远程端确实已被加密:
终端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。请将该路径替换为您自己的目录。
-
创建排除列表:
终端sudo nano /etc/rclone-sync.filter文本- *.tmp - .cache/** - node_modules/** -
同步之前务必先模拟:
终端sudo rclone sync /srv/data hms-crypt:current --filter-from /etc/rclone-sync.filter --dry-run --verbose -
如果列表符合您的预期,就开始发送:
终端sudo rclone sync /srv/data hms-crypt:current --filter-from /etc/rclone-sync.filter --progress -
检查结果:
终端sudo rclone cryptcheck /srv/data hms-crypt:current --one-way --filter-from /etc/rclone-sync.filter
测试恢复
请现在就进行此测试,之后定期进行。只有当您知道如何读取并解密远程副本时,它才有用。
-
将全部内容恢复到一个临时目录并进行比较:
终端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只应出现被排除或自同步以来被修改的文件。
-
同时也测试恢复单个文件,并相应调整其路径:
终端sudo rclone copyto hms-crypt:current/dossier/fichier.txt /var/tmp/fichier-restaure.txt -
在另一台机器上测试恢复:安装 rclone,从您的外部副本中将
rclone.conf放回/root/.config/rclone/,然后运行同样的rclone copy命令。该测试可以证明您保存的配置副本是完整的。 -
然后删除测试文件:
终端sudo rm -rf /var/tmp/rclone-restore /var/tmp/fichier-restaure.txt
安排同步计划
下面的脚本会将每个被替换或被删除的文件移动到带日期的归档目录中,并保留最近 30 个归档。
-
创建脚本:
终端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会中断操作。当源目录被错误地置空时(例如某个磁盘没有挂载),此限制可以保护您的数据。请根据您的数据量进行调整。 -
创建服务:
终端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 -
创建定时器:
终端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 -
启用定时器并运行第一次:
终端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.txtHMS 方案页面上宣布的版本控制可以作为这一机制的补充。此时保留的版本会计入计费的容量。
使用其他服务:SFTP 示例
rclone 支持众多服务,其文档中列出了它们。下面介绍如何通过 SFTP 连接另一台服务器,此处为 backup.您的域名.com。
-
创建一把专用密钥,将其安装到远程服务器上,并记录其指纹:
终端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首次连接时,请先将显示的指纹与远程服务器的指纹进行比对,再接受。
-
将以下内容添加到
/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 -
测试访问:
终端sudo rclone mkdir backup-sftp:rclone sudo rclone lsd backup-sftp: -
若也要加密这些数据,请创建第二个
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 listremotesSignatureDoesNotMatch、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