阿喵前言
日常办公，使用电脑手机，文件传输和备份简直是刚需。但市面上那些网盘，要么限速严重，要么会员费贵得离谱，想存点私密资料还得担心隐私泄露。有没有想过，利用咱们平时用的 Telegram 或者白嫖 Cloudflare 的资源，给自己搭一个“私人数据金库”？ 今天阿喵就给大家安利一个超硬核的开源项目——K-Vault。它能让你在不花一分钱的情况下，构建一个全能的私有聚合云盘。 好了下面开始步入主题。
项目介绍
基于 Cloudflare 的 Serverless 聚合云盘。以 Telegram 为核心（支持 Webhook 直传与 2GB 扩展），并全面兼容 R2、S3、Discord 及 HuggingFace 等多存储后端。零成本构建你的全能私有数据金库。
截图
特性
- 无限存储 – 不限数量的图片和文件上传
- 完全免费 – 托管于 Cloudflare，免费额度内零成本
- 免费域名 – 使用
*.pages.dev二级域名，也支持自定义域名 - 多存储后端 – 支持 Telegram、Cloudflare R2、S3 兼容存储、Discord、HuggingFace、WebDAV、GitHub
- Telegram Webhook 回链 – 机器人在频道/群接收文件后自动回复直链
- KV 写入优化 – Telegram 可启用签名直链，显著降低 KV 读写消耗
- 内容审核 – 可选的图片审核 API，自动屏蔽不良内容
- 多格式支持 – 图片、视频、音频、文档、压缩包等
- 在线预览 – 支持图片、视频、音频、文档（pdf、docx、txt）格式的预览
- 分片上传 – 支持最大 100MB 文件（配合 R2/S3）
- 访客上传 – 可选的访客上传功能，支持文件大小和每日次数限制
- API Token 认证 – 支持
curl/ ShareX / 脚本等程序化上传与调用 - 多种视图 – 网格、列表、瀑布流多种管理界面
- 存储分类 – 直观区分不同存储后端的文件
- 双模部署 – 保留 Cloudflare Pages 部署，同时新增 Docker 自托管（
docker compose up -d） - 动态存储配置管理 – 支持在管理端通过 API 对存储配置进行新增/编辑/删除/测试/设为默认
- 可插拔设置存储（Docker） – 基础站点设置可使用
sqlite（默认）或 Redis 协议后端（Upstash / Redis / KVrocks） - 前端路径简化 – 以根路径页面为主流程（
/、/admin.html、/webdav.html） - GitHub Actions 镜像构建 – 主分支/Tag 自动构建并推送
api+web镜像
部署
具体请查看github仓库的介绍