CloudDrive v3.0.0

使用教程

第 0 步:创建 owner 并登录。#

打开网址首次访问自动进初始化页
→
设置账号用户名 + 强密码
→
登录使用会话有效期 7 天
项规则
用户名3–32 位,中文 / 英文 / 数字 / _ / -
密码至少 12 位,且含大小写字母 + 数字 + 特殊字符,弱密码会被拒绝
系统单用户制:只有一个 owner(恒为管理员 + 无限个人配额),没有注册入口
安全密码 PBKDF2 1 万次存储;5 次输错锁 15 分钟;会话过期会被踢回登录页,登录后自动回到原目录

核心概念

盘符视图:先选盘,再看文件。#

root 根目录只列盘,不混排文件
→
本地盘KV / R2 / B2
+
外部盘每个账户一张盘
如 MEGA · 账号名
→
真实目录进盘后才是文件树

看主界面示意 →

文件管理

增删改移复制,全都有。#

操作怎么用
新建 / 重命名 / 移动 / 删除常规操作;同名冲突时选自动重命名 / 跳过二选一
复制到…文件、文件夹都能整个复制一份,文件夹连里面内容一起复制
批量重命名一次选最多 100 个文件一起改名
批量删除带进度显示;移动时可直接新建文件夹、记住上次位置
排序与视图按名称 / 大小 / 时间;网格 / 列表;紧凑密度;详情面板;最近上传入口

搜索与筛选

上传

拖进去就行,大文件自动续传。#

  1. 先进盘,再上传

    拖拽 / 点击 / 文件夹上传均可。上传中显示进度、速度、剩余时间;支持停止(暂停可续传)与失败重试;网络抖动自动重试 3 次。

  2. 大小不同,走的通道不同(自动选)

    大小通道
    ≤5MB走 Worker 代理上传
    5–10MB预签名 PUT 直传 + /confirm 落库(不经过 Worker,绕开 100MB 请求体墙)
    R2 ≥10MB自动分片 MPU(10MB/片,最多 10000 片),刷新页面后凭会话自动续传,会话保留 24h
    任意相同 SHA-256 的文件秒传(含跨后端拷贝也按大小计配额)
  3. 记住两面墙

    KV 盘单文件上限 20MB(超了换 R2 / B2 / 外部盘);MEGA 原生 API 盘单文件上限 64MB(超了换 WebDAV 中转或 R2/B2)。任何单文件不得超过项目硬顶 5GB。

看上传队列示意 →

下载

单个直存,多个走清单。#

单文件

点下载直接存。链接是一次性 ticket(1 小时有效),严禁在 URL 里放长期 token。

MEGA 大文件

owner 点下载自动走浏览器直连:直连 MEGA 拉密文,本地边下边解密边写盘,不经过 Worker 中转,不受 64MB 墙约束。

多文件下载清单(6 步)

  1. 选文件进清单

    勾选多个文件,打开下载清单。

  2. 先测速

    用真实文件 Range 测 4MB × 2 轮取均值,默认单连接;并发可在 1 / 3 / 5 / 10 / 全部之间调。

  3. 按批次下载

    按自适应批次间隔逐批拉取,大批量不卡死。

  4. 失败单独重试

    失败直接在那一行显示原因,单个文件可单独重试,最后出汇总报告。

预览 · 收藏 · 标签

点开即看,重要文件标星。#

类型效果
图片灯箱左右翻看
音视频点开直接播,支持拖进度(Range 断点流)
PDF直接嵌在页面里看
文本(txt / md 等 ≤1MB)在线改完保存;50MB 以上请下载查看
文本编辑是直接覆盖保存,不保留历史版本。重要内容改之前,先复制一份备份。

分享

建链 → 设密码 → 发出去 → 看统计。#

  1. 建链

    单个或批量生成独立链接;同一文件可建多条不同密码 / 过期的链接(比如一条设密码、一条不设)。

  2. 设规则

    项规则
    密码≥8 位,含大小写字母 + 数字;输错多次会锁定
    有效期最长 5 年
    文件夹链可开允许上传 / 允许编辑;分享页支持密码验证、匿名上传 / 编辑(按建链权限)
  3. 看统计,随时撤销

    每条链接能看到被看了几次、被下载了几次、最后一次是什么时候(明细保留最近 20 条访问记录);不用猜有没有人领,不想要了直接撤销。

分享链接管理:每条链接的复制、访问统计、修改与撤销
分享链接管理:复制链接 / 打开下载 / 访问统计 / 修改时间 / 修改设置 / 撤销。

同步与后台任务

关掉网页,服务端照样干活。#

关页后变慢?保活 pump

页面开着时轮询一直在推进,关页后只剩 Cron 每分钟一次——减速是调用次数差,不是 bug。在管理后台生成保活 Token,用 NAS / 定时任务每 30–60s 调一次(调用太密会 429,最小间隔 20s):

curl -X POST https://<你的Worker>/api/jobs/pump -H "Authorization: Bearer <token>"

Token 只走 Authorization 头,不要放 URL。pump 只推进拉取 / 复制任务,不能代替 Cron(同步和清理还得靠 Cron)。

新建数据同步:粘贴分享链接、选目标盘、设重复间隔三步
新建数据同步:粘贴公开链接 → 选目标盘 → 设间隔(拉取一次 / 定时),失败单独重试。

管理后台

顶栏进,管存储和账户。#

模块能做什么
存储设置KV / R2 启用开关 + 全局配额上限(MB)+ R2 Bucket 名;绑了哪个绑定,开关自动打开
外部账户添加 / 刷新 / 改凭据 / 改名 / 启用停用 / 删账户 / 设配额(MB,-1=无限,0=跟随全局)/ 手动同步。同步仅 GDrive / Zoho,MEGA / B2 实时读取
占用明细各后端 / 账户用量、占比、明细表
运行状态Cron 心跳、同步状态、pump Token 生成、优先级切换

接新网盘的具体填表步骤 → 存储接入教程

效率

快捷键表。#

按键作用
/聚焦搜索框
?查看全部快捷键
Shift + 点击连选
Ctrl + A全选当前列表
Esc取消选择 / 关弹窗
Delete删除(需确认)
PWA:支持安装到桌面与离线壳;API 和下载不缓存。会话过期被踢回登录属正常(后台轮询不踢),登录后自动回到原目录。