OpenList 存储与驱动机制：挂载路径、缓存与列表加载一次讲透

开始挂第一个网盘之前，花两分钟理解 OpenList 的存储模型，后面几十种驱动的配置就都有了判断依据。

心智模型：驱动是「翻译器」

每种网盘接入方式都不一样，OpenList 为它们各写了一个驱动（driver）：驱动负责把网盘的私有接口翻译成统一的「列目录、读文件、写文件」操作。所以：

• 你在后台「存储」页点添加时，先选驱动（如夸克、阿里云盘 Open、本地存储）
• 每个驱动有自己的专属字段（令牌、Cookie、应用密码……），但通用项（挂载路径、序号、备注）是共用的，见 通用设置
• 驱动支持哪些操作（能否上传、能否重命名）取决于网盘接口本身，OpenList 不做魔法

挂载与聚合

每个存储必须挂在一个唯一的路径下，比如把夸克挂到 /夸克、本地磁盘挂到 /本地。前端看到的根目录就是所有挂载路径的集合：

• 想把多个挂载点合并成一个目录 → 用 别名聚合
• 想给文件加密再存 → 在网盘上面套一层 加密存储
• 同一个网盘有多个账号分摊流量 → 用 负载均衡

缓存：为什么新传的文件不显示

OpenList 会缓存目录列表，默认半小时过期。刚在网盘 App 里传了文件、网页里看不到？不是坏了，是缓存没过期：

• 等缓存自然过期
• 或在网页端进入对应目录，点右下角的刷新按钮强制刷新该目录
• 缓存时长可以在添加存储页按驱动单独调整

挂载失败的通用排查顺序

1. 报错信息直接写在添加页面上，先读懂它（多数报错见 报错速查）
2. 令牌 / Cookie 过期是最常见原因，重新获取再试
3. 搭建机器的网络环境：部分海外网盘需要海外 IP，部分国内网盘反过来
4. 网盘风控：被临时拉黑时等几小时再试，与 OpenList 无关

理解了机制，就去 通用设置 过一遍公共字段，然后挑你的网盘进对应教程页。