MyWebDrive 使用指南

MyWebDrive 的整体介绍——登录、文件管理、上传、分享、发布、管理和部署，帮你快速找到需要的那一篇。

这套指南覆盖什么

MyWebDrive 是一个文件存储与分发平台。它的架构以 Core 为中心：Core 负责身份验证、文件元数据、上传意图、配额、分享和发布；Storage 处理对象传输和后台任务；前端 Next.js 页面通过同源 Nginx 访问 API。早期拆分式的 Auth、User、Metadata、Sharing、Gateway 服务已经软退役，那些旧文档中的启动和迁移命令不再适用于当前主线。

这些说明在 2026-09-07 对照公开主分支源码、公共 OpenAPI、组件和测试编写。源项目采用 MIT 许可证。仓库仍有未完成的历史敏感材料处理，所以这里只提供经过检查的使用说明，暂不提供源码获取和仓库 Issue 链接——这并不意味着源码通过了安全审计。如果你已经拿到经维护者检查的源码副本，可以参考本地开发。

按使用目的阅读

目的	指南
第一次登录并上传一个文件	快速开始、登录与会话
查看文件、版本和下载	文件与版本
理解进度、失败重试和空间占用	上传、配额
向指定接收者或公众分发文件	分享、公开发布
管理用户、指标和通知	用户管理、仪表盘、通知
开发接口或运维自己的实例	API、本地开发、部署与恢复
操作失败	排错

页面入口与能力边界

下面的路径属于你正在使用的 MyWebDrive 实例，不是本说明站点：/signin 登录，/account 个人中心，/download 公开目录，/admin/overview 管理概览，/admin/users 用户管理，/admin/publish 发布，/admin/notifications 通知。

并不是每个已实现的 API 都有对应的界面按钮。个人中心可以上传文件、浏览文件列表、查看版本和下载；但目前还没有通用的重命名、移动、删除、回收站恢复或文件夹创建界面。分享管理和替换上传需要通过 API 完成，版本列表也不代表有恢复旧版本的按钮。不要根据旧截图或数据模型中的文件夹类型字段推断某个操作可用。

验证范围

这里的功能说明来自对固定源码的静态核对。网站文档、搜索和 AI 的测试与 MyWebDrive 实例的运行验收是分开记录的。实例首页能打开，并不意味着邮箱投递、真实上传、后台完成处理和下载都已经通过。第一次使用时，建议你按快速开始亲自完成一个无敏感内容的小文件往返测试。