rclone 是一个命令行的文件同步和管理工具。你可以把它想象成 rsync，但它的目标不是另一台服务器，而是各种云存储服务。

主要特性：

• 统一接口： 用一套命令（sync, copy, ls）管理所有云存储。
• 数据迁移： 可以在云A 和 云B 之间直接传输数据，无需先下载到本地。
• 挂载 (Mount)： 可以将云存储挂载为本地磁盘（需要 FUSE）。
• 加密 (Crypt)： 支持客户端加密，在上传前加密数据，保护隐私。
• 备份： 支持时间戳、保留旧版本和增量同步。

1. 安装

rclone 官方推荐使用一键安装脚本，这是最简单、最可靠的方式。

Bash

x
1
# 运行此命令将自动下载并安装 rclone
2
curl https://rclone.org/install.sh | sudo bash

这个脚本会自动识别你的操作系统和架构，并安装最新稳定版。

验证安装：

Bash

2
1
rclone --version
2
# 输出类似: rclone v1.6x.x

2. 核心概念：配置远程存储 (Remotes)

rclone 的一切操作都始于配置。你需要告诉 rclone 如何连接到你的云服务。每一个配置好的云服务（例如你的一个Google Drive账号）在 rclone 中被称为一个 "Remote" (远程存储)。

2.1. 交互式配置 (rclone config)

这是配置 rclone 的主要方式。这个过程是交互式的，会一步步引导你。

Bash

xxxxxxxxxx
1
1
rclone config

你会看到一个菜单。我们以配置一个 Google Drive 账号为例：

1. 输入 n (New remote)。
2. name>：给这个 Remote 起一个名字（例如 gdrive）。这个名字在后续命令中会用到。
3. Storage>：你会看到一个长长的列表，显示所有支持的存储。找到 "Google Drive" (例如编号 18)，输入编号后回车。
4. client_id> / client_secret>：直接按回车跳过（使用 rclone 默认的 API 密钥）。
5. scope>：选择访问权限。通常选 1 (Full access)。
6. root_folder_id> / service_account_file>：直接回车跳过。
7. Edit advanced config?：输入 n (No)。

2.2. 关键步骤：在无头服务器 (Headless Server) 上授权

如果你在没有图形界面的 Linux 服务器上配置（例如 SSH 连接），会遇到一个关键步骤：

1. Use auto config?：输入 n (No)。
2. 此时，rclone 会在终端里生成一个 URL 链接。
3. 在你的本地电脑上：复制这个链接，粘贴到你的本地浏览器中打开。
4. 在浏览器中，登录你的 Google 账号，并授权 rclone 访问。
5. 授权成功后，浏览器会显示一个验证码。
6. 回到你的 SSH 终端：复制这个验证码，粘贴到 rclone 的提示符（Enter verification code>）后面，回车。
7. Configure this as a team drive?：根据你的需求选 y / n。
8. 确认配置无误 ( y )，然后 q (Quit) 退出配置菜单。

配置完成后，所有的 "Remotes" 信息都保存在 ~/.config/rclone/rclone.conf 文件中。你可以备份这个文件，或者把它复制到其他机器上，实现 rclone 配置的迁移。

3. 基本命令（常用动词）

rclone 的命令结构非常清晰：

rclone [命令] [源路径] [目标路径] [标志]

• 本地路径：直接写路径，如 /var/log/
• 远程路径：使用 Remote名:路径，如 gdrive:MyBackups/logs/

3.1. lsd (列出目录)

只列出目录（不递归）。

5
1
# 列出 gdrive 这个 Remote 的根目录下所有文件夹
2
rclone lsd gdrive:
3
4
# 列出 gdrive 下 MyBackups 文件夹中的所有文件夹
5
rclone lsd gdrive:MyBackups

3.2. ls / lsl (列出文件和目录)

ls 递归列出所有文件。lsl 提供更详细的信息（大小、时间）。

