OpenList 挂载网盘后怎么看电影

更新于 2026 年 8 月 31 日 · 适用于 OpenList 与 AList，客户端部分基于 HarmonyOS 6.0 及以上

OpenList 和 AList 是什么关系

OpenList 是从 AList 分出来的社区分叉。对使用者来说要记住的只有一句：接口是兼容的——同样的 HTTP API、同样的 WebDAV 网关、同样的挂载与代理模型。所以凡是能接 AList 的客户端，填 OpenList 的地址一样能用，不需要客户端专门做适配，也不需要在播放器里找一个叫「OpenList」的源类型。

这段时间搜索词正在从「AList 播放器」往「OpenList 播放器」迁移，两边的教程内容其实可以互换看。本文提到「AList」的地方，换成 OpenList 都成立；反过来也一样。真正会带来差别的是你挂了哪些网盘，而不是你跑的是哪一个分叉——这一点在下面「直发还是代理」那一节会展开。

第一步：挂载，先搞清「虚拟路径」这个概念

在 OpenList 后台添加一个存储时，你要填两样东西：挂载路径和这个网盘自己的根目录。前者是它在 OpenList 目录树里出现的位置（比如 /阿里），后者是网盘账号内部的路径（比如 /影视库）。这两个路径不是一回事，而它们的区别恰好是后面所有诡异报错的根源。

举个例子：你把阿里云盘挂在 /阿里，网盘内根目录设成 /影视库。那么你在网页上看到的 /阿里/电影/沙丘.mkv，在阿里那边其实是 /影视库/电影/沙丘.mkv。OpenList 返回的文件列表里那个 path 字段给的是后者——驱动内的物理路径。客户端如果天真地拿这个字段回问接口，会撞上 500 storage not found，因为那个路径在虚拟目录树里根本不存在。正确做法是客户端按用户实际浏览的层级自己拼虚拟路径。（新版本加了 virtual_path 字段，但老实例上没有，客户端不能指望它。）

这不是你能在服务端配置里绕过去的事，它是客户端实现质量的一道分水岭。如果某个播放器进得了根目录、一点进挂载点就报 500，基本可以判定是它踩了这个坑。详细的分诊见直链播放失败排查。

挂载环节还有一条建议：影视单独挂一个存储，或者至少单独放一个顶层目录。后面纳入媒体库是按目录粒度收录的，把备份、照片、下载缓存和影视混在一棵树里，扫描时要么误收一堆垃圾条目，要么你得一个目录一个目录地点。

第二步：接进播放器

1. 「文件」页右上角点 ＋ 添加源，第一级选网盘这一类。AList / OpenList 归在网盘里（胶囊排最后），不在「局域网与 NAS」下面——很多人在那一类里找 AList 找不到，就是因为这个。
2. 服务器地址填你平时用浏览器打开管理界面的那个地址，例如 http://192.168.1.5:5244。端口别漏。做了反向代理的填你的域名。
3. 登录信息三选一：账号密码 / 用户名留空、密码栏填令牌（开了两步验证的实例只有这一条路，见 两步验证怎么登录客户端）/ 两栏都空走游客。
4. 起始目录决定接入范围。填 / 是整站；填 /阿里/影视 就只接这一块。挂了七八个网盘而只想看其中一个的话，在这里收窄比事后一个个避开省事得多。
5. 点测试并保存。它会真的连一次再存，配错了当场就知道，不用等到播放时才发现。

存好之后点进这个源，你在 OpenList 网页上看到的目录结构会原样出现——挂载的阿里云盘、夸克、115、百度、天翼、PikPak 各自成一个目录，在服务端怎么挂的，这里就怎么显示。

第三步：纳入媒体库，扫出海报墙

加完源不会自动扫描。这是刻意的：网盘里通常还塞着备份和杂物，无差别整盘扫的结果是媒体库里一堆识别不出的条目。做法是点进源、浏览到存影视的那个目录、点顶栏的纳入媒体库，按目录粒度收录。收错了长按同一颗按钮，选「将此目录移出媒体库（不删除文件）」，文件本身不动。

扫描前记得先去设置 → 元数据与刮削配好 TMDB 或 OMDb 的 Key，否则扫描只按文件名入库，有条目、没有海报和简介。两家都配的话会互为兜底。

