基于 Cloudflare 的 Serverless 聚合云盘,不限数量的图片和文件上传

平时想搞个私人图床或者大容量网盘,买高配 VPS 嫌贵,白嫖各大平台的免费空间又得在不同的后台来回切,极其折腾。
最近翻到一个项目:K-Vault。
这是一个基于 Cloudflare 的 Serverless 聚合云盘,核心以 Telegram 为主要存储后端(支持 Webhook 直传 + 2GB 大文件扩展),同时全面兼容 Cloudflare R2、S3 兼容存储、Discord、HuggingFace、WebDAV、GitHub 等多种后端。
官方标语:
“免费图片/文件托管解决方案,零成本构建你的全能私有数据金库。”
适合个人/小团队搭建自己的图床、文件分享站、备份库。支持拖拽上传、API 调用、访客上传、在线预览、内容审核等完整功能。

核心功能与权限控制
-
完全免费与无限存储:托管于 Cloudflare,在免费额度内实现了零成本运行,支持不限数量的图片和文件上传。
-
免费域名:使用 *.pages.dev 二级域名,也支持自定义域名。
-
多格式与在线预览:支持图片、视频、音频、文档、压缩包等多格式文件上传,内置 pdf、docx、txt 等文件的在线预览功能。
-
API 与脚本调用:支持管理员通过 API Token 进行程序化调用,可直接配合 curl、ShareX 或脚本使用。
-
访客上传管控:提供可选的访客上传功能,站长可独立限制访客的单文件大小和每日上传次数。
-
管理后台视图:后台提供网格、列表、瀑布流多种视图,直观区分不同存储后端的文件。
-
动态配置管理:支持在管理端通过 API 动态新增、编辑、删除和测试存储配置。
-
全站 UI 自定义:支持在后台统一设置首页、图库、登录页的背景图、卡片透明度(毛玻璃效果)和动态背景特效,配置可跨端同步。
-
前端极简路径:采用根路径页面为主流程,
/为首页,/admin.html为管理后台,/webdav.html为 WebDAV 独立页。
存储后端与容量机制
K-Vault 最大的亮点之一是支持将文件分散存储到多种不同的后端平台:
-
Telegram 存储 (核心):支持网页直传和小文件。配合自部署 Bot API 和 Webhook,可实现群/频道接收文件后自动回复直链,支持最高 2GB 的大文件上传。提供“签名直链”的低 KV 写入模式以节省额度。
-
S3 兼容对象存储:兼容 Cloudflare R2、AWS S3、MinIO、阿里云 OSS 等,支持最大 100MB 文件的分片上传。
-
Discord 存储:通过 Webhook 或 Bot 方式存储,单文件大小限制在 25MB 到 100MB(取决于服务器 Boost 等级)。
-
HuggingFace 存储:利用 Datasets API 以 Git commit 形式存文件,支持普通上传(约 35MB)和 LFS 上传(最大 50GB)。
-
GitHub 存储:提供 releases(适合二进制大文件)和 contents(适合 20MB 以下小文件或文本)两种模式。
-
WebDAV 挂载:可直接对接 alist、群晖 NAS、坚果云等服务,作为统一的挂载入口。

内容审核与安全
- 自动内容审核:内置可选的 ModerateContent API 自动屏蔽不良图片内容,支持基于 KV 元数据的标签及白名单模式。
技术栈与部署模式
-
开发语言占比:代码库主要采用 JavaScript (45.8%) 和 HTML (42.7%) 构建。
-
双模部署方案:支持 Cloudflare Pages(Serverless 无服务器部署)和 Docker 自托管(通过
docker compose up -d部署在独立 VPS 或 NAS 上)两种模式。
注意事项
-
Cloudflare 免费额度限制:在 CF 部署模式下,每日请求上限为 10 万次;KV 数据库每日限 1000 次写入、10 万次读取。超出后需升级付费计划,或直接改用 Docker 自托管模式以绕过 CF 限制。
-
环境变量防泄露:部署过程涉及大量 Token 与 Secret(如
TG_BOT_TOKEN、SESSION_SECRET等),严禁泄露.env文件。若疑似泄露,必须立即轮换密钥并重启服务。
总结
我觉得这东西非常适合喜欢白嫖各大平台免费容量,又受够了数据分散、需要一个统一聚合面板进行可视化管理的极客玩家和站长。项目基于 MIT 协议开源。
项目地址:
https://github.com/katelya77/K-Vault