Davflare

Davflare 是一个部署在 Cloudflare Pages + Workers 上的轻量级网盘解决方案。它利用 Cloudflare R2 对象存储作为后端，为用户提供高达 10 GB 的免费存储空间和每天 10 万次 Worker 调用额度。Davflare 不仅提供了现代化的网页管理界面，还完整支持 WebDAV 协议和 MCP (Model Context Protocol)，使其成为个人文件管理、多设备同步以及 AI Agent 知识库的理想选择。

核心功能亮点

• 极致性价比：
  • 依托 Cloudflare 免费套餐，提供 10 GB R2 存储和充足的计算资源。
  • 无需维护服务器，完全 Serverless 架构，按需付费（超出免费额度后）。
• 完善的文件管理：
  • 网页端体验：支持分片上传大文件、文件夹管理、拖放操作、全局搜索。
  • 多媒体预览：自动生成图片、视频和 PDF 的缩略图，浏览更直观。
  • 分享与回收站：支持生成限时或永久分享链接（可设提取码），文件夹可打包为 ZIP 下载；内置回收站功能（默认保留 30 天）。
• 多协议兼容：
  • WebDAV Class 1/2：路径 /webdav，兼容 Cx File Explorer、BD File Manager 等主流客户端，实现手机/电脑无缝挂载。
  • RESTful API：提供完整的上传、下载、列表、重命名及双向同步接口，支持 API Key 鉴权。
  • MCP (Model Context Protocol)：路径 /mcp，支持 AI Agent 通过标准协议读取、上传和管理文件，是构建本地化 AI 知识库的理想后端。
• 静态站点托管：
  • 支持通过独立域名托管静态网站（sites/{slug}/），适合部署个人博客或文档。
• Agent 友好：
  • 遵循特定的目录约定（agents/{global|agent|project}/{skills|rules|mcp}/），方便手动拉取或推送 Agent 技能与规则。

快速部署指南

前置要求

1. 一个已绑定支付方式并开通 R2 服务的 Cloudflare 账号。
2. 创建一个 R2 Bucket（存储桶）。

方式一：一键部署（推荐）

通过 Cloudflare Pages 直接连接 GitHub 仓库进行部署。

1. 克隆仓库：将 Davflare 代码推送到你的 GitHub/GitLab。
2. 创建 Pages 项目：
   • 框架预设：None (React CRA)。
   • 输出目录：build。
3. 配置环境变量：
   • BUCKET：绑定你创建的 R2 Bucket 名称。
   • WEBDAV_USERNAME / WEBDAV_PASSWORD：设置 WebDAV 访问凭证。
   • TRASH_RETENTION_DAYS：回收站保留天数（默认 30，-1 为关闭）。
   • WEBDAV_PUBLIC_READ：设为 1 可开启公开读取（慎用）。
4. 重新部署：保存变量后触发重新部署即可生效。

方式二：Wrangler CLI 部署

# 修改 wrangler.toml 中的 bucket_name 为你的实际桶名
npm run build
npx wrangler pages deploy build

使用场景示例

1. 通过 WebDAV 挂载

• 地址：https://<your-domain.com>/webdav
• 工具：在 iOS/Android 文件管理器或 Windows 映射网络驱动器中填入上述地址及用户名密码。
• 注意：Cloudflare Workers 单次 PUT 上限为 128 MB。超过此大小的文件请使用网页端分片上传功能。

2. 通过 API 进行脚本化管理

• 鉴权：在网页端「API」页面创建密钥，使用 Authorization: Bearer <apiKey> 头。
• 常用接口：
  • POST /api/upload：支持 multipart 或原始 body 上传，大于 100MB 自动分片。
  • GET /api/list：获取目录列表。
  • POST /api/shares：创建分享链接。

3. 接入 AI Agent (MCP)

• 路径：POST /mcp
• 协议：JSON-RPC 2.0 (Streamable HTTP)。
• 功能：Agent 可调用 list, upload, download, mkdir, delete 等工具。
• 限制：经 MCP 传输的文件上限约为 1 MiB，大文件建议通过网页端处理。

⚠️ 注意事项

• 大文件上传：由于 Workers 的限制，WebDAV 和 API 直接上传有大小限制（128MB/100MB），请务必使用网页端的分片上传功能处理大文件。
• 自定义域名：建议绑定自定义域名以获得更稳定的访问体验和更好的 SEO（针对静态站点）。
• 安全性：WebDAV 密码仅在首次设置时显示，请妥善保管。API Key 具有较高权限，建议定期轮换。