引言：为什么选择Cloudflare R2？

在云计算时代，对象存储已成为开发者存储非结构化数据（如图片、视频、备份文件）的首选方案。然而，传统对象存储服务（如AWS S3、Google Cloud Storage）通常存在两大痛点：流量费用高昂和冷数据存储成本高。而Cloudflare R2的推出，彻底改变了这一局面——它不仅提供不限流量的数据传输，还通过去中心化架构和按实际存储量计费的模式，大幅降低了总拥有成本（TCO）。

本文将围绕“不限流量”这一核心优势，详细介绍Cloudflare R2的使用方法，涵盖基础操作、API集成、安全配置及实际应用场景，帮助开发者快速上手并最大化利用其价值。

一、Cloudflare R2的核心优势

1.1 不限流量：打破传统存储的枷锁

传统对象存储的流量费用通常与数据传输量成正比，例如AWS S3的跨区域数据传输费用可达每GB $0.09。对于高流量应用（如视频流媒体、CDN加速），这部分成本可能远超存储本身。而Cloudflare R2的不限流量特性，意味着用户无需为数据传输支付额外费用，无论数据被访问多少次，成本仅取决于存储量。

适用场景：

• 全球分布的静态网站（如使用Hugo/Jekyll生成的站点）
• 高频访问的图片/视频库（如电商产品图、UGC内容）
• 大数据备份与归档（如日志、数据库快照）

1.2 低成本存储：按实际使用量计费

R2的计费模式为每月每GB $0.015（前10GB免费），且无最低存储期限要求。相比之下，AWS S3标准层的存储费用为$0.023/GB/月，且需为API请求和跨区域复制支付额外费用。R2的定价策略使其在长期存储和频繁访问场景中更具竞争力。

1.3 与Cloudflare全球网络的无缝集成

R2天然集成Cloudflare的边缘网络，支持通过Cloudflare Workers直接操作存储桶，实现无服务器数据处理。例如，用户可以在边缘节点对上传的图片进行实时压缩，再将结果存回R2，全程无需回源到中心服务器。

二、Cloudflare R2基础操作指南

2.1 创建存储桶（Bucket）

1. 登录Cloudflare Dashboard，进入“R2”选项卡。
2. 点击“Create Bucket”，输入名称（如my-app-assets），选择访问权限（推荐“Private”）。
3. 配置跨域资源共享（CORS）规则（如需允许网页直接访问）：

   [
     {
       "AllowedOrigins": ["*"],
       "AllowedMethods": ["GET", "PUT", "POST"],
       "AllowedHeaders": ["*"]
     }
   ]

2.2 上传与下载文件

方法1：通过Dashboard上传

1. 在Bucket页面点击“Upload”，选择本地文件。
2. 上传后，文件URL格式为：
   https://<bucket-name>.<account-id>.r2.cloudflarestorage.com/<file-path>

方法2：使用r2-cli命令行工具

安装并配置r2-cli：

npm install -g @cloudflare/r2-cli
r2 config set ACCOUNT_ID=<your-account-id> API_TOKEN=<your-api-token>

上传文件：

r2 cp local-file.jpg r2://my-app-assets/images/file.jpg

2.3 设置文件生命周期规则

通过生命周期策略自动清理过期文件（如临时上传的文件）：

{
  "Rules": [
    {
      "ID": "delete-old-files",
      "Prefix": "temp/",
      "Expiration": {
        "Days": 30
      }
    }
  ]
}

三、API与开发者集成

3.1 使用Cloudflare Workers操作R2

以下是一个Worker示例，用于在上传图片时自动生成缩略图：

import { R2 } from '@cloudflare/workers-types';
export default {
  async fetch(request: Request, env: { R2_BUCKET: R2Bucket }) {
    if (request.method === 'POST') {
      const imageData = await request.arrayBuffer();
      // 生成缩略图逻辑（伪代码）
      const thumbnail = await generateThumbnail(imageData);
      await env.R2_BUCKET.put('thumbnails/file.jpg', thumbnail);
      return new Response('Thumbnail uploaded');
    }
    return new Response('Method not allowed', { status: 405 });
  }
};

