rclone · "云存储的 rsync" 命令行同步工具 · 中文部署与使用全指南
项目仓库: https://github.com/rclone/rclone
开源协议:MIT · 实现语言:Go · 形态:单二进制 CLI · 支持云存储:100+ 提供商 · 虚拟后端:Crypt / Chunker / Compress / Union / Combine 等 · 无常驻服务(可选 FUSE mount / serve)
说明:rclone 官方 logo 为 SVG,按规程本篇不设封面、正文不强配图。
1 项目简介
rclone(仓库名 rclone/rclone)是一个命令行程序,口号是
"rsync for cloud
storage"——在本地与各种云存储之间同步文件和目录。它支持 100+
云存储提供商,从 S3、Google
Drive、Dropbox、OneDrive、WebDAV、SFTP、FTP,到阿里云 OSS、腾讯云
COS、华为 OBS、Cloudflare R2、MinIO 等,几乎覆盖主流对象存储与网盘。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | rclone |
| 仓库地址 | github.com/rclone/rclone |
| 项目定位 | 多云存储之间的命令行同步("云存储的 rsync") |
| 开源协议 | MIT |
| 实现语言 | Go |
| 支持后端 | 100+(S3/GD/Dropbox/OneDrive/WebDAV/SFTP/FTP/阿里云OSS/腾讯COS/Cloudflare R2/MinIO 等) |
| 虚拟后端 | Crypt(加密)/ Chunker(分块)/ Compress(压缩)/ Union / Combine / Alias |
| 形态 | 单二进制 CLI,可选 FUSE 挂载 / serve |
1.2 适用场景
- 在本地与对象存储 / 网盘之间批量同步、上传、下载。
- 多个云账号之间迁移数据。
- 给备份软件(如 restic、Borg)做后端桥接(rclone backend)。
- 把云盘挂载成本地目录(FUSE)或通过 HTTP/WebDAV/FTP/SFTP/DLNA 对外 serve。
1.3 能力边界(官方口径)
- 全程校验 MD5/SHA-1 完整性;保留时间戳。
- 同步是文件级的;支持 copy(只拷新/改)、sync(单向镜像)、bisync(双向同步)、check(哈希校验)。
2 功能特性
- 100+ 后端:覆盖主流对象存储、网盘、协议。
- 多种模式:copy / sync(单向)/ bisync(双向)/ check。
- 虚拟后端:Crypt 加密、Chunker 大文件分块、Compress 压缩、Union 合并多远端、Combine 组合目录树。
- FUSE 挂载:
rclone mount把远端挂载成本地盘。 - serve:通过 HTTP/WebDAV/FTP/SFTP/DLNA 对外提供本地或远端文件。
- 多线程下载:多线程拉取到本地盘。
3 官方界面预览
rclone 是纯命令行工具,无图形界面,按规程不配图。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/rclone/rclone | 源码与 README |
| 官网 | rclone.org | 文档、下载、安装 |
| 文档 | rclone.org/docs | 配置与命令 |
| 安装 | rclone.org/install | 各平台安装 |
| 后端列表 | rclone.org/overview | 全部存储提供商 |
| 论坛 | forum.rclone.org | 问答 |
5 前置要求
- 安装 rclone(单二进制或包管理器)。
- 准备好各云存储的账号 / Access Key / Secret。
6 方式一:安装与配置远端
# 安装(官方一键脚本)
curl https://rclone.org/install.sh | sudo bash
# 交互式配置远端(向导选择后端、填凭据)
rclone configrclone config 会引导你选后端(S3、Google Drive、WebDAV
等)、填凭据,命名为一个 remote(如 myremote:)。
7 方式二:常用同步命令
# 列远端
rclone lsd myremote:
# 拷贝(只拷新/改)
rclone copy /本地目录 myremote:桶/目录
# 单向镜像同步(使目标与源一致)
rclone sync /本地目录 myremote:桶/目录
# 双向同步
rclone bisync /本地目录 myremote:桶/目录
# 哈希校验
rclone check /本地目录 myremote:桶/目录
# FUSE 挂载
rclone mount myremote: /mnt/cloud
# 对外 serve
rclone serve http myremote: --addr 0.0.0.0:80808 配置项说明
- 配置文件默认在
~/.config/rclone/rclone.conf(含各 remote 的凭据)。 - 虚拟后端通过 remote 链叠加:如先配一个
s3:remote,再配crypt:remote 指向它做加密。 - 各后端详细参数见
rclone.org/docs/对应后端页。
9 常用运维命令
rclone config # 增删改 remote
rclone dedupe # 去重
rclone mount ... & # 后台挂载
rclone version # 版本10 常见故障排查
- 凭据错误:重跑
rclone config检查该 remote 的 key/secret。 - 同步量大耗时长:用
--progress看进度,加--transfers/--checkers调并发。 - 不小心删了远端文件:
sync是镜像模式,会删目标多余文件;先用--dry-run演练。 - 挂载后文件管理器卡:FUSE mount 配合
--vfs-cache-mode改善。
11 风险与合规说明
- MIT
许可;配置文件含各云存储明文凭据,务必严格权限(
chmod 600)。 sync是破坏性镜像操作,生产前务必--dry-run。- 跨云迁移注意各厂商限流与费用。
- 本文命令来自官方 README 与文档,随版本可能调整,以 rclone.org 为准。