R2对象存储管理

技能简介

该技能用于管理 Cloudflare R2 对象存储服务，支持通过 rclone 完成存储桶配置、文件上传下载、双向同步及批量删除等操作。

业务背景

面向开发运维团队，解决Cloudflare R2对象存储的日常管理需求。无需编写代码即可快速完成文件上传下载、批量同步及存储桶清理，降低云存储操作门槛，提升数据迁移与备份效率，确保团队协作中存储资源的一致性与可控性。

落地案例：某团队需将本地项目构建产物定期归档至R2。通过该技能配置API令牌后，执行文件夹上传任务，设置双向同步策略保持本地与云端版本一致；配合定时任务实现自动化备份，必要时一键清空过期存储桶释放成本，全程可视化确认操作结果。

能做什么

• 配置 R2 访问凭证与存储桶连接
• 上传单文件或整个文件夹到指定存储桶
• 下载云端文件到本地目录
• 执行本地与云端的双向单向同步
• 列出存储桶内容并查看文件详情
• 删除指定文件或清空整个存储桶

使用说明

安装依赖

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

配置凭证

在控制台设置 R2_CONFIG 环境变量，格式如下：

{"access_key_id":"YOUR_KEY","secret_access_key":"YOUR_SECRET","endpoint":"https://ACCOUNT_ID.r2.cloudflarestorage.com","bucket":"your-bucket"}

凭证获取步骤：登录 Cloudflare 控制台 → 进入 R2 页面 → 创建含 Object Read/Write/List 权限的 API 令牌 → 复制账户 ID 拼接 endpoint。

快速初始化

r2-setup --config '{...}'

或运行交互式脚本：./skills/r2/scripts/setup.sh

常用命令示例

# 上传
r2-upload /path/to/file.txt
r2-upload /path/to/folder/

# 下载
r2-download file.txt /local/path/

# 同步（本地→云端）
r2-sync /local/folder/ r2:bucket/

# 列出文件
r2-ls --long

输入与输出

见下方输入与输出表格。

风险提示

• 同步时加 --delete 参数会删除目标端多余文件，操作前请确认
• r2-purge 会清空整个存储桶，数据不可恢复
• API 令牌需妥善保管，避免泄露导致存储桶被非法访问
• 403 错误通常因令牌权限不足，需检查是否包含 Read/Write/List 三项权限

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/junwatu/r2-storage/SKILL.md
来源类型：GitHub 仓库