@computesdk/r2

中文文档
1.2.24发布于 2026/11/11MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2142

Cloudflare R2 计算SDK - S3 兼容对象存储的存储提供者

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 配置
  4. 环境变量
  5. API 密码
  6. 获取 R2 证书
  7. 许可证

@ computesdk/r2 (帮助)

Cloudflare R2存储提供者用于计算SDK - S3兼容对象存储.

安装

npm install @computesdk/r2

使用量

import { r2 } from '@computesdk/r2';

// Create storage instance
const storage = r2({
  accessKeyId: process.env.R2_ACCESS_KEY_ID,
  secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
  accountId: process.env.R2_ACCOUNT_ID
  // Or use endpoint directly:
  // endpoint: 'https://your-account-id.r2.cloudflarestorage.com'
});

// Upload a file
await storage.upload('my-bucket', 'path/to/file.txt', 'Hello, World!');

// Download a file
const result = await storage.download('my-bucket', 'path/to/file.txt');
console.log(result.data.toString());

// Delete a file
await storage.delete('my-bucket', 'path/to/file.txt');

// List objects
const list = await storage.list('my-bucket', { prefix: 'path/to/' });
for (const obj of list.objects) {
  console.log(`${obj.key}: ${obj.size} bytes`);
}

配置

选项类型需求默认说明
accessKeyId字符串无*R2_ACCESS_KEY_ID 环境R2 访问密钥
secretAccessKey字符串无*R2_SECRET_ACCESS_KEY 环境R2 密钥
accountId字符串号R2_ACCOUNT_ID 环境云浮账户 ID
endpoint字符串号- 说吧完整的 R2 端点 URL

* Ether在配置或设置环境变量中提供. * 以太提供 accountId (端点将自动构建)或提供全套 endpoint。 。 。 .

环境变量

export R2_ACCESS_KEY_ID=your-access-key
export R2_SECRET_ACCESS_KEY=your-secret-key
export R2_ACCOUNT_ID=your-account-id

API 密码

见 @ computesdk/s3 (帮助) 完整 API 细节的文档.

获取 R2 证书

  1. 转到 云花板
  2. 导航到 R2 > 管理 R2 API 键
  3. 用对象读写权限创建新的 API 令牌
  4. 注意访问密钥 ID、 秘密访问密钥和账户 ID

许可证

麻省理工学院

版本与发布记录

@computesdk/r2 共发布 31 个版本,首次发布于 2026/03/24;过去 12 个月发布了 31 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.24latest2026/11/112 天前
1.2.232026/11/067 天前
1.2.222026/11/049 天前
1.2.212026/10/2815 天前
1.2.202026/10/2320 天前
1.2.192026/10/2321 天前

关于 @computesdk/r2 的常见问题

@computesdk/r2 是什么?

Cloudflare R2 计算SDK - S3 兼容对象存储的存储提供者

如何安装 @computesdk/r2?

在项目目录运行 npm install @computesdk/r2,或使用 pnpm add / yarn add / bun add。

@computesdk/r2 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@computesdk/r2 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@computesdk/r2 可以商用吗?

@computesdk/r2 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@computesdk/r2 的下载量有多少?

根据 npm 官方下载统计,@computesdk/r2 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,142 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@computesdk/r2 还在维护吗?

最新版本 1.2.24 发布于 2026/11/11(2 天前);至今共发布 31 个版本,其中过去 12 个月发布了 31 个;首次发布于 2026/03/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。