Rclone 是一款开源的命令行工具,主要用于在不同存储服务间同步、传输和管理文件,支持本地存储与近 50 种云存储服务(如 Google Drive、AWS S3、阿里云 OSS 等)的交互。
一、核心功能
- 跨存储同步/传输:可在本地文件夹、FTP 服务器、云存储之间双向同步文件,支持增量同步(仅传输变化文件),大幅节省带宽和时间。
- 文件管理操作:提供类似
cp(复制)、mv(移动)、rm(删除)、ls(列表)等命令,能直接管理云存储中的文件,操作逻辑与本地命令一致。 - 挂载云存储为本地磁盘:通过
rclone mount命令,可将云存储(如 OneDrive)挂载到本地系统,像访问本地文件夹一样打开、编辑云端文件,无需手动下载。 - 数据备份与加密:支持将本地数据加密后上传到云存储,或解密下载;也可设置定时任务(结合
cron等工具)实现自动备份。
二、支持的主流存储类型
Rclone 支持的存储类型非常丰富,覆盖了主流云存储、本地/私有存储、分布式存储等,以下是经过整理的 主流支持类型列表(按类别划分):
一、公有云存储服务
文档/个人云盘
- Google Drive(包括团队盘、共享驱动器)
- Microsoft OneDrive(个人版、商业版、教育版)
- Dropbox(个人版、商业版)
- Box
- Yandex Disk
- 百度网盘(需配合第三方插件
baidupcs-go适配) - 360 云盘(需特定配置)
对象存储(Object Storage)
- AWS S3 及兼容服务(如 DigitalOcean Spaces、Linode Object Storage)
- Google Cloud Storage
- Microsoft Azure Blob Storage
- 阿里云 OSS
- 腾讯云 COS
- 华为云 OBS
- 网易云NOS
- MinIO(兼容 S3 协议的私有对象存储)
二、本地与私有存储
本地文件系统
- 本地文件夹(Windows 盘符、Linux/macOS 路径)
- 网络共享文件夹(SMB/CIFS,如 Windows 共享、NAS 共享)
协议型存储
- FTP/SFTP(文件传输协议,支持 SSH 加密的 SFTP)
- WebDAV(兼容 Nextcloud、ownCloud、坚果云等)
- HTTP/HTTPS(通过 HTTP 协议访问的文件服务)
- rsync(通过 rsync 协议同步文件)
NAS 与私有云
- Synology NAS(通过 SMB、WebDAV 或 SFTP 连接)
- QNAP NAS(同上)
- Nextcloud/ownCloud(私有云存储,通过 WebDAV 或本地挂载)
三、分布式与企业级存储
- Ceph(分布式对象存储,兼容 S3 或 Swift 协议)
- GlusterFS(分布式文件系统)
- OpenStack Swift(开源对象存储)
- IBM COS(IBM 云对象存储)
- Oracle Cloud Infrastructure Object Storage
四、其他特殊存储
- Google Photos(谷歌相册)
- Amazon Drive(亚马逊个人云盘)
- pCloud
- Mega
- FTP over SSL/TLS(FTPS)
- 磁带存储(Tape)
Rclone 的存储支持列表会随版本更新不断扩展,最新的完整列表可参考其官方文档:Rclone 支持的存储系统。
三、典型使用场景
- 多设备文件同步:将本地电脑的文档文件夹与 Google Drive 同步,确保手机、平板、电脑访问的文件始终是最新版本。
- 云存储之间迁移数据:将阿里云 OSS 中的备份数据批量迁移到 AWS S3,无需先下载到本地再上传。
- 本地备份到云存储:通过
rclone sync /home/backup s3:my-backup-bucket,将本地备份文件夹定时同步到 AWS S3 云端。 - 挂载云存储扩展本地空间:电脑硬盘空间不足时,将 1TB 的 OneDrive 挂载为本地磁盘,直接在云端存储大文件(如视频、备份包)。
四、优势特点
- 开源免费:代码完全公开,无广告、无付费功能限制,支持 Windows、macOS、Linux、FreeBSD 等多系统。
- 轻量高效:命令行操作无图形界面开销,后台运行占用资源少,适合服务器或无界面环境(如树莓派)。
- 安全性强:支持通过 OAuth 2.0、API 密钥等方式连接云存储,不存储用户账号密码;部分场景下可启用文件加密传输和存储。
五、安装教程
Rclone 的安装过程因操作系统不同而略有差异,以下是 Windows、macOS、Linux 三大主流系统的详细安装步骤,包含官方推荐方法和简化操作,确保新手也能顺利完成。
一、Windows 系统安装(以 Windows 10/11 为例)
方法 1:官方压缩包安装(推荐,适合所有用户)
下载安装包
打开 Rclone 官网下载页,找到 “Windows” 部分,根据系统位数选择:- 64位系统:下载
rclone-current-windows-amd64.zip - 32位系统:下载
rclone-current-windows-386.zip
- 64位系统:下载
解压文件
右键压缩包 → 选择 “全部解压缩”,建议解压到固定路径(如C:\Program Files\rclone,避免中文路径)。解压后会得到rclone.exe可执行文件。配置环境变量(可选,推荐)
目的:在任意命令行窗口直接输入rclone命令,无需切换到安装目录。- 右键 “此电脑” → “属性” → 左侧 “高级系统设置” → “环境变量”。
- 在 “系统变量” 中找到
Path→ 双击 → “新建” → 输入 Rclone 解压路径(如C:\Program Files\rclone)→ 点击 “确定” 保存。
验证安装
按下Win + R→ 输入cmd打开命令提示符,输入rclone version,若显示版本信息,则安装成功。
方法 2:Chocolatey 包管理器安装(适合熟悉命令行的用户)
- 先安装 Chocolatey(Windows 包管理器),打开管理员命令提示符,输入:
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin" - 安装 Rclone:
choco install rclone -y
二、macOS 系统安装
方法 1:Homebrew 包管理器安装(推荐,最简单)
- 若未安装 Homebrew,先在终端输入:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装 Rclone:
brew install rclone
方法 2:官方压缩包安装
- 下载 macOS 对应版本(
rclone-current-osx-amd64.zip或arm64版,根据芯片选择)。 - 解压到
/usr/local/bin(系统可执行路径):unzip rclone-current-osx-amd64.zip cd rclone-*-osx-amd64 sudo cp rclone /usr/local/bin/ sudo chmod 755 /usr/local/bin/rclone # 赋予执行权限 - 验证:终端输入
rclone version,显示版本信息即成功。
三、Linux 系统安装(以 Ubuntu/Debian 为例,其他发行版类似)
方法 1:APT 包管理器安装(适合 Ubuntu 20.04+)
sudo apt update
sudo apt install rclone -y方法 2:官方脚本自动安装(推荐,适配所有 Linux 发行版)
终端输入以下命令,自动下载并安装最新版:
curl https://rclone.org/install.sh | sudo bash(若没有
curl,可先用sudo apt install curl安装)验证:输入
rclone version,显示版本信息即成功。
四、通用验证与后续步骤
- 确认安装成功
无论哪种系统,安装后在终端/命令提示符输入rclone version,若输出类似以下内容,说明安装成功:rclone v1.65.0 - os/version: windows 10.0.19045 (64 bit) - os/kernel: 10.0.19045 (x86_64) - os/type: windows - os/arch: amd64
六、使用教程
一、首次配置存储源
安装完成后,需先配置要连接的存储服务(如 Google Drive、阿里云 OSS 等),输入以下命令进入配置界面:
rclone config
```
按提示选择 “n”(新建存储),输入名称(如 `gdrive`),再选择对应的存储类型,跟随指引完成授权(如登录云账号、输入 API 密钥等)。
这里以 Cloudflare 为例,之后按照提示进行配置:
```bash
No remotes found, make a new one\?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> r2
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
...
XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, Lyve Cloud, Minio, Magalu, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Synology, Tencent COS and Wasabi
\ (s3)
...
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
...
XX / Cloudflare R2 Storage
\ (Cloudflare)
...
provider> Cloudflare
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
1 / Enter AWS credentials in the next step.
\ (false)
2 / Get AWS credentials from the environment (env vars or IAM).
\ (true)
env_auth> 1
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY
Option region.
Region to connect to.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
1 / R2 buckets are automatically distributed across Cloudflare's data centers for low latency.
\ (auto)
region> 1
Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Enter a value. Press Enter to leave empty.
endpoint> https://ACCOUNT_ID.r2.cloudflarestorage.com
Edit advanced config?
y) Yes
n) No (default)
y/n> n
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y这会生成如下配置:
[r2]
type = s3
provider = Cloudflare
access_key_id = ACCESS_KEY
secret_access_key = SECRET_ACCESS_KEY
region = auto
endpoint = https://ACCOUNT_ID.r2.cloudflarestorage.com
acl = private其它平台的配置,都可以在这个网站上找到:https://rclone.org/s3/#cloudflare-r2
之后我们运行 rclone lsf r2: 去查看所有的 buckets,以及 rclone lsf r2:bucket 去查看一个 bucket.
二、常用命令
Rclone 的命令设计贴近 Linux 常用文件操作逻辑,核心命令围绕文件同步、传输、管理和挂载展开,以下是 最常用的命令及示例,覆盖日常使用场景:
一、基础信息与配置命令
查看版本信息
rclone version # 显示 Rclone 版本、系统信息配置存储源
rclone config # 进入交互式配置界面,用于添加/删除/修改存储服务(如 Google Drive、S3 等)- 配置时需给存储源起一个“名称”(如
onedrive),后续命令通过该名称指定存储位置。
- 配置时需给存储源起一个“名称”(如
二、文件/目录管理命令
类似本地 ls/cp/mv 等操作,支持本地与云存储、云存储之间的交互。
列出文件/目录
rclone ls 存储源:路径 # 仅显示文件名和大小(不含详细信息) rclone lsd 存储源:路径 # 仅列出目录(类似 `ls -d`) rclone lsjson 存储源:路径 # 以 JSON 格式输出文件详情(适合脚本处理)示例:
rclone ls onedrive:Documents # 列出 OneDrive 的 Documents 文件夹内容 rclone lsd gdrive: # 列出 Google Drive 根目录的所有文件夹复制文件/目录
rclone copy 源路径 目标路径 # 复制文件(跳过已存在的相同文件,增量复制)示例:
rclone copy /home/photos gdrive:backup/photos # 本地照片 → Google Drive rclone copy s3:my-bucket oss:my-oss-bucket # AWS S3 → 阿里云 OSS移动文件/目录
rclone move 源路径 目标路径 # 移动文件(类似剪切+粘贴,源文件会被删除)示例:
rclone move onedrive:old docs:archive # OneDrive 的 old 文件夹 → docs 存储的 archive 文件夹删除文件/目录
rclone delete 存储源:路径 # 删除指定路径下的文件(保留目录结构) rclone purge 存储源:路径 # 彻底删除路径下的所有文件和目录(慎用!)示例:
rclone delete gdrive:temp # 删除 gdrive 中 temp 文件夹里的所有文件(保留 temp 文件夹) rclone purge oss:old-data # 彻底删除 oss 中 old-data 文件夹及所有内容
三、同步命令(核心功能)
sync 是 Rclone 最常用的命令之一,用于将源路径同步到目标路径(目标会完全匹配源,差异文件会被覆盖/删除,需谨慎使用)。
rclone sync 源路径 目标路径 # 单向同步:使目标与源完全一致(增量同步,仅传输变化)关键参数:
-P:显示实时传输进度(速度、剩余时间等)。--dry-run:模拟同步(不实际操作,用于检查会执行哪些动作)。-u/--update:仅更新比目标新的文件(不删除目标多余文件)。
示例:
# 本地备份文件夹 → 阿里云 OSS,显示进度
rclone sync -P /home/backup oss:my-backup --dry-run # 先模拟,确认无误后去掉 --dry-run
# OneDrive → 本地同步(确保本地文件与云端一致)
rclone sync onedrive:docs /Users/me/local-docs -u假设你在 Cloudflare 创建的桶的名字是 cloud-r2-01,本地的文件夹为 files01,那么对应的命令为:
rclone sync r2:cloud-r2-01 ./files01反之从本地同步到云端也成立。
四、挂载云存储为本地磁盘
通过 mount 命令将云存储挂载到本地目录,像访问本地文件一样操作云端内容(需对应系统支持,如 Linux 的 FUSE、Windows 的 WinFsp)。
rclone mount 存储源:路径 本地挂载点 [参数]常用参数:
--daemon(Linux/macOS):后台运行挂载进程。--vfs-cache-mode writes:启用缓存,支持直接编辑云端文件(修改后自动同步)。--allow-other(Linux):允许其他用户访问挂载点。
示例:
# Linux:将 Google Drive 挂载到 /mnt/gdrive(后台运行,支持编辑)
rclone mount gdrive: /mnt/gdrive --daemon --vfs-cache-mode writes
# Windows:将 OneDrive 挂载到 Z: 盘(需先安装 WinFsp)
rclone mount onedrive: Z: --vfs-cache-mode writes注意:Windows 需先安装 WinFsp,macOS 需安装 macFUSE 才能支持挂载。
五、其他实用命令
检查文件一致性
rclone check 源路径 目标路径 # 对比源和目标的文件是否一致(大小、哈希值)加密传输/存储
结合crypt类型存储(配置时选择crypt),可加密文件后上传:rclone copy /secret docs-crypt: # docs-crypt 是已配置的加密存储,上传后文件会被加密限制传输速度
rclone copy -P --bwlimit 10M local: gdrive: # 限制速度为 10MB/s
命令格式说明
所有命令的路径格式统一为:
- 本地路径:直接写绝对路径(如
/home/file或C:\data)。 - 云存储路径:
存储源名称:路径(如oss:bucket1/folder,路径为空则表示根目录)。