cloudflare-r2

核心用法

Cloudflare R2 技能通过封装 wrangler CLI 提供简洁的文件上传与管理能力。用户需预先安装 wrangler 并配置 ~/.config/cloudflare/r2.json 文件，包含 bucket 名称、accountId、publicDomain 和 apiToken。支持单文件上传 scripts/r2-upload.sh <local-file> [remote-path]] 和批量目录上传 scripts/r2-upload.sh <directory> <remote-prefix>> 两种模式，上传完成后自动生成 https://<publicDomain>/<remote-path>> 格式的公开访问 URL。

显著优点

1. 官方工具背书：基于 Cloudflare 官方 wrangler CLI，API 稳定性与长期维护有保障
2. CDN 原生集成：R2 与 Cloudflare CDN 深度整合，上传即享全球加速分发
3. 成本优势：R2 提供零出口费存储，相比传统云存储显著降低流量成本
4. 批量操作友好：脚本封装支持目录级批量上传，适合静态站点部署场景
5. 配置灵活：支持自定义远程路径前缀，便于组织存储桶目录结构

潜在缺点与局限性

1. 前置依赖较重：需安装 Node.js 环境和 wrangler CLI，对非 Node 生态用户不够友好
2. 配置门槛存在：要求用户手动创建 JSON 配置文件并获取 Cloudflare API Token，新手需学习成本
3. 功能边界单一：仅覆盖上传、列举、删除基础操作，缺少同步、增量更新、生命周期管理等高级功能
4. 无图形界面：纯命令行交互，不适合偏好可视化管理的用户
5. 平台锁定风险：深度绑定 Cloudflare 生态，迁移至其他对象存储需重新适配

适合的目标群体

• 前端开发者：需要快速部署静态资源到 CDN 的 Vue/React 项目开发者
• DevOps 工程师：构建 CI/CD 流水线中自动化资源上传环节
• 内容创作者：托管图片、视频等媒体文件并获取稳定外链
• 独立开发者：寻求低成本、高性能对象存储解决方案的个人项目

使用风险

1. 凭据泄露风险：API Token 以明文存储在本地配置文件，需严格设置文件权限（建议 chmod 600）
2. 配额消耗：上传操作消耗 R2 存储容量和请求次数，批量上传前需确认账户配额
3. 覆盖风险：相同远程路径上传将直接覆盖已有文件，无版本控制机制
4. 网络依赖：上传大文件时受本地网络稳定性影响，中断需重新上传
5. 权限配置复杂度：Cloudflare API Token 需精确配置 R2 存储桶权限，权限过宽可能带来安全隐患

核心用法

Cloudflare R2 Skill 是一款专为开发者设计的文件上传工具，通过封装 wrangler CLI 命令，简化了向 Cloudflare R2 对象存储上传、管理和删除文件的操作流程。

主要功能场景：

• 单文件上传：scripts/r2-upload.sh <local-file> [remote-path]
• 批量目录上传：scripts/r2-upload.sh <directory> <remote-prefix>
• 对象列表查询：wrangler r2 object list
• 对象删除：wrangler r2 object delete

配置依赖：需在 ~/.config/cloudflare/r2.json 中配置 bucket 名称、accountId、publicDomain 和 apiToken，随后通过环境变量注入完成认证。

显著优点

1. 零依赖轻量设计：除系统标准工具（wrangler、jq）外无第三方依赖，降低供应链攻击面
2. 官方基础设施背书：依托 Cloudflare 官方 R2 服务与 TLS 1.3 加密传输，数据安全性有保障
3. 即时 CDN 分发：上传完成后文件立即通过 pub-xxx.r2.dev 域名全球加速访问
4. 命令行原生集成：与现有 DevOps 工作流无缝衔接，支持自动化脚本编排

潜在局限

• T3 来源可信度：维护者为个人开发者账号，代码未经知名组织审计
• 路径遍历风险：当前版本未对输入路径做严格验证，存在 .. 穿越攻击可能
• 凭证本地存储：API Token 以明文 JSON 形式存放于用户目录，需用户自行加固文件权限
• 功能单一性：仅覆盖基础 CRUD 操作，缺乏分片上传、生命周期策略等高级功能

适合人群

• 需要快速托管静态资源（图片、视频、文档）的前端/全栈开发者
• 构建 CI/CD 流水线、寻求 AWS S3 替代方案的技术团队
• 熟悉命令行操作、具备基础云存储概念的技术用户

常规风险

| 风险项 | 说明 | 缓解建议 |

|--------|------|---------|

| 外部命令注入 | 依赖 wrangler/jq 系统工具 | 校验输入路径，避免特殊字符 |

| 凭证泄露 | 配置文件权限过宽 | 设置 `chmod 600` 限制访问 |

| 来源可信度 | 个人开发者维护 | 审查代码后使用，关注更新动态 |