R2-Explorer：Cloudflare R2 的类 Google Drive 文件管理工具

R2-Explorer 是一个为 Cloudflare R2 存储桶提供类 Google Drive 界面的开源项目，让文件管理变得简单直观。该项目基于 Cloudflare Workers 部署，支持拖拽上传、文件预览、文件夹管理等丰富功能。

项目简介

R2-Explorer 由 Cloudflare 官方模板库提供，是一个自托管的文件管理解决方案。它将熟悉的云盘操作体验带到你的 R2 存储桶中，无需依赖第三方服务，所有数据都存储在你自己的 Cloudflare 账户中。

该项目在 GitHub 上作为官方模板维护，可通过 C3 (create-cloudflare CLI) 快速创建项目。

核心特性

🔒 安全机制

• 基础认证支持：内置用户名/密码认证
• Cloudflare Access 集成：支持企业级零信任访问控制
• 自托管部署：完全运行在你的 Cloudflare 账户中，数据自主可控

📁 文件管理

• 拖拽上传：支持拖拽文件快速上传到 R2
• 文件夹创建：支持创建和组织文件夹结构
• 分片上传：大文件支持分片上传，提升上传稳定性
• 右键菜单：丰富的右键上下文菜单操作
• 元数据编辑：支持编辑 HTTP 头和自定义元数据

👀 文件处理

• 浏览器内预览：无需下载即可预览多种文件格式
  • PDF 文档
  • 图片文件
  • 文本文件
  • Markdown 文档
  • CSV 表格
  • Logpush 日志文件
• 浏览器内编辑：支持在线编辑文本文件
• 文件夹上传：支持上传整个文件夹

📧 邮件集成

• 邮件接收处理：通过 Cloudflare Email Routing 接收邮件
• 附件查看：直接在界面中查看邮件附件

技术栈

安装指南

前置要求

• Node.js 环境
• Cloudflare 账号
• 已安装 Wrangler CLI

快速开始

方式一：使用 C3 CLI 创建项目

npm create cloudflare@latest -- --template=cloudflare/templates/r2-explorer-template

方式二：手动部署

1. 克隆模板仓库

git clone https://github.com/cloudflare/templates.git
cd templates/r2-explorer-template

2. 安装依赖

npm install

3. 创建 R2 存储桶

npx wrangler r2 bucket create r2-explorer-bucket

4. 部署项目

npx wrangler deploy

配置说明

编辑 src/index.ts 文件来自定义 R2 Explorer 的行为：

import { R2Explorer } from "r2-explorer";

export default R2Explorer({
  // 设置为 false 允许用户上传文件（默认为只读）
  readonly: true,

  // Cloudflare Access 团队名称（可选）
  // cfAccessTeamName: "my-team-name",
});

启用编辑功能

默认情况下，R2 Explorer 以只读模式运行。要启用文件上传和编辑功能：

export default R2Explorer({
  readonly: false,
});

⚠️ 安全提示：在启用编辑功能前，强烈建议先配置安全认证机制。参考官方安全文档。

安全建议

R2 Explorer 提供了多种安全机制来保护你的数据：

1. 基础认证：配置简单的用户名/密码保护
2. Cloudflare Access：集成企业级身份验证
3. IP 限制：通过 Cloudflare 防火墙规则限制访问来源
4. 只读模式：对于公开分享场景，建议保持只读模式

在线演示

官方提供了在线演示环境：

🌐 演示地址：https://demo.r2explorer.com

项目链接

• GitHub 仓库：cloudflare/templates/r2-explorer-template
• 官方文档：https://r2explorer.com
• 一键部署：Deploy to Cloudflare

适用场景

• 个人文件管理：为个人 R2 存储桶提供图形化管理界面
• 团队资源共享：在团队内部安全地共享和管理文件
• 静态资源托管：配合 R2 的自定义域名功能，管理网站静态资源
• 日志文件查看：利用内置的 Logpush 文件预览功能分析日志

总结

R2-Explorer 是一个功能完善、部署简单的 R2 文件管理工具。它填补了 Cloudflare R2 在图形化管理界面方面的空白，让用户能够以熟悉的云盘操作方式管理对象存储中的文件。对于已经使用 Cloudflare R2 的用户来说，这是一个值得尝试的实用工具。