rclone

用途

rclone 技能用于跨云存储提供商上传、同步和管理文件，典型场景是上传图片、视频、文档等文件到 S3、Cloudflare R2 等存储服务。该技能基于 rclone 命令行工具工作。

安装与配置检查（须首先执行）

在进行任何 rclone 操作前，技能要求先验证安装与配置状态。

检查是否已安装 rclone：

command -v rclone >/dev/null 2>&1 && echo "rclone installed: $(rclone version | head -1)" || echo "NOT INSTALLED"

列出已配置的远端：

rclone listremotes 2>/dev/null || echo "NO REMOTES CONFIGURED"

若未安装

资料提供以下安装方式：

macOS：brew install rclone
Linux 脚本安装：curl https://rclone.org/install.sh | sudo bash
或通过包管理器：Debian/Ubuntu 使用 sudo apt install rclone，Fedora 使用 sudo dnf install rclone

若未配置远端

引导用户进行交互式配置：rclone config

常见提供商配置参考

资料给出各提供商的类型与关键设置：

Provider	Type	Key Settings
AWS S3	s3	access_key_id, secret_access_key, region
Cloudflare R2	s3	access_key_id, secret_access_key, endpoint (account_id.r2.cloudflarestorage.com)
Backblaze B2	b2	account (keyID), key (applicationKey)
DigitalOcean Spaces	s3	access_key_id, secret_access_key, endpoint (region.digitaloceanspaces.com)
Google Drive	drive	OAuth flow (opens browser)
Dropbox	dropbox	OAuth flow (opens browser)

配置示例：Cloudflare R2

rclone config create r2 s3 \
  provider=Cloudflare \
  access_key_id=YOUR_ACCESS_KEY \
  secret_access_key=YOUR_SECRET_KEY \
  endpoint=ACCOUNT_ID.r2.cloudflarestorage.com \
  acl=private

配置示例：AWS S3

rclone config create aws s3 \
  provider=AWS \
  access_key_id=YOUR_ACCESS_KEY \
  secret_access_key=YOUR_SECRET_KEY \
  region=us-east-1

常见操作

上传单个文件：

rclone copy /path/to/file.mp4 remote:bucket/path/ --progress

上传目录：

rclone copy /path/to/folder remote:bucket/folder/ --progress

同步目录（镜像，会删除已移除的文件）：

rclone sync /local/path remote:bucket/path/ --progress

列出远端内容：

rclone ls remote:bucket/
rclone lsd remote:bucket/  # directories only

查看将要传输什么（dry run）：

rclone copy /path remote:bucket/ --dry-run

常用参数

Flag	Purpose
--progress	显示传输进度
--dry-run	预览而不实际传输
-v	详细输出
--transfers=N	并行传输数（默认 4）
--bwlimit=RATE	带宽限制（如 10M）
--checksum	按校验和比较，而非大小/时间
--exclude="*.tmp"	排除模式
--include="*.mp4"	仅包含匹配项
--min-size=SIZE	跳过小于 SIZE 的文件
--max-size=SIZE	跳过大于 SIZE 的文件

大文件上传

针对视频和大文件，使用分片上传：

# S3 multipart upload (automatic for >200MB)
rclone copy large_video.mp4 remote:bucket/ --s3-chunk-size=64M --progress

# Resume interrupted transfers
rclone copy /path remote:bucket/ --progress --retries=5

验证上传

# Check file exists and matches
rclone check /local/file remote:bucket/file

# Get file info
rclone lsl remote:bucket/path/to/file

故障排查

# Test connection
rclone lsd remote:

# Debug connection issues
rclone lsd remote: -vv

# Check config
rclone config show remote

适用场景

适用于将本地图片、视频、文档等文件上传或同步到云存储，跨多个云存储提供商管理文件，以及需要预览、校验、限制带宽或分片传输的场景。

限制

资料未提供该技能的具体收费、价格或平台限制信息；也未说明除上述提供商之外的兼容范围、性能上限或权限要求。缺失信息暂未提供。