3474 字
17 分钟
Davflare:把网盘搭在 Cloudflare R2 上,零服务器的私人云盘
2026-11-15

先说主线:网盘是自建服务里最「贵」的一类,它把服务器省了#

自建服务大多很轻:一台小 VPS 塞十几个容器毫无压力,唯独网盘是例外——它吃硬盘、吃带宽、吃内存,机器还得 24 小时开着。Davflare 的思路是把网盘彻底拆开:界面和逻辑跑在 Cloudflare Pages 上,文件本体躺在 R2 对象存储里,你名下不需要有任何一台服务器。部署一次,之后没有机器要维护、没有系统要更新、没有硬盘要操心,成本结构就是 Cloudflare 的免费额度:R2 免费 10 GB 存储,Pages Functions 每天 10 万次调用,个人网盘的量级远远够用。

项目地址:https://github.com/fanchenggang/Davflare

它该有的都有:网页文件管理、分块上传、带过期时间和提取码的分享链接、回收站、图片/视频/PDF 缩略图、全文搜索、WebDAV 服务、API Key,甚至还有给 AI 助手用的 MCP 接口。下面从架构讲起,一步步把它部署上线。

先看清架构:三块拼图,和两条边界#

Davflare 没有传统意义上的后端服务器,它的组成是这样的:

组件角色说明
Cloudflare Pages网页界面静态前端部署在 Pages 上,打开域名就是文件管理器
Pages Functions接口逻辑仓库 functions/ 目录即 Pages 函数,处理上传、分享、WebDAV 等全部 API
Cloudflare R2文件存储所有文件存进一个 R2 存储桶,通过名为 BUCKET 的绑定访问
R2 内的配置文件设置持久化五个功能开关等设置存在桶里 _$flaredrive$/config.json,重新部署不丢失

没有数据库,没有常驻进程,这也是它零维护的原因。相应地,要先认清两条边界:

  • 容量边界:R2 免费层是 10 GB。放文档、截图、工作文件中转绰绰有余;想存影音库和全家相册,请看本系列前三篇的 Cloudreve、Alist 与 Nextcloud,那是自有硬盘的活法。
  • 单文件边界:走 WebDAV 直传时单文件别超过 100 MB,原因和应对在 WebDAV 一节细说。

一句话定位:Davflare 是用 Cloudflare 的免费额度换掉一台常开的 VPS,换来的代价是容量和单文件大小都有明确上限。

准备工作:账号、支付方式、一个 R2 存储桶#

部署之前需要备齐三样东西:

  1. Cloudflare 账号,并且账号里要绑一张支付方式。R2 的开通前提就是账号有支付方式,哪怕你只用免费额度,这一步也跳不过去——这是 Cloudflare 的风控要求,不是 Davflare 的限制。
  2. 开通 R2 并建好存储桶:在 Cloudflare 控制台进入 R2,按提示开通,然后创建一个存储桶。名字随意,本文用官方 wrangler.toml 的默认名 webdav,后面绑定时对得上最省事。
  3. GitHub 账号:部署走 Pages 的 Connect to Git,需要把仓库连接过去。可以直接选官方仓库,也可以先 Fork 一份到自己名下再部署——Fork 的好处是上游更新时你能自己决定何时同步,推荐 Fork。

域名不是必需的:Pages 会给一个 *.pages.dev 免费域名先用起来。想绑自己的域名,部署完成后在 Pages 项目里加 Custom domain 即可,本文最后会再提一句。

路线一(推荐):控制台 Connect to Git 部署#

整个过程不用写一行命令,在 Cloudflare 控制台里点完:

  1. 打开 Workers & Pages → Create → Pages → Connect to Git,选择 fanchenggang/Davflare(或你 Fork 的那份)。
  2. 构建设置照抄这一组:
    • Framework preset(框架预设):None
    • Build command(构建命令):npm run build
    • Build output directory(输出目录):build
  3. 点部署,等第一次构建完成。第一次部署注定是打不开的,因为存储桶绑定和账号密码还没配——这是正常流程,不要以为部署失败了。
  4. 进入这个 Pages 项目的 Settings → Bindings,添加 R2 bucket 绑定:变量名必须填 BUCKET,存储桶选刚建好的那个。
  5. 在 Settings → Environment variables 里添加两个变量(Production 环境):
    • WEBDAV_USERNAME:你的登录用户名,自己定
    • WEBDAV_PASSWORD:登录密码,设一个足够强的;网页登录和 WebDAV 共用这一套账号密码
  6. 回到 Deployments 页,对最新部署点 Retry deployment,让绑定和变量生效。
  7. 部署完成后打开 Pages 域名,用刚设的用户名密码登录,应该能进入文件管理器。

第 6 步是最容易漏的一步:绑定和环境变量都是在部署之后才配的,配完必须重新部署一次才会生效。漏掉它,现象通常是页面能开但登录一直失败,或者接口直接报错,很多人会误判成密码记错了。

