Cloudflare R2 上传器

前端直传文件到 Cloudflare R2 存储桶，不受官方300MB限制

R2 配置

1粘贴 S3 API 地址

从 R2 存储桶 → 设置 → S3 API 复制完整地址

2填写 API Tokens

Access Key ID

Secret Access Key

上传路径（可选）

安全提示：配置保存在 sessionStorage 中，关闭页面后自动清除。

3CORS 配置

在 R2 存储桶 → 设置 → CORS 策略中添加以下配置：

[{
  "AllowedOrigins": ["*"],
  "AllowedMethods": ["GET","PUT","POST","DELETE","HEAD"],
  "AllowedHeaders": ["*"],
  "ExposeHeaders": ["ETag"]
}]

⚠️ 必须包含 ExposeHeaders: ["ETag"]，否则分片上传会失败

点击或拖放文件到这里

直接上传到 R2，不经过服务器

支持大文件上传（自动分片），建议单文件不超过 5GB

(0 个文件)

暂无文件

配置 R2 参数后点击「刷新」查看文件列表

强大而安全的 R2 文件上传解决方案

文件直接从浏览器上传到 R2，不经过服务器中转，速度更快、更安全

使用分片上传技术，支持上传超过官方 300MB 限制的大文件，最大支持 5GB

显示真实的上传进度，支持同时上传多个文件，大文件自动分片并发上传

支持自定义上传路径、生成临时访问链接或永久公开链接

浏览存储桶文件列表、删除文件、复制文件链接，一站式管理

配置信息仅保存在浏览器会话中，关闭页面自动清除，保护您的密钥安全

关于 R2 Uploader 的常见疑问解答

为什么可以突破 Cloudflare R2 官方 300MB 的上传限制？

Cloudflare R2 官方控制台的 300MB 限制是 Web 界面的限制。本工具使用 S3 兼容 API 进行分片上传（Multipart Upload），将大文件分割成多个小块并行上传，最后合并成完整文件。这是 S3 标准支持的功能，理论上支持最大 5TB 的单文件上传。

我的 API 密钥安全吗？

您的 API 密钥仅存储在浏览器的 sessionStorage 中，关闭浏览器标签页后自动清除。密钥不会上传到任何服务器，所有操作都在您的浏览器中完成，直接与 Cloudflare R2 通信。建议创建仅具有必要权限的 API Token，并在使用后及时删除。

上传失败显示 CORS 错误怎么办？

需要在 R2 存储桶设置中配置 CORS 策略。点击第3步「查看示例」按钮，按照指引配置 CORS。特别注意需要添加 ExposeHeaders: ["ETag"]，否则分片上传会失败。

如何获取文件的公开访问链接？

有两种方式：1) 临时链接：点击文件列表中的复制按钮，生成带签名的预签名 URL，最长有效期 7 天；2) 永久链接：在 R2 控制台开启存储桶的公开访问，获取公开 URL 后填入弹窗中即可生成永久有效的公开链接。

上传速度很慢或经常超时怎么办？

上传速度主要取决于您的网络带宽和到 Cloudflare 节点的延迟。建议：检查网络连接是否稳定；避免同时进行其他大流量操作；如果使用 VPN，尝试切换节点或关闭 VPN；大文件会自动分片并发上传，超时时间会根据文件大小自动延长。

支持哪些文件类型？有大小限制吗？

支持所有文件类型，没有格式限制。单文件大小建议不超过 5GB（S3 分片上传的实际限制是 5TB，但浏览器内存可能成为瓶颈）。可以同时上传多个文件，系统会自动排队处理。