AList 用什么播放器

更新于 2026 年 8 月 31 日 · 适用于 AList 与 OpenList

为什么强调「原生 API 而不是 WebDAV」

AList 同时提供 WebDAV 网关和自己的 HTTP API。多数第三方播放器图省事只接 WebDAV——能用，但有代价：所有流量都要穿过 AList 这台机器转发一遍。中转机放在软路由或低配小主机上时，这一层往往就是卡顿的来源。

走原生 API 就不一样了：AList 会返回该文件的 raw_url，其中不少是网盘自家 CDN 的直发地址——播放器拿着它直接从网盘拉流，完全不经过你的 AList 机器。只有那些服务端硬性要求走代理的（比如夸克视频与本地存储）才会回到 /p 代理路径上。

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

接进来的步骤

1. 「文件」页右上角点 ＋ 添加源，第一步选网盘这一类——AList 归在网盘里（排在胶囊最后），不在「局域网与 NAS」那一类下。
2. 服务器地址填它的网页访问地址，例如 http://192.168.1.5:5244。就是你平时用浏览器打开 AList 管理界面的那个地址，端口别漏。
3. 填登录信息（三种方式见下节），点测试并保存。
4. 起始目录可以填到某个挂载点（例如 /阿里云盘/影视）来只接入这一块，留 / 则是整站。挂载在 AList 里的阿里云盘、夸克、115、百度、天翼、PikPak 等会一并出现在起始目录下——在 AList 里怎么挂的，这里就怎么显示。
5. 点进这个源，浏览到存影视的目录，点顶栏的纳入媒体库，扫一遍即可得到海报墙。

三种登录方式

中间那行是最容易卡住的：开了两步验证之后，六位动态验证码每 30 秒变一次，根本存不进源配置里。所以这类实例的唯一进路是用户名留空、把令牌填进密码栏。令牌在 AList 后台的「管理 → 设置 → 其他」里可以拿到。

常见部署失误与排查

播放报 403，或者地址变成了 127.0.0.1

这是整个 AList 生态里最常见的一个部署失误：给 AList 做了反向代理，却没有在后台改「站点 URL」（site_url）。AList 在拼接代理地址时用的是这个配置项，没改的话它会拼出 http://127.0.0.1:5244/... ——那是 AList 自己机器上的地址，你的手机当然连不上。

两种修法：在 AList 后台把站点 URL 改成你实际访问的地址（推荐，一劳永逸，所有客户端都受益）；或者用已经处理了这种情况的客户端——Vela Player 会把 /p、/d 这类代理路径的主机名换成你填写的地址，网盘 CDN 直链则原样保留、不动。

提示密码错误，但密码明明是对的

AList 有个容易踩的特性：请求失败时它照样返回 HTTP 200，真正的错误码藏在响应体的 code 字段里。只看 HTTP 状态码的客户端会把密码错误、令牌过期、路径不存在统统当成「成功」，直到解析数据时才炸出一句看不懂的错误。遇到语焉不详的失败提示，优先怀疑是认证问题：核对用户名密码，开了两步验证的按上一节改用令牌。

某个目录点进去就报 500 storage not found

AList 的文件列表里有个 path 字段，它是驱动内的物理路径（例如 /media/Anime），而不是你在 AList 里看到的虚拟路径（例如 /lab/Anime）。客户端如果直接拿这个字段回问接口，就会得到 500 storage not found。正确做法是自己按浏览层级拼虚拟路径。这是客户端实现问题，遇到时换个客户端试即可判断。

能列目录，但视频加载很慢

先判断流量走的是直发还是代理。若该网盘的 raw_url 回的是网盘 CDN，速度取决于网盘本身；若走了 /p 代理，则受限于 AList 机器的上行带宽和 CPU。夸克视频与本地存储在服务端就是硬编码走代理的，这一档没法绕开。

常见问题

OpenList 和 AList 有什么区别，都支持吗？

OpenList 是 AList 的社区分叉，API 兼容，接入方式与配置完全一样，选同一个源类型即可。

能刮削出海报吗？

能。AList 源和 NAS、网盘在媒体库里地位相同：扫描后从文件名与目录结构解析片名、年份、季集，再去 TMDB / OMDb 匹配海报、简介、演员表与分集信息，结果缓存在本机。

我的 AList 挂了好几个网盘，会混在一起吗？

目录结构与 AList 里一致，各网盘各自成目录。媒体库扫描可以只选其中某几个目录，不必整盘扫。同一部片在两个网盘各存一份时，展示层会折叠成一条，其余版本收进详情页的版本菜单。

为什么不直接用 WebDAV？

WebDAV 也能用，Vela Player 同样支持——如果你的服务只提供 WebDAV，填地址即可。但对 AList 来说，原生 API 在速度（直发不吃中转带宽）和信息量（挂载结构、直链策略）上都更优，没有理由委屈成 WebDAV。