# R2

Store large amounts of unstructured data without egress fees

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/r2/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Cloudflare R2](https://cloudflaredoc.ubitools.com/r2/index.md): Cloudflare R2 是一款经济高效、可扩展的对象存储解决方案，适用于云原生应用、Web 内容和数据湖，且无需支付出口流量费用。

## 快速入门

- [快速入门](https://cloudflaredoc.ubitools.com/r2/get-started/index.md): 创建您的第一个 R2 存储桶，并使用仪表板、S3 兼容工具或 Workers 存储对象。
- [CLI](https://cloudflaredoc.ubitools.com/r2/get-started/cli/index.md): 使用 Wrangler、rclone 或 AWS CLI 从命令行使用 R2。
- [S3](https://cloudflaredoc.ubitools.com/r2/get-started/s3/index.md): 使用 boto3 和 AWS SDK 等 S3 兼容 SDK 与 R2 交互。
- [Workers API](https://cloudflaredoc.ubitools.com/r2/get-started/workers-api/index.md): 通过 Workers API 从 Cloudflare Workers 使用 R2。

## R2 工作原理

- [R2 工作原理](https://cloudflaredoc.ubitools.com/r2/how-r2-works/index.md): 了解 R2 的工作原理。

## 数据迁移

- [数据迁移](https://cloudflaredoc.ubitools.com/r2/data-migration/index.md): 使用 Super Slurper 或 Sippy 将数据从其他云提供商迁移到 R2。
- [迁移策略](https://cloudflaredoc.ubitools.com/r2/data-migration/migration-strategies/index.md): 结合 Super Slurper 和 Sippy，以最小停机时间将对象迁移到 R2。
- [Sippy](https://cloudflaredoc.ubitools.com/r2/data-migration/sippy/index.md): 在请求对象时按需将对象增量迁移到 R2，减少出口费用。
- [Super Slurper](https://cloudflaredoc.ubitools.com/r2/data-migration/super-slurper/index.md): 通过一次性批量迁移作业将对象从其他云提供商复制到 R2。

## 对象

- [对象](https://cloudflaredoc.ubitools.com/r2/objects/index.md): 管理存储在 Cloudflare R2 存储桶中的对象。
- [删除对象](https://cloudflaredoc.ubitools.com/r2/objects/delete-objects/index.md): 从 R2 存储桶中删除单个对象或文件夹。
- [下载对象](https://cloudflaredoc.ubitools.com/r2/objects/download-objects/index.md): 使用仪表板、Workers API、S3 API 或 CLI 工具从 R2 下载对象。
- [上传对象](https://cloudflaredoc.ubitools.com/r2/objects/upload-objects/index.md): 通过仪表板、Workers API 或 S3 API 使用单次上传或分片上传将对象上传到 R2。

## API

- [API](https://cloudflaredoc.ubitools.com/r2/api/index.md): 通过 S3 兼容 API、Workers API 或 Cloudflare REST API 访问 R2 存储。
- [错误代码](https://cloudflaredoc.ubitools.com/r2/api/error-codes/index.md): Workers API 和 S3 兼容 API 返回的 R2 错误代码参考。
- [S3 API 兼容性](https://cloudflaredoc.ubitools.com/r2/api/s3/api/index.md): 查看 R2 支持哪些 S3 API 操作和功能，包括实现状态。
- [扩展](https://cloudflaredoc.ubitools.com/r2/api/s3/extensions/index.md): R2 对 S3 API 的扩展，包括 Unicode 元数据和自定义请求头。
- [预签名 URL](https://cloudflaredoc.ubitools.com/r2/api/s3/presigned-urls/index.md): 生成预签名 URL，在不暴露凭据的情况下授予对 R2 对象的临时访问权限。
- [临时凭据](https://cloudflaredoc.ubitools.com/r2/api/s3/temporary-credentials/index.md): 了解 R2 中的临时凭据。
- [身份验证](https://cloudflaredoc.ubitools.com/r2/api/tokens/index.md): 生成和管理用于 S3 兼容 SDK 和 API 的 R2 API 令牌。
- [Workers API 参考](https://cloudflaredoc.ubitools.com/r2/api/workers/workers-api-reference/index.md): R2 Worker 内 API 完整参考，包括存储桶和对象操作。
- [从 Workers 使用 R2](https://cloudflaredoc.ubitools.com/r2/api/workers/workers-api-usage/index.md): 将 R2 存储桶绑定到 Worker 并执行读取、写入和列出操作。
- [从 Workers 使用 R2 分片 API](https://cloudflaredoc.ubitools.com/r2/api/workers/workers-multipart-usage/index.md): 通过 Cloudflare Worker 使用分片 API 向 R2 上传大型对象。

## R2 Data Catalog

- [R2 Data Catalog](https://cloudflaredoc.ubitools.com/r2/data-catalog/index.md): 直接内置于 R2 存储桶的托管 Apache Iceberg 数据 catalog。
- [DuckDB](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/duckdb/index.md): 将 DuckDB 连接到 R2 Data Catalog，以查询和管理 Iceberg 表。
- [PyIceberg](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/pyiceberg/index.md): 将 PyIceberg 连接到 R2 Data Catalog，在 Python 中创建和查询 Iceberg 表。
- [Snowflake](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/snowflake/index.md): 通过 catalog integration 从 Snowflake 查询 R2 Data Catalog 表。
- [Spark (PySpark)](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/spark-python/index.md): 将 PySpark 连接到 R2 Data Catalog，以读写 Iceberg 表。
- [Spark (Scala)](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/spark-scala/index.md): 构建连接到 R2 Data Catalog 的 Scala Spark 应用程序，用于 Iceberg 表操作。
- [StarRocks](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/starrocks/index.md): 将 StarRocks 连接到 R2 Data Catalog，以查询和修改 Iceberg 表。
- [Trino](https://cloudflaredoc.ubitools.com/r2/data-catalog/config-examples/trino/index.md): 使用 Iceberg REST catalog 连接器将 Trino 连接到 R2 Data Catalog。
- [删除数据](https://cloudflaredoc.ubitools.com/r2/data-catalog/deleting-data/index.md): 如何正确从 R2 Data Catalog 删除数据
- [快速入门](https://cloudflaredoc.ubitools.com/r2/data-catalog/get-started/index.md): 了解如何在存储桶上启用 R2 Data Catalog、加载示例数据并运行首次查询。
- [管理 catalog](https://cloudflaredoc.ubitools.com/r2/data-catalog/manage-catalogs/index.md): 了解如何管理与 R2 存储桶关联的 Iceberg REST catalog
- [指标和分析](https://cloudflaredoc.ubitools.com/r2/data-catalog/observability/metrics/index.md): 通过 GraphQL Analytics API 查询 R2 Data Catalog 的 Iceberg REST API 操作和表维护作业指标。
- [平台](https://cloudflaredoc.ubitools.com/r2/data-catalog/platform/index.md): R2 Data Catalog 平台详情，包括定价。
- [定价](https://cloudflaredoc.ubitools.com/r2/data-catalog/platform/pricing/index.md): R2 Data Catalog 的 catalog 操作、压缩定价及包含用量详情。
- [表维护](https://cloudflaredoc.ubitools.com/r2/data-catalog/table-maintenance/index.md): 了解 R2 Data Catalog 如何自动化表维护

## R2 SQL

- [R2 SQL](https://cloudflaredoc.ubitools.com/r2-sql/index.md): R2 SQL 是 Cloudflare R2 的无服务器 SQL 接口，支持查询和分析数据。

## 教程

- [教程](https://cloudflaredoc.ubitools.com/r2/tutorials/index.md): 使用对象存储构建应用程序的 R2 分步教程。
- [使用 Cloudflare Access 保护 R2 存储桶](https://cloudflaredoc.ubitools.com/r2/tutorials/cloudflare-access/index.md): 您可以使用 Cloudflare Access 保护对 R2 存储桶的访问，仅允许组织内的特定用户、组或应用程序根据您定义的策略访问存储桶中的对象。
- [Mastodon](https://cloudflaredoc.ubitools.com/r2/tutorials/mastodon/index.md): 本指南说明如何配置 R2 作为自托管 Mastodon 实例的对象存储。您可以通过多种方式设置自托管实例。
- [Postman](https://cloudflaredoc.ubitools.com/r2/tutorials/postman/index.md): 了解如何配置 Postman 以与 R2 交互。
- [使用事件通知在上传时汇总 PDF 文件](https://cloudflaredoc.ubitools.com/r2/tutorials/summarize-pdf/index.md): 使用事件通知在上传时汇总 PDF 文件。使用 Workers AI 汇总 PDF 并将摘要存储为文本文件。
- [使用事件通知记录并存储 R2 上传事件](https://cloudflaredoc.ubitools.com/r2/tutorials/upload-logs-event-notifications/index.md): 本示例提供分步指南，说明如何使用事件通知捕获 R2 上传日志并将其存储在单独的存储桶中。

## 视频

- [视频](https://cloudflaredoc.ubitools.com/learning-paths/r2-intro/series/r2-1/index.md): 观看涵盖 R2 存储设置、配置和常见用例的视频教程。

## 演示与架构

- [演示与架构](https://cloudflaredoc.ubitools.com/r2/demos/index.md): 探索 Cloudflare R2 演示和参考架构，涵盖全栈应用、存储和 AI，并提供示例与用例。

## 平台

- [平台](https://cloudflaredoc.ubitools.com/r2/platform/index.md): R2 平台详情，包括限制、定价、分析和故障排除。
- [审计日志](https://cloudflaredoc.ubitools.com/r2/platform/audit-logs/index.md): 查看 R2 存储桶配置变更的审计日志。
- [事件订阅](https://cloudflaredoc.ubitools.com/r2/platform/event-subscriptions/index.md): 使用 Cloudflare Queues 订阅 R2 存储桶事件和 Super Slurper 事件。
- [限制](https://cloudflaredoc.ubitools.com/r2/platform/limits/index.md): Cloudflare R2 存储的账户、存储桶和对象限制。
- [指标和分析](https://cloudflaredoc.ubitools.com/r2/platform/metrics-analytics/index.md): 通过仪表板或 GraphQL Analytics API 查看 R2 存储和操作指标。
- [发布说明](https://cloudflaredoc.ubitools.com/r2/platform/release-notes/index.md): Cloudflare R2 对象存储的最新变更和更新。
- [选择存储产品](https://cloudflaredoc.ubitools.com/workers/platform/storage-options/index.md): 比较 Cloudflare 存储产品，找到适合您工作负载的方案。
- [故障排除](https://cloudflaredoc.ubitools.com/r2/platform/troubleshooting/index.md): 排查常见 R2 问题，包括 CORS 错误、403 响应和缓存行为。

## 定价

- [定价](https://cloudflaredoc.ubitools.com/r2/pricing/index.md): R2 存储、Class A 和 Class B 操作以及免费套餐的定价详情。

## buckets

- [存储桶锁定](https://cloudflaredoc.ubitools.com/r2/buckets/bucket-locks/index.md): 通过启用存储桶锁定保留策略，防止 R2 对象被删除和覆盖。
- [配置 CORS](https://cloudflaredoc.ubitools.com/r2/buckets/cors/index.md): 为 R2 存储桶设置跨源资源共享 (CORS) 策略，以支持浏览器访问。
- [创建新存储桶](https://cloudflaredoc.ubitools.com/r2/buckets/create-buckets/index.md): 使用 Cloudflare 仪表板或 Wrangler CLI 创建 R2 存储桶。
- [删除存储桶](https://cloudflaredoc.ubitools.com/r2/buckets/delete-buckets/index.md): 清空 R2 存储桶中的所有对象并永久删除存储桶。
- [事件通知](https://cloudflaredoc.ubitools.com/r2/buckets/event-notifications/index.md): 当 R2 存储桶中的对象发生变化时，向 Cloudflare Queues 发送消息。
- [本地上传（Local Uploads）](https://cloudflaredoc.ubitools.com/r2/buckets/local-uploads/index.md): 通过先将对象数据写入附近位置再异步复制，提升 R2 上传性能。
- [对象生命周期](https://cloudflaredoc.ubitools.com/r2/buckets/object-lifecycles/index.md): 为 R2 存储桶中的对象配置保留和存储类别过渡规则。
- [公开存储桶](https://cloudflaredoc.ubitools.com/r2/buckets/public-buckets/index.md): 通过自定义域名或 r2.dev 子域名将 R2 存储桶内容暴露到 Internet。
- [存储类别](https://cloudflaredoc.ubitools.com/r2/buckets/storage-classes/index.md): 在 R2 Standard 和 Infrequent Access 存储之间选择，以优化成本和访问模式。

## examples

- [使用 auth tokens 对 R2 API 进行身份验证](https://cloudflaredoc.ubitools.com/r2/examples/authenticate-r2-auth-tokens/index.md): 使用 API 令牌通过 Python 或 JavaScript 对 R2 S3 兼容 API 进行身份验证。
- [使用临时凭据对 R2 进行身份验证](https://cloudflaredoc.ubitools.com/r2/examples/authenticate-r2-temp-credentials/index.md): 使用临时凭据对 R2 进行身份验证。
- [aws CLI](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-cli/index.md): 使用 aws CLI 通过 S3 兼容 API 与 Cloudflare R2 交互。
- [aws-sdk-go](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-go/index.md): 配置 aws-sdk-go (v2) 以配合 Cloudflare R2 对象存储使用。
- [aws-sdk-java](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-java/index.md): 配置 AWS SDK for Java v2 以配合 Cloudflare R2 对象存储使用。
- [aws-sdk-js](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-js/index.md): 配置 AWS SDK for JavaScript v2 以配合 Cloudflare R2 使用。
- [aws-sdk-js-v3](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-js-v3/index.md): 配置 AWS SDK for JavaScript v3 以配合 Cloudflare R2 使用。
- [aws-sdk-kotlin](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-kotlin/index.md): 配置 AWS SDK for Kotlin 以配合 Cloudflare R2 对象存储使用。
- [aws-sdk-net](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-net/index.md): 配置 AWS SDK for .NET 以配合 Cloudflare R2 对象存储使用。
- [aws-sdk-php](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-php/index.md): 配置 `aws-sdk-php` 以使用 R2 的示例。
- [aws-sdk-ruby](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-ruby/index.md): 配置 AWS SDK for Ruby 以配合 Cloudflare R2 对象存储使用。
- [aws-sdk-rust](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws-sdk-rust/index.md): 配置 AWS SDK for Rust 以配合 Cloudflare R2 对象存储使用。
- [aws4fetch](https://cloudflaredoc.ubitools.com/r2/examples/aws/aws4fetch/index.md): 配置 aws4fetch 以使用 S3 兼容 API 对 Cloudflare R2 请求进行签名。
- [boto3](https://cloudflaredoc.ubitools.com/r2/examples/aws/boto3/index.md): 配置 Python boto3 以通过 S3 兼容 API 与 Cloudflare R2 配合使用。
- [配置自定义请求头](https://cloudflaredoc.ubitools.com/r2/examples/aws/custom-header/index.md): 使用 boto3 或 aws-sdk-js-v3 为 R2 S3 API 扩展设置自定义请求头。
- [s3mini](https://cloudflaredoc.ubitools.com/r2/examples/aws/s3mini/index.md): 配置轻量级 TypeScript S3 客户端 s3mini 以配合 Cloudflare R2 使用。
- [使用 Cache API](https://cloudflaredoc.ubitools.com/r2/examples/cache-api/index.md): 使用 Workers Cache API 将 R2 对象存储在 Cloudflare 缓存中，以实现更快的检索。
- [多云设置](https://cloudflaredoc.ubitools.com/reference-architecture/diagrams/storage/egress-free-storage-multi-cloud/index.md): 在多云无出口费用存储架构中使用 R2 的参考架构。
- [Rclone](https://cloudflaredoc.ubitools.com/r2/examples/rclone/index.md): 配置 rclone 使用 S3 兼容 API 管理和上传对象到 R2。
- [使用 SSE-C](https://cloudflaredoc.ubitools.com/r2/examples/ssec/index.md): 以下教程展示如何在 R2 上使用客户提供密钥的服务端加密 (SSE-C) 的代码片段。
- [Terraform](https://cloudflaredoc.ubitools.com/r2/examples/terraform/index.md): 使用 Cloudflare provider 通过 Terraform 配置 R2 存储桶。
- [Terraform (AWS)](https://cloudflaredoc.ubitools.com/r2/examples/terraform-aws/index.md): 使用 AWS provider 通过 Terraform 配置 R2 存储桶和对象。

## reference

- [一致性模型](https://cloudflaredoc.ubitools.com/r2/reference/consistency/index.md): R2 对读取、写入、删除和列表操作提供强全局一致性。
- [数据位置](https://cloudflaredoc.ubitools.com/r2/reference/data-location/index.md): 使用自动放置、位置提示或管辖区域控制 R2 存储数据的位置。
- [数据安全](https://cloudflaredoc.ubitools.com/r2/reference/data-security/index.md): R2 使用 AES-256 对所有对象进行静态加密，并使用 TLS 进行传输加密。
- [持久性](https://cloudflaredoc.ubitools.com/r2/reference/durability/index.md): R2 通过复制和纠删码设计为 99.999999999% 的年度持久性。
- [合作伙伴](https://cloudflaredoc.ubitools.com/r2/reference/partners/index.md): R2 合作伙伴集成指南，用于连接第三方平台。
- [Snowflake](https://cloudflaredoc.ubitools.com/r2/reference/partners/snowflake-regions/index.md): 针对每个 Snowflake 区域推荐的 R2 数据位置和管辖区域。
- [Unicode 互操作性](https://cloudflaredoc.ubitools.com/r2/reference/unicode-interoperability/index.md): R2 默认对对象键名称进行 NFC 规范化，以确保跨平台 Unicode 一致性。
- [Wrangler 命令](https://cloudflaredoc.ubitools.com/r2/reference/wrangler-commands/index.md): 用于管理 R2 存储桶和对象的 Wrangler CLI 命令。