3.2 直接通过HTTP API访问

R2支持标准的S3兼容API，可通过aws-sdk或@aws-sdk/client-s3直接调用：

import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
const client = new S3Client({
  endpoint: 'https://<account-id>.r2.cloudflarestorage.com',
  credentials: {
    accessKeyId: '<api-token>',
    secretAccessKey: '<empty>' // R2使用API Token而非密钥
  },
  region: 'auto'
});
const command = new PutObjectCommand({
  Bucket: 'my-app-assets',
  Key: 'data.json',
  Body: JSON.stringify({ key: 'value' })
});
await client.send(command);

四、安全与权限管理

4.1 存储桶策略（Bucket Policy）

通过JSON策略限制访问权限，例如仅允许特定IP上传文件：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Deny",
      "Principal": "*",
      "Action": ["s3:PutObject"],
      "Condition": {
        "NotIpAddress": {"aws:SourceIp": ["192.0.2.0/24"]}
      }
    }
  ]
}

4.2 临时访问凭证（Signed URLs）

生成带时效的URL，用于临时分享文件：

// 在Cloudflare Worker中
const url = await env.R2_BUCKET.createSignedUrl({
  method: 'GET',
  path: '/private/file.pdf',
  expires: Math.floor(Date.now() / 1000) + 3600 // 1小时后过期
});

五、实际应用场景

5.1 静态网站托管

结合Cloudflare Pages和R2，实现零成本静态网站：

1. 将HTML/CSS/JS文件上传至R2。
2. 在Pages配置中指定R2作为存储后端。
3. 启用“Always Online”功能，确保网站离线时仍可访问缓存。

5.2 日志与数据分析

通过R2存储服务器日志，并使用Cloudflare Analytics或Athena（通过S3兼容API）进行查询：

-- 示例：统计每日请求量
SELECT COUNT(*) AS requests, DATE(timestamp) AS day
FROM logs
GROUP BY day
ORDER BY day;

5.3 大文件分块上传

对于超过5GB的文件，使用分块上传API：

async function uploadLargeFile(bucket, key, file) {
  const { multipartUploadId } = await bucket.createMultipartUpload(key);
  const parts = [];
  for (let i = 0; i < file.size; i += 5 * 1024 * 1024) { // 5MB分块
    const part = await bucket.uploadPart(key, {
      partNumber: i / (5 * 1024 * 1024) + 1,
      uploadId: multipartUploadId,
      body: file.slice(i, i + 5 * 1024 * 1024)
    });
    parts.push(part);
  }
  await bucket.completeMultipartUpload(key, {
    uploadId: multipartUploadId,
    parts
  });
}

六、性能优化与最佳实践

1. 启用CDN缓存：通过Cloudflare的Cache Everything规则缓存R2中的静态资源，减少直接访问存储桶的次数。
2. 使用前缀过滤：在存储桶策略中限制路径前缀，避免误操作覆盖重要文件。
3. 监控成本：通过Cloudflare Analytics的“Storage”标签页跟踪实际使用量，避免意外超支。
4. 多区域部署：对于全球用户，可在不同地域创建多个R2存储桶，并通过Cloudflare的智能路由自动选择最近节点。

结论：Cloudflare R2的未来潜力

Cloudflare R2通过“不限流量+低成本”的组合，重新定义了对象存储的经济模型。对于开发者而言，它不仅是一个存储方案，更是构建高性能、低成本应用的基础设施。随着Cloudflare Workers生态的完善，R2有望成为去中心化应用（DApp）、边缘计算和实时数据处理场景的核心组件。

立即行动建议：

1. 评估现有存储方案的成本，计算迁移至R2的潜在节省。
2. 尝试将静态资源（如CSS/JS）迁移至R2，并通过Cloudflare Pages部署。
3. 探索Worker+R2的组合，实现无服务器数据处理流水线。

在云计算竞争日益激烈的今天，Cloudflare R2以其独特的定价策略和技术优势，为开发者提供了一个值得深入探索的选项。