目录
什么是Rclone
功能
特性
支持的提供商
虚拟提供商
使用
安装
配置
语法
命令列表
常用参数
日志
过滤
环境变量
最佳实践
什么是Rclone
Rclone是一个用于管理云存储上的文件的命令行程序。它是云供应商web存储接口的一个功能丰富的替代方案。超过40种云存储产品支持rclone,包括S3对象存储、商业和消费者文件存储服务以及标准传输协议。
Rclone具有与unix命令rsync、cp、mv、mount、ls、ncdu、tree、rm和cat相当的强大云功能。Rclone熟悉的语法包括shell管道支持和--干运行保护。它在命令行、脚本或通过其API使用。
用户称rclone为“云存储的瑞士军刀”,“技术与魔法无法区分”。
Rclone真的很照顾你的数据。它始终保留时间戳并验证校验和。有限带宽上的传输;从上次传输的好文件开始,间歇性连接或受配额限制的连接可以重新启动。您可以检查文件的完整性。在可能的情况下,rclone采用服务器端传输来最大限度地减少。
提示:以上是根据官网翻译得来。
功能
Rclone支持但不仅限于下面列出功能:
- 将文件备份(和加密)到云存储
- 从云存储恢复(和解密)文件
- 将云数据镜像到其他云服务或本地
- 将数据迁移到云端,或在云存储供应商之间迁移
- 将多个、加密、缓存或多样化的云存储挂载为磁盘
- 使用lsf、ljson、size、ncdu分析和说明云存储上保存的数据
- 联合文件系统一起呈现多个本地和/或云文件系统作为一个
提示:以上是根据官网翻译得来。
特性
-
接送服务
- 始终检查 MD5、SHA1 哈希值以确保文件完整性
- 时间戳保留在文件中
- 可以随时重新启动操作
- 可以进出网络,例如两个不同的云提供商
- 可以使用多线程下载到本地磁盘
- 将新文件或更改的文件复制到云存储
- 同步(一种方式)使目录相同
- 验证后将文件移动到云存储删除本地
- 检查哈希和丢失/额外的文件
- 将您的云存储挂载为网络磁盘
- 通过HTTP / WebDav / FTP / SFTP / DLNA服务本地或远程文件
- 实验性基于 Web 的 GUI
提示:以上是根据官网翻译得来。
支持的提供商
虚拟提供商
使用
官方文档写得非常详细,这里主要用写几个应用场景看如何使用。以下使用 ubuntu为例演示:
安装
Rclone 就是一个二进制文件包,可以直接下载设置环境变量即可使用,这里直接使用官方的脚本安装。
curl -O https://downloads.rclone.org/rclone-current-linux-amd64.zip
unzip rclone-current-linux-amd64.zip
cd rclone-*-linux-amd64
sudo cp rclone /usr/bin/
sudo chown root:root /usr/bin/rclone
sudo chmod 755 /usr/bin/rclone
直接执行 rclone version
可以查看到版本号即安装成功。
配置
配置可以直接添加配置文件的方式或者通过进入交互式配置会话命令一步步的完成配置。
默认配置完成的后配置文件都保存在:/root/.config/rclone/rclone.conf
目录下。
我这里直接通过给出腾讯COS的配置文件。
[tencent-cos] # 自定义的名称
type = s3 # 存储类型,参考官方文档所有支持的类型
provider = TencentCOS # 提供商,参考官方文档或者全部
env_auth = false # 不通过环境变量配置认证
access_key_id = AKxxxxxxxx # 腾讯云后台生成的密钥key
secret_access_key = Secretxxxxxxx # 腾讯云后台生成的密钥secret
endpoint = cos.ap-chengdu.myqcloud.com # 腾讯云cos所在的地区,看你所在存储桶的公网地址
语法
# 本地到网盘
rclone [功能选项] <本地路径> <配置名称:路径> [参数] [参数]
# 网盘到本地
rclone [功能选项] <配置名称:路径> <本地路径> [参数] [参数]
# 网盘到网盘
rclone [功能选项] <配置名称:路径> <配置名称:路径> [参数] [参数]
# [参数]为可选项
举例:
# 同步本地/data/file的文件夹内容到tencent-cos存储下的/beifen文件夹中,并且排除/root/excludes.txt中指定的文件内容
rclone sync /data/file tencent-cos:/beifen --exclude-from '/root/excludes.txt'
# 两个网盘文件同步
rclone copy 配置网盘名称1:网盘路径 配置网盘名称2:网盘路径
命令列表
使用 rclone --help
可查看所有命令,这里只列出常用的命令,其他的命令可以看官方文档详细了解:
命令 | 说明 |
---|---|
rclone copy | 复制 |
rclone move | 移动,如果要在移动后删除空源目录,加上 --delete-empty-src-dirs 参数 |
rclone mount | 挂载 |
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 | 显示实时传输进度,500 ms刷新一次,否则默认1分钟刷新一次 |
--cache-chunk-size 5M | 块的大小,默认 5M 越大上传越快,占用内存越多,太大可能会导致进程中断 |
--onedrive-chunk-size 100M | 提高 OneDrive 上传速度适用于G口宽带服务器 |
--drive-chunk-size 64M | 提高 Google Drive 上传速度适用于G口宽带服务器 |
--cache-chunk-total-size SizeSuffix | 块可以在本地磁盘上占用的总大小 |
--transfers=N | 并行文件数,默认为4。在比较小的内存的VPS上建议调小这个参数,比如 128M 的小鸡上使用建议设置为1。 |
--config string | 指定配置文件路径,string为配置文件路径 |
--ignore-errors | 跳过错误 |
--size-only | 根据文件大小校验,不校验hash |
--drive-server-side-across-configs | 服务端对服务端传输 |
日志
rclone 有 4 个级别的日志记录,ERROR
,NOTICE
,INFO
和 DEBUG
。默认情况下,rclone 将生成 ERROR
和 NOTICE
级别消息。
-q
- rclone将仅生成ERROR
消息。-v
- rclone将生成ERROR
,NOTICE
和INFO
消息,推荐此项。-vv
- rclone 将生成ERROR
,NOTICE
,INFO
和DEBUG
消息。--log-level LEVEL
- 标志控制日志级别。
过滤
我们若同步的时候需要过滤掉一些不重要的文件的话,比如程序启动日志、敏感文件。
命令 | 说明 |
---|---|
--exclude-from | 排除文件或目录列表来自某个文件指定 |
--include-from | 包含文件或目录来自某个文件指定 |
--filter-from | 文件过滤规则来自某个文件指定 |
--exclude | 排除文件或目录 |
--include | 包含文件或目录 |
--filter | 文件过滤规则,相当于上面两个选项的其它使用方式。包含规则以+开头,排除规则以-开头 |
-
文件类型过滤
比如
--exclude "*.bak"
,表示排除所有.bak
结尾的文件,也可以写作--filter "- *.bak"
比如
--include "*.{png,jpg}"
,包含所有png
和jpg
文件,排除其他文件,也可以写作--filter "+ *.{png,jpg}"
--delete-excluded
删除排除的文件。需配合过滤参数使用,否则无效。 -
目录过滤
目录过滤需要在目录名称后面加上
/
,否则会被当做文件进行匹配。以/
开头只会匹配根目录(指定目录下),否则匹配所目录。这同样适用于文件。--exclude ".git/"
排除所有目录下的.git
目录。--exclude "/.git/"
只排除根目录下的.git
目录。--exclude "{Video,Software}/"
排除所有目录下的Video
和Software
目录。--exclude "/{Video,Software}/"
只排除根目录下的Video
和Software
目录。--include "/{Video,Software}/**"
仅包含根目录下的Video
和Software
目录的所有内容。 -
大小过滤
默认大小单位为
kBytes
,但可以使用k
,M
或G
后缀。--min-size
过滤小于指定大小的文件。比如--min-size 50
表示不会传输小于 50k 的文件。--max-size
过滤大于指定大小的文件。比如--max-size 1G
表示不会传输大于 1G 的文件。 -
过滤规则来自某个文件
--exclude-from <规则文件>
:从文件添加包含规则--include-from <规则文件>
:从文件添加删除规则--filter-from <规则文件>
:从文件添加包含 / 排除规则。比如--filter-from filter-file.txt
。filter-file.txt
示例:- secret*.jpg + *.jpg + *.png + file2.avi - /dir/Trash/** + /dir/** - *
环境变量
rclone 中的每个选项都可以通过环境变量设置。环境变量的名称可以通过长选项名称进行转换,删除 --
前缀,更改 -
为 _
,大写并添加前缀 RCLONE_
。环境变量的优先级会低于命令行选项,即通过命令行追加相应的选项时会覆盖环境变量设定的值。
比如设置最小上传大小 --min-size 50
,使用环境变量是 RCLONE_MIN_SIZE=50
。当环境变量设置后,在命令行中使用 --min-size 100
,那么此时环境变量的值就会命令行覆盖,最终生效的是 --min-size 100
。
命令 | 说明 |
---|---|
RCLONE_CONFIG | 自定义配置文件路径 |
RCLONE_CONFIG_PASS | 若 rclone 进行了加密设置,把此环境变量设置为密码,可自动解密配置文件 |
RCLONE_RETRIES | 上传失败重试次数,默认 3 次 |
RCLONE_RETRIES_SLEEP | 上传失败重试等待时间,默认禁用,单位s、m、h分别代表秒、分钟、小时 |
CLONE_TRANSFERS | 并行上传文件数 |
RCLONE_CACHE_CHUNK_SIZE | 块的大小 |
RCLONE_CACHE_CHUNK_TOTAL_SIZE | 块可以在本地磁盘上占用的总大小 |
RCLONE_IGNORE_ERRORS=true | 跳过错误 |
最佳实践
备份本地 /data/file
目录到腾讯云cos存储中,并设置定时任务每晚自动同步,这样可以达到定时备份重要文件上云的效果。
-
目录
/data/file
下创建excludes.txt
,里面填写需要排除的文件列表。logs/** # 排除logs下所有文件 *.bak # 排除.bak结尾的文件 *.zip # 排除.zip结尾的文件
-
配置腾讯云cos在此忽略,直接编写
rclone
命令,测试执行是否同步。rclone sync -v /data/file tencent-cos:/beifen --exclude-from '/data/file/excludes.txt' >> /root/rclone.log 2>&1
手动执行一把,然后查看
tail -f /root/rclone.log
是否输出日志了,只要没报错则成功。 -
配置定时任务,每天自动执行
执行
crontab -e
# 打开定时任务列表,跳到最后新起一行添加步骤2.成功的命令并保存,内容如下:(表示每晚3点30分进行同步)30 4 * * * rclone sync -v /data/file tencent-cos:/beifen --exclude-from '/data/file/excludes.txt' >> /root/rclone.log 2>&1
执行
systemctl restart cron.service
重启定时任务生效 - 达到执行时间后检查
/root/rclone.log
下的日志保证没问题。