这里有一条只在网盘型源上才要紧的细节，值得单独说：你选中的那个目录的名字，往往就是唯一能拿到的片名。SMB、NFS 这类源的文件带着完整的层级路径，识别片名时可以从路径里兜底；而网盘和 DLNA 这类源，「路径」实际上是一串对象 ID，里面一个汉字都没有。所以像 龙之家族/第 1 季 4K HDR 内封/S01E06.mkv 这样的结构，如果你直接在最里层那个季目录上点「纳入媒体库」，「龙之家族」这个名字就从来没进过识别链路，二十多集会全部刮不到。

正确做法是在作品目录那一层收录——也就是包含「第 1 季」「Season 1」这类季目录的那一层，而不是季目录本身。同理，一整个「电影」目录下平铺着几百部片时，就在「电影」这一层收录，每部片自己的目录名会被当作片名来源。命名规范的完整版见电影刮削完全指南。

挂了夸克又挂了阿里：谁走 CDN 直发，谁被迫走代理

这是混挂用户最该知道的一件事，直接决定播放体验的上限。走原生 API 时，OpenList 会为每个文件返回一个 raw_url，但这个地址有两种截然不同的形态：

结论很直接：同一个 OpenList 里，阿里那块的片子和夸克那块的片子，播放路径根本不是一条。阿里的片子播放器直接从阿里 CDN 拉流，你的软路由 / 小主机一个字节都不过；夸克的视频则是服务端硬性要求走代理，绕不开，速度就卡在中转机的上行带宽上。所以如果你发现「阿里的片子秒开、夸克的片子转圈」，那多半不是客户端的问题，也不是网络抽风，而是这两条路本来就不一样。

夸克如果是你的主力盘，更划算的做法是让播放器直连夸克而不是绕一圈 OpenList——少一跳中转，直链也是端内现取的。见夸克网盘视频怎么直接播放。两个源可以同时加，同一部片在两边各存一份时，媒体库展示层会折叠成一条主版本（取体积最大的那份），其余收进详情页的版本菜单。

还有一条通用的：直链不能缓存。阿里的签名约 4 小时过期，夸克、115 更短。扫描时把地址存进数据库、第二天再用必然 403，正确做法是每次播放前现取。顺带的好处是下载中断能自动续上，因为每一轮都会重新取链。

常见问题

我从 AList 换成了 OpenList，播放器要重新配吗？

地址没变就不用动。地址变了（比如换了域名或端口）就修改源的服务器地址，登录信息照旧。媒体库里已入库的条目挂在源上，改地址不会丢，观看进度也在。

起始目录到底填到哪一层？

填到「你只想看这些」的那一层即可，它只影响这个源在文件页里从哪儿开始展示，跟媒体库收录是两回事。收录粒度由后面「纳入媒体库」单独决定，所以起始目录填宽一点也没关系。

OpenList 上新增了片子，媒体库会自己更新吗？

不会自动扫。回到那个目录再点一次「纳入媒体库」即可增量补上；已有条目的观看进度和已看状态都保留。

能不能不装 OpenList，直接连网盘？

夸克、UC、天翼、移动这四家可以端内直连，点一颗「登录并添加」在官方登录页登一次就建好源了，不需要任何服务端。OpenList 的价值在于把很多家网盘拼成一棵统一的目录树，以及支持它自己适配过的那些冷门盘。两种方式并不冲突，可以同时用。

4K 原盘能放动吗？

4K Remux 常见 80Mbps 以上，先看这条流走的是 CDN 直发还是代理（上表）。走代理时中转机的上行带宽是硬上限；走直发时取决于网盘的下发速度和你的宽带。解码这边，H.264 与 HEVC 8/10bit 走系统硬解，冷门编码自动切内置软解引擎接管，界面上是同一个播放器。顺带说明：当前版本不做 HDR 送显，HDR 片源能正常播放，但以 SDR 呈现。

OpenList 的 WebDAV 网关也能连，为什么不用它？

能连，播放器也支持，但对 OpenList 来说是降级——WebDAV 下所有流量都要穿过中转机转发一遍，上面那张表里「CDN 直发」那一列的好处全部消失。详细对比见 WebDAV 还是原生 API。