NAS一键部署YT-DLP网页播放器：跨设备在线看片与下载全攻略

对于许多热衷于搭建个人私有云的NAS玩家而言，利用Docker容器部署各类下载工具、媒体服务器或自动化应用已是常规操作。最近，一个名为 YT-DLP Web Player 的项目引起了广泛关注。它将著名的视频下载工具 yt-dlp、强大的多媒体处理程序 ffmpeg 以及一个即开即用的网页播放界面巧妙地整合在一起。用户无需记忆繁琐的命令行参数，只需通过浏览器即可轻松完成视频的在线播放、分辨率选择、字幕加载乃至直接下载。该项目还原生支持渐进式网页应用（PWA）、视频搜索以及实验性的 iframe 嵌入功能。

将这款工具部署在家庭NAS上尤为合适，其容器轻量，管理入口简洁直观。一旦服务成功运行，家中的电脑、平板电脑或智能手机均可通过浏览器直接访问，实现跨设备的流媒体体验。

实际测试表明，该工具不仅适用于YouTube，对Bilibili等主流视频网站同样具有良好的支持度。

截屏2026-03-24 12.25.16.png

核心功能特性

  • 灵活播放设置：支持动态切换视频分辨率、选择不同语言的字幕，并能自由调整视频画面比例。
  • 便捷内容管理：提供视频下载功能，支持循环播放模式，并内置搜索引擎便于快速查找目标内容。
  • 跨平台体验：完整支持PWA，在安卓设备上可通过系统的“分享”功能直接调用；界面设计简洁，允许用户自定义主题颜色。
  • 扩展与集成：提供实验性的浏览器扩展支持，并可通过专属的 /iframe 端点将播放器嵌入到其他网页中。

详细部署步骤（以威联通NAS为例）

以下将通过 Docker Compose 方式演示部署过程。首先，准备如下部署代码：

services:
  ytdlp_web_player:
    image: matszwe02/ytdlp_web_player
    container_name: ytdlp_web_player
    restart: unless-stopped
    environment:
      - APP_TITLE=YT-DLP Player        # 自定义应用界面显示的标题
      - THEME_COLOR=#ff7300            # 设置主题色调
      - GENERATE_SPRITE_BELOW=1800     # 为时长低于此值（秒）的视频生成预览缩略图
      - AMOLED_BG=false                # 是否启用纯黑色背景（AMOLED设备适用）
      - MAX_VIDEO_AGE=3600             # 视频缓存文件的最大保留时间（秒）
      - MAX_VIDEO_DURATION=36000       # 允许处理的最大视频时长（秒）
      - DEFAULT_QUALITY=720            # 默认播放清晰度（例如720p）
      - LOAD_DEFAULT_QUALITY=true      # 是否自动加载设定的默认画质
      - PLAYLIST_SUPPORT=false         # 是否启用播放列表支持功能
      - DOWNLOAD_PATH=/app/download    # 容器内视频下载的存储路径
    ports:
      - "5800:5000"  # 映射端口，左侧5800可更换为NAS上任何未被占用的端口
    volumes:
      # 将容器内下载目录映射到NAS的物理路径，请根据实际情况修改`/share/Container...`部分
      - /share/Container/ytdlp_web_player/download:/app/download

接下来，登录威联通NAS的 Container Station 应用，选择“创建” -> “创建应用程序”，将上述代码粘贴至编辑区，并启动容器。

截屏2026-03-24 11.24.07.png

实际使用体验

部署成功后，在浏览器地址栏输入 你的NAS的IP地址:5800 即可访问服务主界面。

截屏2026-03-24 11.29.02.png

页面的输入框不仅支持粘贴视频链接，也支持直接输入关键词进行搜索。

找到想看的视频后，将其URL粘贴至输入框，点击右侧的播放按钮。在播放界面，你可以自由选择分辨率、调整播放速度以及加载可用字幕。

截屏2026-03-24 11.34.38.png

“缓存”选项功能强大，允许你选择下载最高画质、当前播放画质或仅音频文件，甚至还支持指定时间范围来截取视频片段。

截屏2026-03-24 11.36.17.png

需要注意的是，在网页上点击“缓存视频”按钮时，视频会同时下载到你当前使用的设备并缓存在NAS的指定目录中。事实上，当你首次点击播放时，该视频的流数据就已经开始缓存到NAS了。

截屏2026-03-24 11.56.52.png

播放器右下角的菜单提供了实用工具：可以复制当前视频的源链接、在新标签页中打开原视频页面，以及查看yt-dlp、ffmpeg等组件的版本信息。

截屏2026-03-24 11.42.51.png

最后，对比一下通过本工具下载的最高画质视频信息与YouTube原页面的统计信息，可见其成功获取到了原始媒体流。

截屏2026-03-24 12.01.14.png 截屏2026-03-24 12.00.09.png

总结

总而言之，YT-DLP Web Player 为NAS爱好者构建了一个轻量化、易于访问的网页视频中枢。它巧妙融合了yt-dlp卓越的在线视频解析能力与浏览器即点即播的便利性。通过Docker容器在威联通NAS上部署，过程简单快捷，部署后即可实现全家庭网络内跨终端（电脑、平板、手机）的直接访问，轻松完成视频播放、多格式下载、画质选择与字幕管理等操作。无论是为了偶尔的在线观影，还是需要一种便捷的多设备内容获取方案，这个工具都能有效降低技术门槛，提升使用体验。对于已经熟悉NAS和Docker生态的用户来说，这无疑是一个值得纳入工具箱的实用型应用。