SuperAPI AI 工具集

cloudflare-r2

部署与运维

查看项目

更新于 10-16 01:29

技能介绍

用途:本技能用于在应用中实现对象存储、从 AWS S3 等迁移、搭建文件上传下载、配置公有或私有存储桶、将 R2 接入 Cloudflare Workers,以及用 S3 兼容工具与 SDK 操作 R2,并通过零出口流量费优化存储成本。

主要能力:R2 提供 S3 兼容 API 与 Workers 原生绑定;存储类别分标准与不频繁访问(后者存储更便宜但有取回费用,30 天最短存储期);支持公有存储桶、预签名 URL、CORS、分片上传、数据迁移、生命周期规则和事件通知。官方称持久性 11 个 9,全球强一致。

必要用法:需已购买 R2 的 Cloudflare 账户与账户 ID;API 访问需在控制台生成 R2 Access Keys。Wrangler 可用 npm install -g wrangler 后 wrangler login,创建桶如 wrangler r2 bucket create my-bucket,可加 --location 指定位置提示(wnam、enam、weur、eeur、apac)。S3 工具需把 endpoint 指向 https://<accountid>.r2.cloudflarestorage.com,region 设为 auto。Workers 中通过 wrangler.toml 的 [[r2_buckets]] 绑定,再用 env.MY_BUCKET 的 put/get/list/delete/head 等操作;大于 100MB 文件建议分片上传,单分片 5MiB–5GiB,最多 10000 片,单对象最大 5TB。

适用场景:文件存储、上传下载服务、S3 迁移、Workers 无服务器集成、静态资源分发、批量大文件传输(可用 rclone)。

限制:每账户最多 1000 个桶,桶名 3–63 字符小写加连字符;每桶生命周期规则上限 1000,事件通知规则上限 100;r2.dev 仅用于开发且限速 1000 请求/分钟,生产建议用自定义域名。密钥不应提交到版本控制,建议用环境变量与桶级令牌。资料未提供具体定价数字与更多细节。