挂载阿里云盘 Open 驱动：获取刷新令牌与限流应对

阿里云盘是 OpenList 里最常用的国内驱动之一。注意要选 「阿里云盘 Open」 驱动——它走官方开放平台接口；老的「阿里云盘」驱动已废弃不再维护，遇到 ForbiddenDriveNotValid 报错就是还在用旧驱动（见 报错速查）。

配置要点

添加存储选择「阿里云盘 Open」后，核心字段：

• 挂载路径：如 /阿里云盘（通用项见 通用设置）
• 刷新令牌（refresh token）：走开放平台授权获得。官方文档在驱动页给了获取入口与图文说明，登录阿里云盘账号授权后把得到的 refresh token 填进来
• 根文件夹 ID：挂整个云盘填 root；只挂某个文件夹就填它的 ID（从网盘网页版地址栏取）
• 也可以用上一页讲的 备注引用：已有同账号挂载时，备注第一行写 ref:/已挂载路径 复用令牌

高频报错与出处

• TooManyRequests / Too Many Requests：阿里开放平台接口限流。多设备频繁刷新、目录文件极多、缓存设得过短都会触发。对策：拉长缓存过期时间、减少无意义刷新、错峰使用。官方在驱动文档里有专节说明
• ExceedCapacityForbidden：容量相关限制类报错，同样见驱动文档「其他说明」一节
• failed to refresh token: refresh_token is missing：令牌没填对或已失效，重新走一遍授权
• 添加时 TLS handshake timeout：搭建机网络到阿里接口不通（海外 VPS + IPv6 组合最常见），官方 FAQ 给了 hosts 修改与关闭 IPv6 两种解法

使用建议

• 阿里云盘 Open 驱动支持调用其离线下载能力（见 离线下载）
• 网页播放走「Aliyun Video Previewer」选项的播放器时，可用阿里转码流直播，浏览器兼容性更好
• 涉及账号授权，不要把 refresh token 交给不明第三方工具；从 AList 时代迁移过来的用户，建议顺手解除旧授权（见 AList 迁移）

接口策略可能随阿里平台调整，以官方最新版驱动文档为准。