Rclone 进阶使用教程 – 常用命令参数详解

Rclone 是一个的命令行工具,支持在不同对象存储、网盘间同步、上传、下载数据。并且通过一些设置可以实现离线下载、服务器备份等非常实用的功能。本篇文章将讲解 Rclone 常用的一些命令参数。

安装 Rclone

Linux/macOS/BSD,官方提供了一键安装脚本:

curl https://rclone.org/install.sh | sudo bash

Windows:官网下载

Rclone 设置

rclone config file – 显示配置文件的路径,一般配置文件在 ~/.config/rclone/rclone.conf

rclone config show – 显示配置文件信息

命令语法

# 本地到网盘
rclone [功能选项] <本地路径> <网盘名称:路径> [参数] [参数] ...

# 网盘到本地
rclone [功能选项] <网盘名称:路径> <本地路径> [参数] [参数] ...

# 网盘到网盘
rclone [功能选项] <网盘名称:路径> <网盘名称:路径> [参数] [参数] ...

用法示例

rclone move -v /Download Onedrive:/Download --transfers=1

常用功能选项

  • rclone copy – 复制
    rclone move – 移动,如果要在移动后删除空源目录,请加上 --delete-empty-src-dirs 参数
  • rclone sync – 同步:将源目录同步到目标目录,只更改目标目录。
  • rclone size – 查看网盘文件占用大小。
  • rclone delete – 删除路径下的文件内容。
  • rclone purge – 删除路径及其所有文件内容。
  • rclone mkdir – 创建目录。
  • rclone rmdir – 删除目录。
  • rclone rmdirs – 删除指定灵境下的空目录。如果加上 –leave-root 参数,则不会删除根目录。
  • rclone check – 检查源和目的地址数据是否匹配。
  • rclone ls – 列出指定路径下的所有的文件以及文件大小和路径。
  • rclone lsl – 比上面多一个显示上传时间。
  • rclone lsd 列出指定路径下的目录
  • rclone lsf – 列出指定路径下的目录和文件

常用参数

  • -n = --dry-run – 测试运行,用来查看 rclone 在实际运行中会进行哪些操作。
    -P = --progress – 显示实时传输进度,500mS 刷新一次,否则默认 1 分钟刷新一次。
  • --cache-chunk-size SizeSuffi – 块的大小,默认5M,理论上是越大上传速度越快,同时占用内存也越多。如果设置得太大,可能会导致进程中断。
  • --cache-chunk-total-size SizeSuffix – 块可以在本地磁盘上占用的总大小,默认10G。
  • --transfers=N – 并行文件数,默认为4。在比较小的内存的VPS上建议调小这个参数,比如128M的小鸡上使用建议设置为1。
  • --config string – 指定配置文件路径,string为配置文件路径。
  • --ignore-errors – 跳过错误。比如 OneDrive 在传了某些特殊文件后会提示Failed to copy: failed to open source object: malwareDetected: Malware detected,这会导致后续的传输任务被终止掉,此时就可以加上这个参数跳过错误。但需要注意 RCLONE 的退出状态码不会为0。

日志

rclone 有 4 个级别的日志记录,ERROR,NOTICE,INFO 和 DEBUG。默认情况下,rclone 将生成 ERROR 和 NOTICE 级别消息。

  • -q - rclone将仅生成 ERROR 消息。
  • -v - rclone将生成 ERRORNOTICEINFO 消息,推荐此项。
  • -vv - rclone 将生成 ERRORNOTICEINFODEBUG 消息。
  • --log-level LEVEL – 标志控制日志级别。

输出日志到文件

使用 --log-file=FILE 选项,rclone 会将 ErrorInfoDebug 消息以及标准错误重定向到 FILE,这里的 FILE 是你指定的日志文件路径。

另一种方法是使用系统的指向命令,比如:

rclone sync -v Onedrive:/DRIVEX Gdrive:/DRIVEX > "~/DRIVEX.log" 2>&1

文件过滤

  • --exclude – 排除文件或目录。

  • --include – 包含文件或目录。

  • --filter – 文件过滤规则,相当于上面两个选项的其它使用方式。包含规则以 + 开头,排除规则以 – 开头。