5
1
# 列出 gdrive:MyBackups 里的所有文件（包括子目录）
2
rclone ls gdrive:MyBackups
3
4
# 详细列出本地 /var/www 目录的内容
5
rclone lsl /var/www

3.3. copy (复制)

将文件从源复制到目标，跳过已存在且未变化的文件。

2
1
# 把本地 /var/www 目录复制到 gdrive 的 www_backup 文件夹
2
rclone copy /var/www gdrive:www_backup

3.4. sync (同步) ⭐⭐⭐

这是最强大但也最危险的命令。

sync 会让目标目录变得和源目录完全一样。

• 它会复制新文件和变动的文件。
• 它会删除目标目录中存在、但源目录中不存在的文件！

⚠️ 警告： sync 是单向的。如果你把命令写反了（例如 rclone sync gdrive:www_backup /var/www），并且 gdrive:www_backup 是空的，它会清空你的 /var/www 目录！

3
1
# 正确示例：将本地 /var/www 同步到 gdrive:www_backup
2
# (gdrive:www_backup 中多余的文件将被删除)
3
rclone sync /var/www gdrive:www_backup

3.5. move (移动)

将文件从源移动到目标。rclone 会在复制成功后删除源文件。

2
1
# 把本地日志移动到云端，并删除本地文件
2
rclone move /var/log/old_logs gdrive:ArchivedLogs

3.6. delete / purge

delete 删除指定路径下的文件。purge 清空指定路径（删除目录及其中所有内容）。

5
1
# 删除云端的这个特定文件
2
rclone delete gdrive:www_backup/config.bak
3
4
# ！！！危险！！！清空云端的 www_backup 文件夹
5
rclone purge gdrive:www_backup

3.7. check (检查)

检查源和目标的文件是否一致，但不执行任何操作。非常适合在 sync 之前使用。

2
1
# 检查本地和云端有多少文件不同
2
rclone check /var/www gdrive:www_backup

4. 关键标志 (Flags) 和高级用法

标志 (Flags) 是 rclone 的精髓，它们可以精细控制命令的行为。

4.1. 救命稻草：--dry-run (演习)

在执行任何 copy, sync, move, delete 命令前，强烈建议先加上 --dry-run (或 -n) 标志。

它会模拟整个过程，告诉你它 打算 做什么（哪些文件会被复制/删除），但不会真的执行。

2
1
# 演习一次同步，看看哪些文件会被删除
2
rclone sync /var/www gdrive:www_backup --dry-run

4.2. 性能与限速

• --transfers=N：设置并行传输的文件数量（默认为 4）。如果你在小文件很多的情况下同步，可以调高它（如 16）来提速。

• --checkers=N：设置并行检查文件状态的数量（默认为 8）。

• --bwlimit=SIZE：限制带宽。非常有用，可以防止 rclone 占满你的服务器带宽。

  • --bwlimit=10M (限制为 10 MByte/s)
  • --bwlimit=8.5M (这是典型的 100Mbps 住宅带宽的上传限制)

2
1
# 在后台同步，设置16个并发，并限制带宽为 50M/s
2
rclone sync /data gdrive:data --transfers=16 --bwlimit=50M

4.3. 过滤器 (Filtering) ⭐

这是 rclone 另一个极其强大的功能，允许你精确控制哪些文件被传输。

• --exclude <pattern>：排除匹配模式的文件。
• --include <pattern>：包含匹配模式的文件。
• --filter-from <file>：从一个规则文件中读取过滤规则。

规则语法：

