轻量私有云存储 · 说明 (v2)

基于 Cloudflare Workers + R2 + D1 + KV 的轻量级私有云盘，现已升级 Token 鉴权，安全性大幅提升。

本服务可与短链接快速访问服务共用 KV 命名空间与 相同的 JWT_SECRET，实现登录状态互通。一处登录，两处并行管理。

v2 主要更新

Token 鉴权机制：采用 JWT（JSON Web Token）验证，密码仅在登录时传输一次，后续所有操作通过 Token 完成，避免密码在请求中反复暴露。
登录状态缓存：关闭页面后再次打开可自动恢复管理员/用户身份，无需重复输入密码。
退出登录：右上角增加退出按钮，可手动吊销 Token，安全可控。
性能提升：管理 API 不再每次验证密码时读取 KV，KV 读取次数降低约 40%，更省配额。
完全兼容：与短链接服务使用同一套 JWT 密钥和 KV 存储，密码和站点设置同步更新。

使用场景

个人文件备份与同步：随时上传、下载文件，跨设备访问，数据安全存储于 Cloudflare R2。
文件分享与分发：生成独立分享链接，可自定义 Token、随时隐藏，适合临时或长期文件分享。
团队协作共享：通过分享链接和双密码权限控制，小团队内部分发文档、图片、软件包。
静态资源托管：绑定自定义域名至 R2 存储桶，作为图床或静态资源 CDN，加速网站访问。
临时文件中转：上传大文件生成分享链接，突破邮件附件限制，轻松传递资料。

核心功能

文件管理：上传（≤100MB）、下载、删除、在线预览图片/视频/音频等常用格式。
分享系统：生成永久分享链接（8位随机Token），可修改Token、隐藏分享。
权限控制：管理员/用户双密码体系，管理面板包含密码修改、网站设置、列表同步、隐藏管理。
隐藏功能：管理员可隐藏文件或分享，仅通过管理面板查看和恢复。
存储同步：自动对比 R2 存储桶与数据库，补全缺失文件并清理无效元数据。
智能下载：预览文件新窗口打开，不可预览文件直接触发下载。
用量监控：实时显示存储空间、每日操作限额。

资源消耗明细（v2 优化后）

操作场景	KV 读	KV 写	D1 读	D1 写	R2 A类	R2 B类
首页加载	0~1 (缓存)	0 (首次1)	2	1	0	0
上传文件	0~1	0	1	3	1 (PUT)	0
文件列表	0~1	0	1	0	0	0
获取下载链接	0~1	0	1	0	0	0
下载/预览文件	0	0	0~1	0	1 (GET)	0
删除文件	0~1	0	1	2	1 (DELETE)	0
创建/列出/删除分享	0~1	0	~1	~1	0	0
修改密码/网站设置	0~1	1	0	0	0	0
列表同步 (手动)	0~1	0	1	N	0	1次/1000文件

Token 验证不再需要读取 KV 中的密码，管理操作 KV 读取次数降低约 50%，免费配额更充裕。

免费额度覆盖示例

假设日均上传50次、下载200次、页面浏览100次、分享操作20次：

资源	免费配额	预计消耗	占用比例
KV 读取	10 万次/天	< 400 次/天	≤0.4%
KV 写入	1,000 次/天	< 5 次/天	≤0.5%
D1 行读取	500 万次/天	≈ 1,200 次/天	0.02%
D1 行写入	10 万次/天	≈ 250 次/天	0.25%
R2 A 类操作	1,000 万次/月	≈ 9,000 次/月	0.09%
R2 B 类操作	100 万次/月	≈ 2 次/月	0.002%
R2 存储	10 GB	≤6 GB (默认上限)	≤60%

结论：所有资源均在免费计划之内留有数十倍余量，个人或小团队使用完全无忧。

详细配置教程 (v2)

从零搭建私有云盘，可与短链接服务共用 KV 和 JWT 密钥，实现密码与登录状态同步。

0. 准备工作

一个 Cloudflare 账号（注册）
一个可绑定的域名（推荐腾讯云 .cn 域名）
域名的 DNS 服务器已修改为 Cloudflare 提供的地址

1. 创建 Cloudflare 资源

1.1 创建 R2 存储桶并绑定域名

登录 Cloudflare Dashboard → 左侧菜单【R2】。
点击“创建存储桶”，名称如 my-cloud-pan，区域选择“自动”。
创建后进入桶设置 → 公开访问 → 自定义域，绑定子域名（如 files.yourdomain.com）（可选，Worker 可直接访问私有桶）。

1.2 创建 KV 命名空间

左侧菜单【Workers & Pages】→【KV】。
点击“创建命名空间”，名称如 CLOUD_PAN_KV，保存。

1.3 创建 D1 数据库

左侧菜单【Workers & Pages】→【D1】。
点击“创建数据库”，名称如 cloud-pan-db。
创建后进入数据库详情，点击“控制台”，执行以下 SQL：

CREATE TABLE IF NOT EXISTS daily_usage (
  date TEXT PRIMARY KEY,
  a_class INTEGER NOT NULL DEFAULT 0
);
CREATE TABLE IF NOT EXISTS files (
  key TEXT PRIMARY KEY,
  name TEXT NOT NULL,
  size INTEGER NOT NULL,
  uploaded_at TEXT DEFAULT (datetime('now')),
  hidden INTEGER NOT NULL DEFAULT 0
);
CREATE TABLE IF NOT EXISTS shares (
  token TEXT PRIMARY KEY,
  file_key TEXT NOT NULL,
  file_name TEXT NOT NULL,
  created_at TEXT DEFAULT (datetime('now')),
  hidden INTEGER NOT NULL DEFAULT 0
);
                

2. 创建 Worker 并绑定资源

进入【Workers & Pages】，点击“创建应用程序”→“创建 Worker”。
命名 Worker（如 cloud-pan-worker），点击“部署”。
进入 Worker 编辑页面 → “设置”→“变量和机密”。
在“KV 命名空间绑定”中添加：变量名 KV_PAN，选择你的 KV。
在“R2 存储桶绑定”中添加：变量名 R2_PAN，选择你的桶。
在“D1 数据库绑定”中添加：变量名 DB，选择你的 D1。

下载 Worker 代码： 点击下载 v2 最新版（粘贴到编辑器全部内容）

3. 绑定自定义域名到 Worker

进入 Worker 详情页 →“触发器”→“添加自定义域”。
输入你的域名（如 pan.yourdomain.com），Cloudflare 自动配置 DNS。
等待几分钟后通过该域名访问云盘。

4. 环境变量配置

在 Worker 设置 → 变量和机密 → 环境变量中，添加以下变量：

安全提醒：

JWT_SECRET 必须设置（长度≥32，建议随机生成），并设为机密。若与短链接服务共用 KV，请确保两个 Worker 使用完全相同的值。
DOWNLOAD_SECRET 请务必设为机密，以确保下载令牌的加密安全。

5. 部署与验证

将 Worker 代码完整粘贴，点击“保存并部署”。
首次访问你的域名，系统自动初始化默认密码（管理员 admin1234，用户 user1234）。
建议立即在管理面板中修改密码、网站名称和图标，再开始上传文件。
登录后 Token 自动缓存，关闭页面后重新打开可自动恢复登录状态。点击“退出”可清除 Token。