rclone 是一款强大的命令行工具，支持在本地与多种云存储之间进行高效的数据同步和迁移。本文将介绍 rclone 的安装、配置及常用操作方法，帮助你快速上手。

一、安装 rclone

1. 公网环境安装（以 Ubuntu 为例）

1 2	curl https://downloads.rclone.org/v1.67.0/rclone-v1.67.0-linux-amd64.deb -o rclone-v1.67.0-linux-amd64.deb sudo dpkg -i rclone-v1.67.0-linux-amd64.deb

2. Mac 安装

1	brew install rclone

更多平台和安装方式可参考 rclone 官方下载页面。

二、配置 rclone

rclone 的配置文件默认位于 ~/.config/rclone/rclone.conf。你可以手动创建和编辑该文件，或通过 rclone config 命令进行交互式配置。

1. 创建配置目录

1	mkdir -p ~/.config/rclone

2. 编辑配置文件

以下是一个典型的配置示例，支持 swift 和 s3 两种后端：

cat > ~/.config/rclone/rclone.conf << EOF
[ss-data]
type = swift
env_auth = false
user = ${STORAGE_USER}
key = ${STORAGE_PASSWORD}
auth = https://{SS_ENDPOINT}/auth/v1.0
auth_version = 1

[s3-data]
type = s3
env_auth = true
access_key_id = ${S3_ACCESS_ID}
secret_access_key = ${S3_SECRET_KEY}
region = us-east-1
endpoint = https://${S3_ENDPOINT}
EOF

请根据实际账号和密钥替换 ${STORAGE_USER}, ${STORAGE_PASSWORD},${S3_ACCESS_ID},${S3_SECRET_KEY} 等变量。

三、常用命令

1. 查看目录

1	rclone lsd ss-data:bucketname

2. 查看文件

1	rclone ls ss-data:bucketname/path/file.txt

3. 拷贝文件

将文件从一个存储拷贝到另一个存储：

1	rclone copy ss-data:bucketname/path/file.txt s3-data:bucketname2/path/ -P

4. 目录同步

rclone copy 拷贝文件

rclone copy 只会把源目录的内容复制到目标目录，不会删除目标目录中多余的文件。

1	rclone copy ./local_dir ss-data:bucketname/remote_dir -P --transfers=32 --checkers=32 --retries=8 --log-level INFO

-P
显示进度条（progress），包括传输速度、已完成/剩余数据量、预计剩余时间等信息，便于实时观察任务进度。
–transfers=32
同时进行的文件传输任务数，默认值通常为4。设置为32可以大幅提升并发传输能力，适合大量小文件或高带宽场景，但过高可能导致资源争用或被服务端限流。
–checkers=32
并发校验文件（如比对源和目标文件是否一致）的线程数。默认值通常为8。提高该值可以加快大批量文件的校验速度，适合大规模同步。
–retries=8
单个文件传输失败时的重试次数。默认值为3。设置为8可以增强在网络不稳定或偶发错误情况下的容错能力，减少因偶发错误导致的整体失败。
–log-level INFO
设置日志输出级别为 INFO，显示一般性的信息、进度和警告。常用级别有 DEBUG、INFO、NOTICE、ERROR。INFO 适合日常使用，既能看到关键日志，又不会太冗杂。