`Rclone` 使用教程

default

一、rclone 简介

rclone 是一个命令行工具,用于同步、管理和备份文件到多种云存储服务(如 Google Drive、OneDrive、Dropbox、AWS S3、阿里云 OSS 等),支持加密、增量同步、挂载为本地磁盘等功能。


二、安装 rclone

1. 通用安装方法(推荐)

  • Linux/macOS:

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

    • 下载预编译二进制文件:rclone 官网下载页

    • 解压并将 rclone.exe 添加到系统环境变量。

2. 包管理器安装

  • Ubuntu/Debian:

    1
    
    sudo apt install rclone
    
  • macOS (Homebrew):

    1
    
    brew install rclone
    

三、配置云存储服务

1. 初始化配置

运行以下命令进入交互式配置向导:

1
rclone config

按提示选择云存储类型、填写 API 密钥或授权令牌。

2. 示例:配置 Google Drive

  1. 选择 n(新建配置),输入名称(如 gdrive)。

  2. 选择存储类型编号(Google Drive 对应 12)。

  3. 按提示完成 OAuth 授权流程(需浏览器登录 Google 账号)。

  4. 完成后会生成配置文件,默认路径:

    • Linux/macOS: ~/.config/rclone/rclone.conf

    • Windows: %USERPROFILE%\.config\rclone\rclone.conf

3. 其他云存储

类似地,支持以下服务(部分需要额外配置):

  • AWS S3、阿里云 OSS、Dropbox、OneDrive、SFTP、WebDAV 等。

四、常用命令

1. 文件同步与传输

  • 复制文件到云存储

    1
    2
    3
    
    rclone copy /local/path remote:path
    # 示例:将本地文件夹同步到 Google Drive
    rclone copy ~/Documents gdrive:backup
    
  • 双向同步(增量同步)

    1
    
    rclone sync /local/path remote:path
    

    注意sync 会删除目标端多余文件,确保数据安全!

  • 列出文件

    1
    2
    3
    
    rclone ls remote:path
    rclone lsl remote:path  # 含修改时间
    rclone tree remote:path # 树状结构
    

2. 挂载为本地磁盘

  • 挂载云存储到本地目录

    1
    
    rclone mount remote:path /local/mountpoint --vfs-cache-mode full
    
    • 参数说明:

      • --vfs-cache-mode full:启用本地缓存,提升性能。

      • --daemon:后台运行(Linux/macOS)。

    • 卸载fusermount -u /local/mountpoint(Linux)或强制终止进程。

3. 其他实用命令

  • 删除文件

    1
    
    rclone delete remote:path
    
  • 新建目录

    1
    
    rclone mkdir remote:path
    
  • 查看存储空间

    1
    
    rclone about remote:
    

五、高级功能

1. 加密存储

配置加密的远程存储(需先配置基础远程存储):

  1. 运行 rclone config,选择 Crypt 类型。

  2. 指定加密密码和盐值(salt),关联到现有远程存储。

  3. 使用加密后的远程名称(如 encrypted_remote)操作文件。

2. 带宽限制

限制上传/下载速度:

1
rclone copy /local/path remote:path --bwlimit 2M  # 限制为 2MB/s

3. 过滤文件

通过 --include--exclude 规则过滤文件:

1
rclone sync /local/path remote:path --include "*.jpg" --exclude "temp/"

六、自动化与脚本

1. 定时任务(Linux/macOS)

使用 crontab -e 添加定时同步任务:

1
0 2 * * * /usr/bin/rclone sync /local/path remote:path >/var/log/rclone.log 2>&1

(每天凌晨 2 点同步)

2. 脚本示例

批量上传多个目录:

1
2
3
4
5
#!/bin/bash
DIRS=("docs" "photos" "backup")
for dir in "${DIRS[@]}"; do
  rclone copy ~/$dir gdrive:$dir
done

七、常见问题

  1. 配置错误

    • 检查 rclone.conf 文件权限和路径。

    • 重新运行 rclone config 修复配置。

  2. 同步失败

    • 使用 -v--verbose 输出详细日志。

    • 检查网络连接和云存储 API 限制。

  3. 挂载失败

    • 确保已安装 fuse(Linux/macOS)。

    • Windows 需安装 WinFsp


八、资源

Licensed under CC BY-NC-SA 4.0
Gear(夕照)的博客。记录开发、生活,以及一些不足为道的思考……