Cloudflare R2

将上传文件保存到 Cloudflare R2。

准备工作

准备可操作该服务的账号,以及有权保存下列表单的 Kernlift 管理员账号。

完成后,能上传并下载同一个文件。

在 Cloudflare R2 完成准备

创建 R2 存储桶

打开 Cloudflare R2。创建 R2 存储桶并记下桶名。

使用 Workers 原生绑定

使用 Workers 原生绑定时,在 wrangler.jsonc 中将该桶绑定为 BUCKET 并部署。

使用兼容 S3 的令牌

使用 S3 接口时,为该桶创建对象读写令牌,保存 S3 密钥对和账户端点。

官方说明 · R2 建桶与凭据 · R2 token 权限

填写项目配置

回到 Kernlift 后台,打开 /admin/config/storage。

来源后台字段
BucketBucket 名称
S3 endpointS3 endpoint
Signing regionRegion
Access Key IDAccess Key ID
Secret Access KeySecret Access Key

开启上传,选择 S3 兼容端点。R2 的 S3 签名区域填 auto。使用 Workers 原生绑定时选择平台绑定,跳过 S3 字段。保存存储配置。

Kernlift 后台的 Cloudflare R2 配置字段

验证

  1. 打开 /app/assets/upload 上传一个符合限制的小文件。
  2. 从 /app/assets 下载该文件并核对内容。

常见问题

S3 上传报 "Storage upload failed (403)"

错误中带有供应商自己的错误码和信息。检查 Access Key、Secret、存储桶名称,以及 Region 是否与端点的签名要求一致。

下一步

配置文件存储和上传