• *.log 匹配所有 log 文件
• config.ini 匹配特定文件
• /logs/** 匹配 logs 目录下的所有内容（** 表示递归）

示例：

14
1
# 同步时，排除所有的 .log 文件和 .git 目录
2
rclone sync /var/www gdrive:www_backup \
3
    --exclude "*.log" \
4
    --exclude ".git/**"
5
6
# 最佳实践：使用 filter-rules.txt 文件
7
# (filter-rules.txt 内容如下)
8
# - *.log
9
# - .git/**
10
# - cache/
11
# + *.jpg
12
# - *
13
# (上面的规则意思是：排除log和.git，只包含jpg，其他都排除)
14
rclone sync /var/www gdrive:www_backup --filter-from /root/filter-rules.txt

4.4. mount (挂载)

rclone mount 可以将云存储挂载到本地文件系统，使其看起来像一个本地硬盘。这需要 FUSE 支持。

1. 安装 FUSE:

4
1
# Debian / Ubuntu
2
sudo apt-get install fuse
3
# CentOS / RHEL
4
sudo yum install fuse

2. 创建挂载点并挂载:

10
1
# 1. 创建一个空目录作为挂载点
2
mkdir ~/gdrive_mount
3
4
# 2. 挂载
5
# --daemon 会让 rclone 在后台运行
6
rclone mount gdrive: ~/gdrive_mount --daemon
7
8
# 3. 现在你可以像操作本地文件夹一样操作 ~/gdrive_mount
9
ls ~/gdrive_mount
10
cp my_file.txt ~/gdrive_mount/

3. 卸载:

1
1
fusermount -u ~/gdrive_mount

注意： 挂载的性能和稳定性取决于网络和云服务商的 API。它适合用于读取、浏览和流式传输（如 Plex），但不太适合高 I/O 的数据库或编译操作。

4.5. crypt (客户端加密)

这是一个“包装器” (Wrapper) Remote。你可以创建一个 crypt 类型的 Remote，它会指向另一个你已经配置好的 Remote（比如 gdrive:）。

• 工作流： 本地文件 -> crypt Remote (加密) -> gdrive Remote (上传)
• 读取时： gdrive Remote (下载) -> crypt Remote (解密) -> 本地读取

配置 crypt 时 (rclone config)，它会要求你：

1. 选择一个已有的 Remote 作为“上游”（如 gdrive:EncryptedFiles）。
2. 设置一个强密码（和可选的“盐”）。

配置好后（假设你命名为 gdrive_crypt），你所有传到 gdrive_crypt: 的文件在上传到 Google Drive 之前都会被加密（包括文件名）。这样，云服务商也无法知道你存储了什么。

2
1
# 同步到加密的 Remote
2
rclone sync /secret/data gdrive_crypt:MySecrets

5. 实用场景示例

场景1：每日服务器网站备份 (Cron Job)

目标：每天凌晨 3 点，将 /var/www 和 /etc/nginx 备份到 Google Drive，排除日志和缓存文件，并限制带宽。

24
1
#!/bin/bash
2
# /root/backup.sh
3
4
LOG_FILE="/var/log/rclone_backup.log"
5
FILTER_FILE="/root/backup_filters.txt"
6
7
# 过滤器内容 (backup_filters.txt)
8
# - /var/www/cache/**
9
# - *.log
10
# - .git/**
11
12
echo "--- Backup started at $(date) ---" >> $LOG_FILE
13
14
rclone sync /var/www gdrive:ServerBackup/www \
15
    --filter-from $FILTER_FILE \
16
    --bwlimit=10M \
17
    --transfers=8 \
18
    --log-file=$LOG_FILE -v
19
20
rclone sync /etc/nginx gdrive:ServerBackup/nginx \
21
    --bwlimit=10M \
22
    --log-file=$LOG_FILE -v
23
24
echo "--- Backup finished at $(date) ---" >> $LOG_FILE

设置 Cron: crontab -e

0 3 * * * /bin/bash /root/backup.sh

场景2：云到云数据迁移

目标：将 OneDrive 上的所有 Photos 迁移到 S3 存储桶 my-s3-bucket。

4
1
# 假设你已配置好 onedrive: 和 s3:
2
# 使用高并发传输，因为云端带宽通常很高
3
rclone copy onedrive:Photos s3:my-s3-bucket/Photos --transfers=32 -P
4
# -P (或 --progress) 会实时显示进度

rclone 快速备忘录