后台添加第一个存储的完整步骤

刚部署完的站点是空的，访问首页会提示「can't find storage with rawPath: /」——因为它还没有任何存储。添加第一个存储是部署后第一个真正的任务。

通用流程（所有驱动都走这五步）

1. 登录后台：页面底部登录 → 再点「管理」。
2. 左侧进入「存储」页，点「添加」。
3. 下拉选择驱动（如本机存储、某网盘），表单按驱动变化。
4. 填三样必填项：挂载路径（全站唯一，如 /云盘）、驱动要求的令牌或账号信息、根文件夹 ID（多数网盘填 root 表示整个盘）。
5. 保存后回前台刷新，目录树里出现新路径即成功。

挂载路径的规则

• 唯一：重复会报「UNIQUE constraint failed: x_storages.mount_path」；见报错却找不到重复项时强制刷新页面（Ctrl+F5）。
• 必填：空着会提示 MountPath 校验失败。
• 就是目录树的分支名，想挂到根目录就填「/」。

不同驱动要准备的东西不一样

• 网盘类：几乎都要先获取刷新令牌（refresh token），来源见各驱动页，如阿里云盘。
• 本机存储：只要一个本机文件夹路径，见本机存储。
• 协议类（S3/WebDAV/FTP）：填对端地址与账号密码。

表单里的公共选项

缓存过期、序号、签名、代理策略等一整栏是所有驱动共享的，单独放在通用项详解里讲。保存后出现异常再看挂载报错。