OpenList 是 AList 的社区分叉。它的作用是：把几十种网盘统一挂到一个 Web 界面里，并对外提供标准的 WebDAV 接口。

对普通用户来说，最实用的用法是两步：先在 OpenList 里挂上网盘，再用 WebDAV 把它接到播放器、笔记软件或本地磁盘。

下面是从零开始的完整流程。命令以 Linux/NAS 的 Docker 环境为准，Windows 用 Docker Desktop 同理。

开始前需要知道

需要一台能跑 Docker 的设备：NAS、小主机、云服务器都行
需要网盘的访问凭据。不同网盘要求不同：有的用账号密码，有的要 Cookie，有的要 refresh token
第三方挂载不是官方支持的功能。平台改接口、加风控都可能让它失效，重要数据请保留第二份

第一步：部署容器

docker run -d --restart=always \
  -v /etc/openlist:/opt/openlist/data \
  -p 5244:5244 \
  -e PUID=0 -e PGID=0 -e UMASK=022 \
  --name="openlist" \
  openlistteam/openlist:latest

三个参数的含义：

参数	作用
`-v /etc/openlist:/opt/openlist/data`	配置和数据库持久化。换成本机实际路径
`-p 5244:5244`	Web 界面和 WebDAV 都走这个端口
`--restart=always`	开机自启、崩溃重启

如果你用 Docker Compose，等价写法：

services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    restart: always
    ports:
      - "5244:5244"
    volumes:
      - /etc/openlist:/opt/openlist/data
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022

第二步：设置管理员密码

容器起来后，初始密码是随机生成的，直接查看日志能拿到，但更推荐直接重设：

docker exec -it openlist ./openlist admin set 你的新密码

然后浏览器打开 http://设备IP:5244，用用户名 admin 和刚设的密码登录。

如果打不开，先确认端口有没有被占用：docker logs openlist 看启动日志。

第三步：挂上网盘

登录后进入「管理 → 存储 → 添加」。

关键字段：

驱动：选对应网盘（阿里云盘 Open、115、夸克、百度网盘等）
挂载路径：这是你在 OpenList 里看到的目录名，比如 /aliyun
根文件夹 ID：多数网盘需要指定从哪个目录开始（通常是 root 或类似值）
凭据：按驱动要求填。有的要 token，有的要 Cookie

不同网盘的凭据获取方式差异很大，且经常变化。以 OpenList 官方文档里对应驱动的说明为准，不要照抄半年前的教程。

添加后回到首页，如果能看到目录和文件，说明挂载成功。

第四步：验证 WebDAV

OpenList 的 WebDAV 端点是同一个端口的 /dav 路径：

http://设备IP:5244/dav

用户名密码与管理员账号相同。

最快的验证方式是命令行列出目录：

curl -u admin:你的密码 http://设备IP:5244/dav/

返回一段 XML（里面是目录列表）就说明通了。返回 401 是认证失败，返回 404 通常是路径写错。

第五步：挂到本地或 NAS

这一步需要 rclone。

创建 WebDAV remote

rclone config

交互式菜单里依次选：

n 新建 remote
名字随意，比如 openlist
类型选 webdav
URL 填 http://设备IP:5244/dav
Vendor 选 other
用户名 admin，密码选 y 然后输入
后面的高级选项一路回车

挂载

mkdir -p /mnt/openlist
rclone mount openlist:/ /mnt/openlist \
  --vfs-cache-mode full \
  --allow-other \
  --daemon

参数说明：

--vfs-cache-mode full：开启本地缓存，显著改善播放和随机读取体验。这一项几乎必开
--allow-other：允许其他用户（比如 Emby 容器）访问挂载点
--daemon：后台运行

验证：ls /mnt/openlist 能看到目录就成功了。

常见问题

挂上了但播放卡顿。先确认 --vfs-cache-mode full 开了。其次检查网盘本身的限速，挂载不会突破平台限速。

Emby 里读不到文件。多半是容器权限问题。Emby 容器需要能看到挂载点，通常要把宿主机路径以相同路径映射进 Emby 容器，并加 --allow-other。

过几天就失效了。网盘凭据过期或被风控。到 OpenList 后台重新授权。这是第三方挂载的常态，不是配置错了。

能列目录但打不开文件。部分网盘对第三方客户端有下载限制。可以试试 OpenList 的「Web 代理」开关，或换用支持 302 的播放方案（见302 反代教程）。

更省事的替代方案

如果觉得 OpenList + rclone 这套太麻烦，还有几个打包好的选择：

CloudDrive2：图形化，把网盘直接挂成本地盘符，配置项少
NetMount：图形化统一管理多网盘挂载
LitePan：偏向媒体库场景，自带 STRM 生成
网盘挂载工具专题：完整列表

不确定 WebDAV、挂载这些概念的区别，先看术语表。

四步就够了

整套流程就四步：起容器 → 设密码 → 挂网盘 → 接 WebDAV。

命令很少出错，麻烦的是网盘凭据的获取和维护。这部分没有标准答案，只能跟着官方文档和社区更新走。

用 OpenList 把网盘挂载成本地目录（Docker 完整步骤）