快速开始
cloud-r2pan 是一个基于 Cloudflare 的轻量网盘分享系统，采用 Cloudflare Workers + R2 + D1 构建，前后端全部运行在边缘节点上，无需维护任何服务器。
✨ 功能一览
- 文件上传：浏览器直传 Worker 再写入存储，超过 100 MB 自动分片
- 分享链接：支持有效期 / 下载次数 / 访问密码三重控制
- 在线预览：图片 / 视频 / 音频 / PDF / 文本直接预览，ZIP 可查看内部目录结构
- 流量管理：全站月度流量限额，跨月自动重置，预览与下载额度独立计算
- 安全防护：单 IP 限流、重复下载检测、自动封禁与到期解封、登录审计
- 2FA 两步验证：TOTP 标准（Google Authenticator 等），支持万能恢复码
- Turnstile 人机验证：4 种触发模式 + 访问阈值规则
- OAuth2：访客下载鉴权 + 管理员第三方账号登录绑定（GitHub / Google / Microsoft）
- 激活码：批量生成、独立流量额度、时效控制
- 全球分布：Analytics Engine 驱动的 3D 地球仪下载分析
- WebDAV：对外提供 WebDAV 挂载点，也可把远程 WebDAV 网盘当作存储后端
- 中英双语：按浏览器语言与时区自动切换
🧰 环境准备
开始之前请确认：
| 要求 | 说明 |
|---|---|
| Cloudflare 账号 | 免费套餐即可，注册地址 dash.cloudflare.com/sign-up |
| Node.js | 18.0 或更高版本 |
| npm | 随 Node.js 一起安装 |
获取项目代码并安装依赖：
bash
git clone https://github.com/Admin666pro/cloud-r2pan.git
cd cloud-r2pan
npm install🚀 选择部署方式
| 方式 | 适合人群 | 文档 |
|---|---|---|
| 界面部署 | 不熟悉命令行，喜欢在 Cloudflare 控制台点选操作 | 全程控制台 + 两条本地命令 |
| 命令部署 | 熟悉终端，想用 Wrangler CLI 一气呵成 | 全程命令行 |
两种方式最终效果完全一致，均会自动完成 D1 建表与幂等迁移，无需手动执行 SQL。
🗄️ 选择存储后端
| 模式 | 存储后端 | 适用场景 | 费用 |
|---|---|---|---|
| Cloudflare 全家桶（默认） | R2 | 不想维护外部服务，生态内零配置 | 10GB 免费 + 零出口费 |
| S3 混合部署 | AWS S3 / B2 / OSS / COS 等 | 数据已在别处，或想扩展容量 | 取决于服务商 |
| WebDAV 挂载 | 坚果云等支持 WebDAV 的网盘 | 手头有现成网盘资源 | 取决于网盘 |
存储后端在部署完成后可随时于 管理后台 → 设置 中切换，详见 对象存储。