K-Vault 图床文件托管系统源码（Vue3 + Cloudflare Pages）

源码简介

这是一套开源的图床 / 文件托管系统源码，项目名 K-Vault，基于 Vue3 前端和 Cloudflare Pages Functions（也可 Docker 自托管）。它支持分片上传、签名直链、WebDAV、Telegram 机器人回链以及多种存储后端，后台可做文件管理和 API Token 管理。适合想自建图床或文件分享平台的开发者学习部署。

适用场景

• 个人 / 团队自建图床或临时文件分享平台

• 开发者学习 Vue3 + Serverless Functions 架构

• 需要多存储后端统一管理的文件托管场景

技术栈与运行环境

• 前端：Vue 3.5 + Vite 6 + vue-router 4 + Pinia 3

• 后端：Cloudflare Pages Functions（Node）或 Docker 自托管 Express 服务

• 数据库：Cloudflare KV（img_url）/ 自托管 SQLite 或 Redis

• 运行环境：Node.js + Wrangler，或 Docker Compose（Nginx + Redis）

• 其他依赖：Telegram / R2 / S3 / Discord / HuggingFace / WebDAV / GitHub 等存储后端凭据（可选）

功能亮点

• 分片上传：functions/api/chunked-upload 实现 5MB 分片、最大 100MB，状态存 KV（init.js）

• 签名直链与文件信息：file-info、v1/file 接口返回元数据与直链

• WebDAV 支持：webdav.html + utils/webdav.js，可用 WebDAV 客户端挂载

• Telegram 回链：telegram/webhook.js 机器人收文件自动回复直链

• 多存储后端：Telegram / R2 / S3 / Discord / HuggingFace / WebDAV / GitHub 适配器

• 后台管理：admin.html 文件增删改 / 移动 / 收藏、API Token 管理、图床专用管理页

安装与部署提示

1. Cloudflare 模式：Fork 仓库 → Pages 绑定 Git → 配置 TG_BOT_Token、TG_Chat_ID、BASIC_USER/PASS

1. Docker 模式：npm run docker:init-env 生成 .env → npm run docker:up 启动（含 Redis + Nginx）

1. 本地预览可用 wrangler pages dev 并绑定 KV 命名空间 img_url

截图与演示说明

常见问题

#### 必须上 Cloudflare 吗？

不必须，项目同时提供 Docker 自托管方案（Node 服务 + Redis + Nginx），可完全私有部署。

#### 存储后端怎么选？

在 .env 配置对应后端凭据即可，支持 Telegram、R2、S3、Discord、HuggingFace、WebDAV、GitHub 等多种，未配置的后端不启用。

安全风险提示

特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！

打包污染提示：仓库 `.github/` 目录下存在两份与项目无关的引流页 `小K网-每天更新大量免费资源.html`（内容相同，约 5.9KB），内含自动跳转百度搜索”刀客源码网”的 meta refresh 与 `powered-by=www.xkwo.com` 品牌植入，无代码执行危害但属下载站打包污染，发布前建议从源码包中删除；另外 `.github/workflows/bg.jpg` 体积约 21MB，位置异常，建议一并核查清理。开发脚本 `package.json` 中 dev 启动命令硬编码了 `BASIC_PASS=123`（仅本地开发用，生产请改用强口令）。

下载说明

源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。