关于 rclone
rclone 是一项指导 Agent 使用 rclone 在本地与远程存储之间传输文件的技能。内容涵盖配置检查、常见复制与同步操作，以及传输验证和故障排查。
主要功能
- 01检查安装与远程配置
- 02指导云存储远程设置
- 03复制、同步和列出文件
- 04预览传输并验证结果
- 05提供大文件与故障排查建议
适用场景
- 01首次配置 rclone 远程存储
- 02上传单个文件或目录
- 03预览或同步目录内容
- 04排查传输问题并核验文件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/rclone确认已加载。
附带文件scripts/check_setup.sh
详细介绍
rclone 文件传输技能
设置检查（始终先运行）
执行任何 rclone 操作前，请验证是否已安装并完成配置：
# Check if rclone is installed
command -v rclone >/dev/null 2>&1 && echo "rclone installed: $(rclone version | head -1)" || echo "NOT INSTALLED"
# List configured remotes
rclone listremotes 2>/dev/null || echo "NO REMOTES CONFIGURED"
如果未安装 rclone
指导用户安装：
# macOS
brew install rclone
# Linux (script install)
curl https://rclone.org/install.sh | sudo bash
# Or via package manager
sudo apt install rclone # Debian/Ubuntu
sudo dnf install rclone # Fedora
如果未配置远程服务
引导用户完成交互式配置：
rclone config
常见服务商配置速查：
| 服务商 | 类型 | 关键设置 |
|---|---|---|
| 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 流程（打开浏览器） |
| Dropbox | dropbox | OAuth 流程（打开浏览器） |
示例：配置 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
检查将要传输的内容（试运行）
rclone copy /path remote:bucket/ --dry-run
实用标志
| 标志 | 用途 |
|---|---|
--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
评论
支持 Markdown