alist 挂载 阿里云盘
开源文件列表程序,统一管理多个云存储,支持 WebDAV 输出。
本教程面向想使用 alist 工具挂载阿里云盘作为存储后端的用户。alist 挂载阿里云盘的配置涉及 Refresh Token 获取、驱动选择和 WebDAV 服务设置三个关键环节,以下详细说明每一步的操作方法。
alist 挂载阿里云盘配置教程
alist 是一个开源的文件列表程序,支持将阿里云盘、百度网盘、OneDrive 等多种存储挂载为统一的文件管理系统。通过 alist 挂载阿里云盘,可以实现跨平台的云盘文件访问和管理。本教程详细介绍 alist 挂载阿里云盘的完整配置过程。
alist 挂载阿里云盘的优势
部署 alist
在进行 alist 挂载阿里云盘之前,需要先部署 alist 服务:
- 从 alist 的 GitHub 发布页下载对应系统的安装包
- 解压后运行
alist server启动服务 - 首次启动会生成随机管理员密码,注意保存
- 打开浏览器访问
http://localhost:5244,使用 admin 账号和生成的密码登录 - 登录后在管理后台修改密码并完成基本设置
docker run -d --name alist -p 5244:5244 xhofe/alist:latest 快速启动。
alist 挂载阿里云盘配置步骤
- 在浏览器中打开阿里云盘网页版(www.aliyundrive.com)并登录
- 按 F12 打开浏览器开发者工具
- 切换到 Application(应用程序)标签
- 左侧选择 Storage → Local Storage → 找到 aliyundrive.com
- 查找包含 `token` 的条目,复制其中的 `refresh_token` 值
- 登录 alist 管理后台
- 进入"存储" → "添加"
- 驱动选择"阿里云盘 Open"
- 填写以下配置信息:
- 点击"保存"
通过 alist WebDAV 访问阿里云盘
alist 挂载阿里云盘成功后,alist 自身提供了 WebDAV 服务。可以通过以下信息访问:
- WebDAV 地址:
http://你的服务器地址:5244/dav - 用户名:alist 中设置的用户名(默认 admin)
- 密码:alist 中设置的密码
alist 挂载阿里云盘常见问题
阿里云盘的 Refresh Token 通常数小时内有效,需要定期更新。可以配置自动刷新工具来维持 token 有效。
初次加载或文件数量较多时可能较慢,后续访问会使用缓存加速。可以在 alist 中配置缓存策略。
Token 已失效或被其他设备修改。重新获取 Token 并更新 alist 配置即可。
alist 高级使用技巧
除了基础的 alist 挂载阿里云盘配置外,以下是几个实用的高级使用技巧:
自动化 Token 更新:由于阿里云盘 Refresh Token 会过期,可以配置 alist 自动刷新 Token。在 alist 配置文件中开启自动更新选项,或使用社区提供的定时刷新脚本。
多用户管理:alist 支持创建多个用户账号,为不同用户分配不同的存储访问权限。在管理后台的"用户"页面添加用户,然后为每个用户分配可以访问的存储路径。
设置缓存策略:在 alist 配置中调整缓存时间,可以减少对阿里云盘 API 的请求次数,提高文件列表加载速度。建议将目录缓存设置为 30 分钟,文件信息缓存设置为 60 分钟。
HTTPS 访问:在生产环境中建议为 alist 配置 SSL 证书,启用 HTTPS 访问。可以使用 Nginx 反向代理配合 Let's Encrypt 免费证书实现。
与下载工具配合:alist 挂载阿里云盘后,可以获取文件的直链下载地址,配合 IDM、Aria2 等下载工具实现高速下载。在文件页面点击"复制直链"即可获取下载地址。
alist 性能优化建议
当使用 alist 挂载阿里云盘并访问大量文件时,可能会遇到加载速度问题。以下是优化建议:
- 将 alist 部署在本地的 NAS 或服务器上而不是远程 VPS 上,减少网络延迟
- 为 alist 分配足够的内存(建议至少 512MB),特别是在处理大量文件列表时
- 定期清理 alist 缓存,避免缓存文件占用过多磁盘空间
- 如果使用 Docker 部署,为容器分配足够的 CPU 和内存资源
- 关闭不需要的存储后端,减少 alist 的启动时间和运行内存占用
alist 常见报错及处理
如果在 alist 挂载阿里云盘后出现 500 错误,通常是 Token 过期或阿里云盘 API 变更导致。重新获取 Token 并在 alist 中更新存储配置即可解决。如果出现 403 错误,可能是请求频率过高被限流,等待几分钟后重试即可。