使用教程
第 0 步:创建 owner 并登录。#
打开网址首次访问自动进初始化页
→
设置账号用户名 + 强密码
→
登录使用会话有效期 7 天
| 项 | 规则 |
|---|---|
| 用户名 | 3–32 位,中文 / 英文 / 数字 / _ / - |
| 密码 | 至少 12 位,且含大小写字母 + 数字 + 特殊字符,弱密码会被拒绝 |
| 系统 | 单用户制:只有一个 owner(恒为管理员 + 无限个人配额),没有注册入口 |
| 安全 | 密码 PBKDF2 1 万次存储;5 次输错锁 15 分钟;会话过期会被踢回登录页,登录后自动回到原目录 |
核心概念
盘符视图:先选盘,再看文件。#
root 根目录只列盘,不混排文件
→
本地盘KV / R2 / B2
+
外部盘每个账户一张盘
如 MEGA · 账号名
→
如 MEGA · 账号名
真实目录进盘后才是文件树
- 根目录下新建 / 上传按钮会被禁用并提示:请先进入一张盘。
- 盘符支持自定义图标颜色;不支持重命名 / 分享 / 删除;不同盘互不混排。
- 链接里会记住你进的是哪个文件夹,可以收藏、转发。
- KV / R2 是绑 Worker 即有的本地盘;外部盘来自存储接入添加的账户。
文件管理
增删改移复制,全都有。#
| 操作 | 怎么用 |
|---|---|
| 新建 / 重命名 / 移动 / 删除 | 常规操作;同名冲突时选自动重命名 / 跳过二选一 |
| 复制到… | 文件、文件夹都能整个复制一份,文件夹连里面内容一起复制 |
| 批量重命名 | 一次选最多 100 个文件一起改名 |
| 批量删除 | 带进度显示;移动时可直接新建文件夹、记住上次位置 |
| 排序与视图 | 按名称 / 大小 / 时间;网格 / 列表;紧凑密度;详情面板;最近上传入口 |
搜索与筛选
- 搜索框按 / 聚焦;全局搜索,结果带所在目录徽标,点一下一键定位到目录。
- 过滤条:按类型(图片 / 视频 / 音频 / PDF / 文档 / 压缩包 / 文本 / 文件夹)、时间(今天 / 近7天 / 近30天 / 近一年)、收藏、标签筛。
- 列表滑到底自动加载更多(分页 + 无限滚动)。
上传
拖进去就行,大文件自动续传。#
先进盘,再上传
拖拽 / 点击 / 文件夹上传均可。上传中显示进度、速度、剩余时间;支持停止(暂停可续传)与失败重试;网络抖动自动重试 3 次。
大小不同,走的通道不同(自动选)
大小 通道 ≤5MB 走 Worker 代理上传 5–10MB 预签名 PUT 直传 + /confirm落库(不经过 Worker,绕开 100MB 请求体墙)R2 ≥10MB 自动分片 MPU(10MB/片,最多 10000 片),刷新页面后凭会话自动续传,会话保留 24h 任意 相同 SHA-256 的文件秒传(含跨后端拷贝也按大小计配额) 记住两面墙
KV 盘单文件上限 20MB(超了换 R2 / B2 / 外部盘);MEGA 原生 API 盘单文件上限 64MB(超了换 WebDAV 中转或 R2/B2)。任何单文件不得超过项目硬顶 5GB。
下载
单个直存,多个走清单。#
单文件
点下载直接存。链接是一次性 ticket(1 小时有效),严禁在 URL 里放长期 token。
MEGA 大文件
owner 点下载自动走浏览器直连:直连 MEGA 拉密文,本地边下边解密边写盘,不经过 Worker 中转,不受 64MB 墙约束。
多文件下载清单(6 步)
选文件进清单
勾选多个文件,打开下载清单。
先测速
用真实文件 Range 测 4MB × 2 轮取均值,默认单连接;并发可在 1 / 3 / 5 / 10 / 全部之间调。
按批次下载
按自适应批次间隔逐批拉取,大批量不卡死。
失败单独重试
失败直接在那一行显示原因,单个文件可单独重试,最后出汇总报告。
预览 · 收藏 · 标签
点开即看,重要文件标星。#
| 类型 | 效果 |
|---|---|
| 图片 | 灯箱左右翻看 |
| 音视频 | 点开直接播,支持拖进度(Range 断点流) |
| 直接嵌在页面里看 | |
| 文本(txt / md 等 ≤1MB) | 在线改完保存;50MB 以上请下载查看 |
文本编辑是直接覆盖保存,不保留历史版本。重要内容改之前,先复制一份备份。
- 星标收藏:详情 / 卡片 / 批量三种入口,过滤条可只看收藏。
- 标签:一个文件可贴多个标签(如"工作 / 发票 / 2026"),按标签筛选。
- 最近上传:刚传的东西集中在一个入口看;搜索结果可一键定位到所在目录。
同步与后台任务
关掉网页,服务端照样干活。#
- 大批量复制 / 移动变后台任务:一次搬几百个文件也不怕(最多一批 500 个),关网页后服务端接着跑,下次打开在侧栏看进度。
- 别人分享的 Google Drive 文件夹,一键搬到自己盘里:粘贴公开文件夹链接,可"搬一次"也可"定时自动搬"(如每 30 分钟、每天),失败的单独列出重试。
- 同步频率自己定:外部网盘多久同步一次,管理后台统一调(5–120 分钟,默认 30 分钟)。
- Cron 优先级:管理面板可切平均 / 拉取优先 / 复制优先,下一轮生效。
关页后变慢?保活 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 和下载不缓存。会话过期被踢回登录属正常(后台轮询不踢),登录后自动回到原目录。
