Rclone 使用速查手册
一、配置远程
跨平台多协议文件传输/同步/挂载工具,支持 70+ 存储后端。
安装:官网 https://rclone.org 下载对应系统版本,解压后将可执行文件目录加入系统 PATH。
rclone config交互流程:
| 提示 | 操作 |
|---|---|
No remotes found | 输入 n 新建远程 |
name> | 输入远程名称,如 myremote |
| 选择存储类型 | 输入协议名称或对应序号(如 webdav、sftp、s3、drive) |
| 按协议要求填写参数 | 地址、端口、用户名、密码或密钥等 |
Edit advanced config? | 输入 n(一般无需高级配置) |
Keep this remote? | 输入 y 保存 |
验证配置:
rclone listremotes # 列出所有已配置远程
rclone about myremote: # 查看远程存储空间使用情况二、文件传输
路径规则
rclone copy 默认复制目录的内容,不会在目标端自动创建与源目录同名的父文件夹。
仅复制内容(不保留源文件夹名)
rclone copy /本地路径/ myremote:/远程路径/
# 结果:远程路径下直接出现本地路径内的文件和子文件夹保留源文件夹结构
如需在远程保留与本地同名的文件夹,需在目标路径显式指定:
rclone copy /本地路径/ myremote:/远程路径/本地路径/
# 结果:远程自动创建"本地路径"文件夹,原内容放入其中示例对比
假设本地目录结构为:
/文档/
├── 报告.docx
└── 数据/
└── 统计.xlsx| 命令 | 远程结果 |
|---|---|
rclone copy /文档/ myremote:/备份/ | /备份/报告.docx、/备份/数据/统计.xlsx |
rclone copy /文档/ myremote:/备份/文档/ | /备份/文档/报告.docx、/备份/文档/数据/统计.xlsx |
上传
rclone copy /本地路径/ myremote:/远程路径/ --progress下载
rclone copy myremote:/远程路径/ /本地路径/ --progress同步(使两端完全一致)
# 先执行模拟运行,确认操作范围
rclone sync /本地路径/ myremote:/远程路径/ --progress --dry-run
# 确认无误后执行实际同步
rclone sync /本地路径/ myremote:/远程路径/ --progress同步命令会删除目标端存在但源端不存在的文件,使用前务必加--dry-run或--interactive预览,避免误删数据。
断点续传
rclone copy 默认就会跳过源和目标完全相同的文件(通过 size+modtime 判断),因此直接重跑相同命令即可实现断点续传。如需更严格的校验,可加 --checksum:
rclone copy /本地路径/ myremote:/远程路径/ --progress --checksum三、常用参数
| 参数 | 说明 |
|---|---|
--progress / -P | 显示实时传输进度(大写 P 包含统计信息) |
--dry-run / -n | 模拟运行,输出待执行操作但不实际传输 |
--interactive / -i | 交互模式,每次删除/覆盖前要求确认(sync/move/delete 建议加) |
--skip-existing | 跳过目标端已存在的文件 |
--update | 仅传输比目标端版本更新的文件 |
--transfers N | 设置并发传输数量,默认值 4 |
--checkers N | 设置并发校验数量,默认值 8 |
--bwlimit 5M | 限制传输带宽,如 5MB/s |
--retries N | 传输失败时自动重试次数 |
--checksum | 用 hash(MD5/SHA1)判断文件是否相同,替代默认的 size+modtime |
--no-check-certificate | 跳过 HTTPS 证书验证 |
--log-file rclone.log | 将日志输出到指定文件 |
--log-level INFO | 设置日志级别(DEBUG/INFO/NOTICE/ERROR) |
组合示例:
rclone copy /本地资料/ myremote:/备份/资料/ --progress --transfers 8 --checksum --dry-run四、远程文件管理
| 命令 | 功能 |
|---|---|
rclone ls myremote:/路径 | 列出指定路径下所有文件 |
rclone lsd myremote:/路径 | 仅列出文件夹 |
rclone size myremote:/路径 | 查看文件夹大小 |
rclone tree myremote:/路径 | 以树形结构展示目录 |
rclone mkdir myremote:/新文件夹 | 创建文件夹 |
rclone check 本地路径 myremote:/远程路径 | 校验两端文件是否匹配(size+hash),不修改任何文件 |
rclone deletefile myremote:/路径/文件 | 删除单个文件 |
rclone delete myremote:/路径 | 删除路径下的所有文件(支持 --include/--exclude 过滤器选择性删除) |
rclone purge myremote:/路径/文件夹 | 删除文件夹及其全部内容 |
rclone moveto myremote:/源文件 myremote:/目标文件 | 移动并重命名 |
五、挂载远程存储
Windows(挂载为盘符)
rclone mount myremote: X: --vfs-cache-mode full --vfs-cache-max-size 1G --network-modeLinux(挂载为目录)
rclone mount myremote:/ /mnt/cloud --vfs-cache-mode full --vfs-cache-max-size 1G --daemon挂载模式选择
| 模式 | 参数 | 适用场景 |
|---|---|---|
| 无缓存 | 不添加缓存参数 | 仅浏览小文件,偶尔读取 |
| 写入缓存 | --vfs-cache-mode writes | 以读取为主,少量写入 |
| 全缓存 | --vfs-cache-mode full | 频繁读写、大文件编辑,推荐 |
卸载
rclone mount 没有专门的卸载命令,需要手动终止挂载进程:
Windows
# 方法1:在运行 mount 的 PowerShell/CMD 窗口按 Ctrl+C
# 方法2:任务管理器结束 rclone.exe 进程
# 方法3:命令行强制终止
taskkill /F /IM rclone.exeLinux
# 方法1:使用 fusermount
fusermount -u /mnt/cloud
# 方法2:查找并终止 rclone mount 进程
kill $(pgrep -f "rclone mount")六、去重
直接在远程执行去重操作,无需挂载:
# 自动保留最新的重复文件
rclone dedupe myremote:/路径 --dedupe-mode newest
# 交互模式,逐个确认保留哪个
rclone dedupe myremote:/路径 --dedupe-mode interactive| 模式 | 保留策略 |
|---|---|
newest | 修改时间最新的文件 |
oldest | 修改时间最早的文件 |
largest | 文件体积最大的 |
smallest | 文件体积最小的 |
interactive | 逐个手动确认 |
七、加密存储
在已有远程基础上叠加加密层:
rclone config
# 新建远程 → 类型选择 crypt → 底层远程选择已有远程如 myremote:/加密目录
# 设置加密密码 → 取名如 mycrypt使用加密远程:
rclone mount mycrypt: X: --vfs-cache-mode full # 挂载后显示明文内容
rclone copy /本地文件 mycrypt:/ # 上传自动加密八、各协议配置要点
| 协议 | 关键配置项 |
|---|---|
| SFTP | 服务器地址、端口(默认 22)、用户名、密码或私钥文件路径 |
| WebDAV | 服务器地址(如 https://域名/dav.php)、用户名、密码、Vendor 选择 other |
| S3 | Access Key、Secret Key、Region、Endpoint URL |
| Google Drive | 自动跳转浏览器完成 OAuth 授权 |
| OneDrive | 自动跳转浏览器完成 OAuth 授权 |
九、命令帮助
rclone help backends # 列出所有支持的存储后端
rclone help copy # 查看 copy 命令详细参数
rclone help mount # 查看 mount 命令详细参数
rclone help sync # 查看 sync 命令详细参数
rclone version # 查看 rclone 版本十、参考
- 官网:https://rclone.org
- 全部协议列表:https://rclone.org/overview
- 查看命令帮助:
rclone help <命令名>,如rclone help copy - 查看支持协议:
rclone help backends