先说主线:网盘是自建服务里最「贵」的一类,它把服务器省了
自建服务大多很轻:一台小 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 存储桶
部署之前需要备齐三样东西:
- Cloudflare 账号,并且账号里要绑一张支付方式。R2 的开通前提就是账号有支付方式,哪怕你只用免费额度,这一步也跳不过去——这是 Cloudflare 的风控要求,不是 Davflare 的限制。
- 开通 R2 并建好存储桶:在 Cloudflare 控制台进入 R2,按提示开通,然后创建一个存储桶。名字随意,本文用官方
wrangler.toml的默认名webdav,后面绑定时对得上最省事。 - GitHub 账号:部署走 Pages 的 Connect to Git,需要把仓库连接过去。可以直接选官方仓库,也可以先 Fork 一份到自己名下再部署——Fork 的好处是上游更新时你能自己决定何时同步,推荐 Fork。
域名不是必需的:Pages 会给一个 *.pages.dev 免费域名先用起来。想绑自己的域名,部署完成后在 Pages 项目里加 Custom domain 即可,本文最后会再提一句。
路线一(推荐):控制台 Connect to Git 部署
整个过程不用写一行命令,在 Cloudflare 控制台里点完:
- 打开 Workers & Pages → Create → Pages → Connect to Git,选择
fanchenggang/Davflare(或你 Fork 的那份)。 - 构建设置照抄这一组:
- Framework preset(框架预设):None
- Build command(构建命令):
npm run build - Build output directory(输出目录):
build
- 点部署,等第一次构建完成。第一次部署注定是打不开的,因为存储桶绑定和账号密码还没配——这是正常流程,不要以为部署失败了。
- 进入这个 Pages 项目的 Settings → Bindings,添加 R2 bucket 绑定:变量名必须填
BUCKET,存储桶选刚建好的那个。 - 在 Settings → Environment variables 里添加两个变量(Production 环境):
WEBDAV_USERNAME:你的登录用户名,自己定WEBDAV_PASSWORD:登录密码,设一个足够强的;网页登录和 WebDAV 共用这一套账号密码
- 回到 Deployments 页,对最新部署点 Retry deployment,让绑定和变量生效。
- 部署完成后打开 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):
git clone https://github.com/fanchenggang/Davflare.gitcd Davflarenpm installnpm run buildnpx wrangler pages deploy build本地想先预览效果(包含 Pages Functions 的完整预览):
npx wrangler pages dev buildCLI 部署完成后,绑定与环境变量仍然要去控制台补上(BUCKET、WEBDAV_USERNAME、WEBDAV_PASSWORD),补完同样要重新部署一次才生效。两条路线后半段是汇合的。
环境变量速查
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
BUCKET | R2 绑定 | 是 | 指向你的存储桶,变量名写错一个字母都不行 |
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',远程根目录留空(默认用仓库名)。先在一台设备同步成功,再在第二台建同名空仓库拉下来。
WARNINGWebDAV 有一条硬限制:通过 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,可以让编程助手更熟练地调用这套接口。
四款网盘怎么选
本系列四篇正好是四种活法,简单对照:
| Cloudreve | Alist | Nextcloud | Davflare | |
|---|---|---|---|---|
| 跑在哪 | 自己的 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 了。