Menu

CloudFlare R2 集成

R2 是 CloudFlare 提供的对象存储服务,它与 CloudFlare 的 CDN 服务无缝集成,可以作为静态文件存储和分发服务。

文件存储需求的场景很多,例如:

  • 用户头像保存
  • AI 生成的图片、视频保存到云端
  • 博客图片保存

有了这些场景的需求后,管理员就还需要一个文件管理后台。

Nexty.dev 模板针对这些需求,基于 CloudFlare R2 封装了文件上传、删除的方法,并且提供了查看、管理文件的后台。

本章我们来完成 CloudFlare R2 的配置。

配置 CloudFlare R2

  1. 访问 CloudFlare R2 页面,开始创建 Bucket

Create bucket

Create bucket

  1. 进入 Bucket Settings,复制 R2_BUCKET_NAMER2_ACCOUNT_ID 到环境变量

Bucket settings

  1. 设置自定义域名

Custom domain

Custom domain

  1. 将设置的自定义域名加上 https:// 前缀添加到环境变量 R2_PUBLIC_URL

Custom domain

# .env.local or .env
 
R2_PUBLIC_URL=https://R2_PUBLIC_URL
  1. 设置 CORS Policy,这是控制哪些来源(域名、协议、端口)可以访问存储在 R2 Bucket 中的资源。这是一种安全机制,用于保护你的资源免受未经授权的跨域访问。

CORS Policy

CORS Policy

[
  {
    "AllowedOrigins": [
      "http://localhost:3000",
      "https://your-domain.com"
    ],
    "AllowedMethods": [
      "GET"
    ]
  }
]
  1. 现在回到 R2 首页,开始创建 API Key

Create API Key

Create API Key

Create API Key

  1. 将 API Key 添加到环境变量 R2_ACCESS_KEY_IDR2_SECRET_ACCESS_KEY

Create API Key

验证

你可以启动源码仓库后,在以下模块测试 R2 相关功能:

  • /dashboard/settings 页面测试头像上传
  • /ai-demo 页面测试 AI 生成的图片、视频上传
  • /dashboard/images 页面管理 AI Demo 生成的图片、视频