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。
| 来源 | 后台字段 |
|---|---|
| Bucket | Bucket 名称 |
| S3 endpoint | S3 endpoint |
| Signing region | Region |
| Access Key ID | Access Key ID |
| Secret Access Key | Secret Access Key |
开启上传,选择 S3 兼容端点。R2 的 S3 签名区域填 auto。使用 Workers 原生绑定时选择平台绑定,跳过 S3 字段。保存存储配置。
验证
- 打开
/app/assets/upload上传一个符合限制的小文件。 - 从
/app/assets下载该文件并核对内容。
常见问题
S3 上传报 "Storage upload failed (403)"
错误中带有供应商自己的错误码和信息。检查 Access Key、Secret、存储桶名称,以及 Region 是否与端点的签名要求一致。