在 Android 电视上通过 WebDAV 播放 OpenList 或 Alist 里的视频

Android 电视上的杨桃播放器可以通过 WebDAV 播放 OpenList 或 Alist 里的视频。两者的 WebDAV 都在 /dav 路径下，端口和网页端相同。地址填成 http://192.168.1.20:5244/dav 这样，用户名和密码用一个开启了 WebDAV 读取 权限的 OpenList 用户。下面的步骤我们在 OpenList 4.2.7 和 Alist 3.45.0 上实际走过一遍。

在 Android 手机或平板上也一样，只是地址由你直接填进表单（见在杨桃播放器里）。

你需要准备

• 一台运行着 OpenList 或 Alist 的电脑、NAS 或服务器，电视要能访问到它，里面至少添加了一个存储。
• 它的地址，也就是你在浏览器里打开网页端用的地址，例如 http://192.168.1.20:5244。没改过的话端口就是 5244。
• 电视上装好杨桃播放器（在下载页下载）；不想用遥控器打字的话，再准备一部手机。

请填运行 OpenList 那台机器的 IP 地址，不要填 localhost，也不要填电视不一定能解析的主机名。

在 OpenList 里

下面是 OpenList 的操作。Alist 是 OpenList 的前身，WebDAV 同样在 /dav 下，也需要同样的 WebDAV 读取权限。OpenList 官方的 WebDAV 说明见 doc.oplist.org/guide/advanced/webdav（页面可以切换成中文）。

用 admin 登录管理页面

打开 OpenList 的管理页面：在地址后面加上 /@manage，例如 http://192.168.1.20:5244/@manage，用 admin 登录。用 Docker 运行 OpenList 的话，第一次启动时日志里会打印 admin 的初始密码；想改密码，见 OpenList 的 Docker 安装说明。

给电视单独建一个用户

1. 进入用户，点添加。
2. 填好给电视用的用户名和密码。
3. 基本路径填 / 就能看到整个文件库，也可以只填其中某个文件夹。
4. 在权限里勾选 WebDAV 读取。杨桃播放器只读取文件，这一项就够了。不勾的话，OpenList 会拒绝这个用户的 WebDAV 请求。
5. 点添加。

直接用 admin 登录也可以，但电视上存一个只能读取的账号更稳妥。

看看文件库里有什么

存储里的每个存储，在 WebDAV 里都是一个文件夹，名字就是它的挂载路径。想把同一台机器上的某个文件夹放进文件库，就添加一个驱动为本机存储的存储，根文件夹路径填放视频的那个文件夹。

在杨桃播放器里

1. 在 Android 电视上打开杨桃播放器，进入设置、片源、添加片源。点片源类型，选 WebDAV。
2. 点用手机设置，用手机相机扫电视上的二维码。
3. 在手机上打开的页面里填好服务器地址、用户名（如果需要）和密码（就是那个 OpenList 用户的），再点发送到电视。
   • 地址是 http://，加上 IP 地址、端口和 /dav，例如 http://192.168.1.20:5244/dav。打开的是文件库的最上层，每个存储是一个文件夹。
   • 想直接打开某个存储或文件夹，就把路径接在后面，例如 http://192.168.1.20:5244/dav/Movies。
   • http:// 地址是不加密的，表单上会提示“这个地址没有加密，密码会在你的网络里以明文传输。”如果你的 OpenList 配了 HTTPS，并且证书是电视信任的，就改用 https://。
4. 电视上的表单会自动填好。点测试连接，它会去读这个文件夹，显示“连接成功”就说明没问题。然后点保存。

更愿意用遥控器？跳过第 2 步，直接在表单里输入就行：在输入框上按确认键会弹出屏幕键盘。在你用遥控器点保存之前，什么都不会存下来。

在 Android 手机或平板上，点设置、片源、添加片源，再点添加WebDAV，填上同样的地址、用户名和密码，再点测试连接和保存。在 Android 手机或平板、iPhone 或 iPad 上，WebDAV 片源里的电影或剧集也可以下载后离线观看。