WARNING

这是 Pages 项目,不是 Workers 项目。 仓库里没有 Worker 入口文件,只有 Pages 的构建输出配置。千万不要点仓库 README 旁边的「Deploy to Cloudflare Workers」按钮,也不要对它执行 wrangler deploy——那条路会直接报 entry point not configured(找不到入口点)。正确的命令只有 wrangler pages deploy,下一节会讲。

部署后先打开自检页#

登录后先访问一次 #/setup 页面(设置里也有入口)。这是 Davflare 自带的体检清单,会逐项检查:R2 读写是否通、WebDAV 的 PROPFIND 是否正常、五个功能开关状态、SITES_HOST 配置、MCP 的 tools/list 是否可达。全部变绿,说明这套部署是真的通了,而不是「页面能打开就算成功」。

路线二:Wrangler 命令行部署#

习惯命令行的话也可以全程本地操作。先把仓库拉下来,确认 wrangler.toml 里 R2 绑定的桶名和你建的一致(默认就是 webdav,不一致就改 bucket_name):

Terminal window
git clone https://github.com/fanchenggang/Davflare.git
cd Davflare
npm install
npm run build
npx wrangler pages deploy build

本地想先预览效果(包含 Pages Functions 的完整预览):

Terminal window
npx wrangler pages dev build

CLI 部署完成后,绑定与环境变量仍然要去控制台补上(BUCKET、WEBDAV_USERNAME、WEBDAV_PASSWORD),补完同样要重新部署一次才生效。两条路线后半段是汇合的。

环境变量速查#

名称类型必填说明
BUCKETR2 绑定是指向你的存储桶,变量名写错一个字母都不行
WEBDAV_USERNAME环境变量是网页与 WebDAV 共用的登录用户名
WEBDAV_PASSWORD环境变量是登录密码,按密钥级别对待
WEBDAV_PUBLIC_READ环境变量否设为 1 开启公开只读访问,不需要就别开
TRASH_RETENTION_DAYS环境变量否回收站保留天数,默认 30;设 -1 表示不自动清理
SITES_HOST环境变量否静态站点与图床的独立域名,形如 sites.你的域名,需把该域名也绑到同一个 Pages 项目

功能导览:日常用得到的都在这儿#

部署完成只是开始,Davflare 的功能密度比预想的高:

  • 上传下载:网页端分块上传,大文件不怕中途断线;支持拖拽、文件夹管理、按名搜索;图片、视频、PDF 都有缩略图预览,媒体和 PDF 分享页是零 JS 的极简预览页,打开很快。
  • 分享链接:可以设过期时间(或永久)、加提取码,文件夹还能打包成 zip 下载。临时给人传文件,不用再走第三方网盘的限速通道。
  • 回收站:删错文件有后悔药,保留天数由 TRASH_RETENTION_DAYS 控制。
  • Quick paste:工具栏里粘贴一段文本就生成 .txt 并给出分享链接,等于顺手自建了一个 Pastebin,传代码片段、日志、笔记很方便。
  • 图床:在文件管理页直接 Ctrl/Cmd+V 粘贴截图就上传,自动把 https://<SITES_HOST>/i/{id} 形式的直链复制到剪贴板——写博客、发论坛时贴图一步到位(需要先配好 SITES_HOST)。仓库里还附带了 PicGo 插件 picgo-plugin-davflare,用 PicGo 管理图床的可以接上。
  • 发布站点:选中一个文件夹可以发布成下载页(带文件名、大小、SHA-256)、PDF 书架页或播客 RSS,内容落在 sites/{slug}/ 下,走 SITES_HOST 对外。

五个功能开关#

