alist 挂载 阿里云盘

开源文件列表程序,统一管理多个云存储,支持 WebDAV 输出。

本教程面向想使用 alist 工具挂载阿里云盘作为存储后端的用户。alist 挂载阿里云盘的配置涉及 Refresh Token 获取、驱动选择和 WebDAV 服务设置三个关键环节,以下详细说明每一步的操作方法。

alist 挂载阿里云盘配置教程

alist 是一个开源的文件列表程序,支持将阿里云盘、百度网盘、OneDrive 等多种存储挂载为统一的文件管理系统。通过 alist 挂载阿里云盘,可以实现跨平台的云盘文件访问和管理。本教程详细介绍 alist 挂载阿里云盘的完整配置过程。

alist 挂载阿里云盘的优势

1多存储统一管理:一个 alist 界面管理阿里云盘、百度网盘等多个云存储
2提供 WebDAV 服务:挂载后可以通过 WebDAV 协议在 NAS、播放器等设备上访问阿里云盘
3跨平台支持:alist 支持 Windows、Linux、macOS、Docker 等多种部署方式
4文件直链获取:可以生成阿里云盘文件的直链下载地址
5权限管理:可以设置不同用户的访问权限

部署 alist

在进行 alist 挂载阿里云盘之前,需要先部署 alist 服务:

  • 从 alist 的 GitHub 发布页下载对应系统的安装包
  • 解压后运行 alist server 启动服务
  • 首次启动会生成随机管理员密码,注意保存
  • 打开浏览器访问 http://localhost:5244,使用 admin 账号和生成的密码登录
  • 登录后在管理后台修改密码并完成基本设置
如果使用 Docker 部署,可以执行 docker run -d --name alist -p 5244:5244 xhofe/alist:latest 快速启动。

alist 挂载阿里云盘配置步骤

  1. 在浏览器中打开阿里云盘网页版(www.aliyundrive.com)并登录
  2. 按 F12 打开浏览器开发者工具
  3. 切换到 Application(应用程序)标签
  4. 左侧选择 Storage → Local Storage → 找到 aliyundrive.com
  5. 查找包含 `token` 的条目,复制其中的 `refresh_token` 值
  6. 登录 alist 管理后台
  7. 进入"存储" → "添加"
  8. 驱动选择"阿里云盘 Open"
  9. 填写以下配置信息:
  10. 点击"保存"

通过 alist WebDAV 访问阿里云盘

alist 挂载阿里云盘成功后,alist 自身提供了 WebDAV 服务。可以通过以下信息访问:

  • WebDAV 地址http://你的服务器地址:5244/dav
  • 用户名:alist 中设置的用户名(默认 admin)
  • 密码:alist 中设置的密码
这个 WebDAV 地址可以在群晖 NAS、Infuse、Kodi 等支持 WebDAV 协议的设备中使用。

alist 挂载阿里云盘常见问题

Refresh Token 过期?

阿里云盘的 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 常见报错及处理

如果在 alist 挂载阿里云盘后出现 500 错误,通常是 Token 过期或阿里云盘 API 变更导致。重新获取 Token 并在 alist 中更新存储配置即可解决。如果出现 403 错误,可能是请求频率过高被限流,等待几分钟后重试即可。