在 Android 电视上播放 NAS 或 U 盘里的视频用同一个表单走了一遍，里面有 WebDAV 的操作视频。

观看

在首页左上角的片源标签里选中这个片源，再打开浏览。它会按名字把视频分到电影和剧集里；文件夹会先列出文件夹，再列出视频，只有文件名和视频的大小，在视频上按确认键播放。作品会显示放在它旁边的海报和简介（怎么命名），文件里没有的，杨桃播放器会到网上查。

• 播放过的视频会以文件名出现在观看历史里，也会出现在首页的继续播放里。在那里选它，就会从上次停下的地方接着播。
• 视频内嵌的字幕，以及和视频同名的字幕文件（Movie.mkv 旁边的 Movie.srt 或 Movie.en.srt），都可以在播放器的字幕里选择（手机或平板上是音轨和字幕）。
• 能不能播放取决于电视自带的解码器：MP4 或 MKV 封装的 H.264、H.265 最稳妥。在 Android 上，电视解不了的 AC3、E-AC-3、DTS 和 TrueHD 声音，杨桃播放器会自己解码（见Android 电视上的 DTS、TrueHD 和杜比音频）。

挂载在 OpenList 里的网盘

在 OpenList 里添加的网盘，到了杨桃播放器里和其他文件夹一样。视频怎么传到电视上，取决于这个存储的 WebDAV 策略：在存储里找到它，点编辑就能看到。

• 本机代理：由 OpenList 从网盘取视频，再转给电视。所以播放速度取决于 OpenList 从网盘取数据有多快：网盘限速，或者运行 OpenList 的机器网络慢，起播和拖动进度条都要等。本机存储只有这一项和使用代理网址可选。
• 302 重定向：OpenList 把电视转到文件本身的链接，电视直接从那里取视频。驱动支持的话，OpenList 默认就选这一项。我们用这种方式播放过视频，不过用的是自己局域网里的链接，不是真实的网盘。

如果某个网盘里的视频在 302 重定向 下播不了，把这个存储改成本机代理试试，OpenList 的文档说它兼容性最好。

免费还是 Pro

一个 OpenList 或 Alist 文件库算一个片源，不管里面挂了多少个存储，第一个片源免费。再添加第二个片源，比如 NAS 上的一个共享文件夹或一台 Jellyfin 服务器，就需要 Pro。在我们网站上售价 7.47 美元（优惠价，原价 14.95 美元，优惠持续到 2026年12月31日），一次付费，不是订阅，一个许可证可同时用在最多 5 台设备上。在 Android 电视以及 Android 手机和平板上的应用里，可以免费试用 Pro 7 天，每台设备一次，无需任何付款信息，到期自动结束。怎么购买和开启，见杨桃 Pro。

连不上怎么办

下面这些提示出现在浏览里，旁边有重试按钮。

“连不上服务器。请确认它已开机，并且和这台设备在同一网络。” 确认 OpenList 在运行、电视能访问到运行它的那台机器，并且服务器地址里的 IP 地址和端口都对，例如 http://192.168.1.20:5244/dav。

“服务器不接受这个用户名或密码。请在此来源的设置里检查。” 进入设置、片源，选中这个片源，点编辑，改正用户名和密码。它们就是这个 OpenList 用户登录网页端用的那一组。

“这个文件夹已不存在。” /dav 后面的路径在文件库里找不到，或者存储的挂载路径改过了。对照存储里的路径，检查拼写和大小写。

“这个账户无权打开这个文件夹。请在此来源的设置里检查用户名，或在服务器上检查这个账户的权限。” 这个 OpenList 用户没有 WebDAV 读取 权限。进入用户，在这个用户上点编辑，勾选 WebDAV 读取，再点保存。

故障排查列出了应用会显示的每一条提示。

杨桃播放器本身不提供任何内容。OpenList 和 Alist 是独立的开源项目，杨桃播放器与它们没有关联，也未获其认可。