设置页(#/settings)里有五个持久化开关,默认全开,按需关停即可,关掉不会删已存的文件:

开关关掉之后
WebDAV顶部 WebDAV 入口隐藏,/webdav 返回 404,客户端无法挂载(网页管理不受影响)
MCP/mcp 返回 404,AI 助手无法接入
API Key密钥管理隐藏,API Key 调用返回 401;注意 MCP 靠 API Key 鉴权,这个关了 MCP 也会跟着不可用
Sites站点页隐藏,SITES_HOST 下的已发布站点返回 404(文件不删)
Image host图床界面隐藏,/i/* 直链返回 404(图片不删)

只想当私人网盘用的话,把 Sites 和 Image host 关掉、攻击面立刻小一圈;SITES_HOST 本身没配的话,这两个功能在基础设施层就是关的。

WebDAV 接入:把它挂到电脑和手机上#

网页端之外,Davflare 的另一半价值在 WebDAV(协议完整度是 Class 1/2,地址固定为):

https://你的域名/webdav

用户名、密码就是部署时设的 WEBDAV_USERNAME / WEBDAV_PASSWORD。常见接法:

  • Windows:资源管理器「此电脑」右键 → 添加一个网络位置,填上面的地址和账号密码,即可当网络驱动器用。
  • macOS:Finder → 前往 → 连接服务器,填地址后按提示登录。
  • 手机:iOS「文件」App 或安卓文件管理器(如质感文件、FE 文件管理器)添加 WebDAV 服务器即可。
  • Obsidian 同步:装社区插件 Remotely Save,远程服务选 Webdav,填地址与账号密码,Auth Type 选 basic,「Depth Header Sent To Servers」保持默认的 only supports depth='1',远程根目录留空(默认用仓库名)。先在一台设备同步成功,再在第二台建同名空仓库拉下来。
WARNING

WebDAV 有一条硬限制:通过 WebDAV 上传的单文件不要超过 100 MB,超出会被 Cloudflare 以 413 错误拦下。这是 Cloudflare 边缘对请求体的上限,不是 Davflare 能绕开的。用 Remotely Save 同步时,把它的 Skip Large Files 阈值设到 100 MB 以下;真有大文件要传,走网页端的分块上传。

进阶:API Key、定时备份与 MCP#

  • 脚本化存取:在设置里开启 API Key 并创建一把,脚本里带 Authorization: Bearer <key> 或 X-Api-Key 就能走开放 API 做上传、下载、同步,适合把日志、构建产物自动归档进来。
  • 定时备份:官方有配套 CLI:npm i -g davflare-cli,再 davflare login --server https://你的域名 登录。设置页的「Scheduled backup」卡片会直接给出 push(本地推到网盘)或 pull(从网盘拉回本地)的 crontab 行,复制进 crontab -e 即可;密钥保存在本机 ~/.config/davflare,不会出现在定时任务命令里。也有现成的 GitHub Actions 示例可以抄。
  • 给 AI 助手当工作区:MCP 接口在同源的 /mcp,约 25 个工具。Cursor 或 Claude Desktop 填好地址和 API Key 就能让 AI 直接在你的网盘里存文件、建分享、发布站点;设置页能一键复制/下载 mcp.json 配置。仓库还附了官方 Agent Skill,可以让编程助手更熟练地调用这套接口。

四款网盘怎么选#

本系列四篇正好是四种活法,简单对照:

CloudreveAlistNextcloudDavflare
跑在哪自己的 VPS自己的 VPS自己的 VPS(最重)Cloudflare Pages,零服务器
文件存哪本地盘/对象存储聚合各家网盘本地盘R2(免费 10 GB)
强项分享与存储策略把多家网盘收拢成一个站同步+在线文档协作零成本、零维护、分享与图床
WebDAV支持支持支持支持(单文件 ≤100 MB)
适合长期私人文件库网盘太多想统一入口团队/家庭办公随身中转、截图分享、小文件托管

选型口诀:文件量大、要长期保存,用自有服务器三件套;只是随身带一份随时能分享的文件,Davflare 的零成本很难被替代。两者也不冲突——很多人是 Nextcloud 管长期档案,Davflare 管临时中转。

排障清单#

  • 部署报 entry point not configured:走错 Workers 路线了。删掉重来,用 Pages 的 Connect to Git 或 wrangler pages deploy。
  • 页面能开但登录失败:十有八九是配完变量没重新部署。回 Deployments 对最新部署 Retry deployment;顺带检查 WEBDAV_USERNAME、WEBDAV_PASSWORD 有没有填到 Production 环境。
  • 接口报错或文件列表为空:检查 BUCKET 绑定名是否一字不差、桶是否建在同一个账号下;再去 #/setup 看 R2 读写检查是否变绿。
  • WebDAV 返回 404:设置里的 WebDAV 开关被关了,打开即可(开关状态存在 R2 配置里,重新部署不会重置)。
  • WebDAV 传大文件报 413:单文件超 100 MB,改走网页端分块上传,或先压缩拆分。
  • 图床/站点页面样式错乱:SITES_HOST 所在域名要在 Cloudflare 里把 Caching → Browser Cache TTL 设为 Respect Existing Headers,否则默认 4 小时缓存会改写静态资源的缓存头,页面资源容易串版本。
  • R2 开通不了:先给账号绑支付方式,并至少手动创建一个存储桶,Pages 绑定时才有桶可选。

小结#

Davflare 把「自建网盘」这件事压缩到了极致:一台服务器都不用,十分钟部署,之后只剩使用。它不会取代 Nextcloud 那种全家桶——10 GB 免费容量和 100 MB 的 WebDAV 单文件上限摆在那里——但作为随身的文件中转站、截图图床和分享通道,它的成本是零,维护也是零。先用 pages.dev 域名跑起来,觉得顺手再绑自己的域名和 SITES_HOST 把图床、站点发布一并打开,就是完整的 Davflare 了。

Davflare:把网盘搭在 Cloudflare R2 上,零服务器的私人云盘
https://www.anexns.cloudns.org/posts/clouddrive-davflare/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0