CloudDisk

当前版本：v1.2.0 · 更新日志 · English: README-en.md

基于 Cloudflare Workers 的轻量级个人网盘，仅面向 Cloudflare 云端部署，免费、无需 VPS、无需 MySQL。

国内用户说明
部署或使用 Cloudflare 时，部分功能（如绑定支付方式、升级套餐、开通特定服务等）可能需要账户关联 Visa 或 Mastercard。若国内银行卡无法完成验证，可参考作者实测的跨境虚拟卡开通方式：虚拟信用卡实测与开卡指南。

登录 / 注册	文件列表

用户组管理	创建分享

• 上传进度与大文件分片断点续传
• Toast 操作提示与 API 错误提示
• 页脚 Cloudflare 免费套餐说明、作者官网与交流群链接

• 预览/编辑权限优化、预览链接复制、新建文件弹窗
• 管理员设置、用户组、页脚版本号

更多历史版本见 CHANGELOG.md。

CloudDisk 适合个人或小团队，在 Cloudflare 免费套餐内搭建私有网盘：数据存于 R2，元数据在 D1，登录会话在 KV，全程 Serverless。

• 文件夹层级浏览、新建文件夹 / 新建文件（任意后缀，如 .md、.py、.json）
• 上传 / 下载 / 删除 / 重命名，支持拖拽上传与上传进度显示
• 大文件（≥ 5MB）分片上传，中断后可续传（重新选择相同文件即可）

• 多用户注册登录，管理员可开关注册、管理用户与用户组
• 为文件或文件夹添加协作者：只读或可编辑
• 协作者搜索用户名自动补全，「与我共享」独立视图
• 用户组可配置上传、分享、协作、管理权限

• 外链分享：可选密码、有效期、下载次数上限
• 支持文件夹分享（浏览子目录、预览、下载）
• 可选直链下载、在线预览、访客在线编辑（视文件类型与分享设置）

• 在线预览：图片、PDF、音视频、文本、Office 文档（Word / Excel / PPT 等）
• 预览页显示完整链接并支持一键复制
• 文本类文件（≤ 2MB）在线编辑；图片等不可编辑类型不显示编辑入口
• 协作者权限与分享权限一致：只读不可编辑，可编辑才显示编辑按钮

• 全屏预览 / 编辑，操作结果 Toast 提示（成功、失败、API 错误）
• 设置页：修改密码、开放注册、用户 / 用户组管理（管理员）
• 页脚展示 Cloudflare 免费套餐相关限额说明（Workers / D1 / R2 / KV）

已部署用户升级：重新部署后需执行 D1 迁移 npm run db:migrate（或 Cloudflare Builds 部署命令中已包含）。

• Cloudflare Workers + Hono
• Cloudflare D1（元数据）+ R2（文件存储）+ KV（会话）
• Drizzle ORM + TypeScript + Tailwind CSS

在「Configure resources」步骤确认：D1 = cloud-disk，KV = cloud-disk，R2 = cloud-disk-files。项目名称 / Worker 名称 / APP_NAME 默认留空，请按需自行填写（留空 APP_NAME 时界面显示 CloudDisk）。

若提示「已存在具有该名称的存储库」 一键部署会在你的 GitHub 账号下新建一个 fork 仓库。本项目不再预填项目名称，请在部署页自行填写 Git 仓库名称（例如 my-cloud-disk）。若你已有源码仓库，建议跳过一键按钮，改用 Dashboard 连接已有仓库（见下文）。

若你已有该源码仓库，想直接部署（不 fork）
可跳过一键按钮，在 Cloudflare Dashboard → Workers & Pages → Create → 连接 GitHub 仓库 gsvps/cloud-disk，按 wrangler.toml 配置资源后部署即可。

点击按钮后，Cloudflare 会读取 wrangler.toml 并自动创建 D1、KV、R2。默认命名如下：

部署完成后访问 Workers 域名，首次打开会引导创建管理员账号。

点击一键部署后，展开「高级设置」时，以下参数会自动预填，一般无需修改：

说明：D1、KV、R2 默认名称已在仓库中预填；部署页一般保持默认即可。

git clone https://github.com/gsvps/cloud-disk.git
cd cloud-disk
npm install

npx wrangler login

D1、KV、R2 可按需预先创建，或使用部署页自动创建：

npx wrangler d1 create cloud-disk
npx wrangler kv namespace create cloud-disk
npx wrangler r2 bucket create cloud-disk-files

npm run build
npm run db:migrate
npx wrangler deploy --name cloud-disk

仓库未预填 Worker 名称时，本地部署需通过 --name 指定（名称需与 Cloudflare Dashboard 中 Worker 一致）。

该命令会依次：构建 CSS → 执行 D1 远程迁移 → 部署 Worker。

所有接口返回统一 JSON 格式：

{ "success": true, "data": {} }

{ "success": false, "error": { "code": "BAD_REQUEST", "message": "..." } }

cloud-disk/
├── src/
│   ├── index.ts          # 入口
│   ├── db/               # Drizzle schema
│   ├── routes/           # API 路由
│   ├── middleware/       # 认证中间件
│   └── lib/              # 工具函数
├── public/               # 前端静态资源
├── migrations/           # D1 迁移
└── wrangler.toml

• 作者官网：https://www.gsvps.com
• Telegram 交流群：https://t.me/gsvpscom

MIT License