YT-DLP Web Player 开源在线视频播放器部署指南

卷

在 docker 文件夹中，创建一个新文件夹 ytdlp_web_player，并在其中建一个子文件夹 download

端口

配置本地端口为 5038（确保无冲突）。

# 查看端口占用
netstat -tunlp | grep 5038

环境

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷。

# 新建文件夹 ytdlp_web_player 和 子目录
mkdir -p /volume1/docker/ytdlp_web_player/data
# 进入 ytdlp_web_player 目录
cd /volume1/docker/ytdlp_web_player
# 一键启动
docker run -d \
--name ytdlp_web_player \
--restart unless-stopped \
-p 5038:5000 \
-v $(pwd)/data:/app/download \
-e APP_TITLE="YT-DLP Player" \
-e THEME_COLOR="#ff7300" \
-e GENERATE_SPRITE_BELOW="1800" \
-e AMOLED_BG="false" \
-e MAX_VIDEO_AGE="3600" \
-e MAX_VIDEO_DURATION="36000" \
-e DEFAULT_QUALITY="720" \
-e LOAD_DEFAULT_QUALITY="true" \
-e PLAYLIST_SUPPORT="false" \
-e DOWNLOAD_PATH="./download" \
matszwe02/ytdlp_web_player

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件。

version: '3.8'
services:
  ytdlp_web_player:
    image: matszwe02/ytdlp_web_player
    container_name: ytdlp_web_player
    restart: unless-stopped
    ports:
      - "5038:5000"
    volumes:
      - ./data:/app/download
    environment:
      - APP_TITLE=YT-DLP Player
      - THEME_COLOR=#ff7300
      - GENERATE_SPRITE_BELOW=1800
      - AMOLED_BG=false
      - MAX_VIDEO_AGE=3600
      - MAX_VIDEO_DURATION=36000
      - DEFAULT_QUALITY=720
      - LOAD_DEFAULT_QUALITY=true
      - PLAYLIST_SUPPORT=false
      - DOWNLOAD_PATH=./download

然后通过 SSH 登录到您的群晖，执行下面的命令：

# 新建文件夹 ytdlp_web_player 和 子目录
mkdir -p /volume1/docker/ytdlp_web_player/data
# 进入 ytdlp_web_player 目录
cd /volume1/docker/ytdlp_web_player
# 将 docker-compose.yml 放入当前目录
# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<IP>:5038 即可进入 Web 界面。

例如输入 Bilibili 视频链接，加载中会看到界面预览。

加载成功后，就可以播放了。

注意事项

1. PWA 和 iframe 嵌入需要 HTTPS：如需使用 PWA 安装或 iframe 嵌入功能，需要配置反向代理启用 HTTPS
2. 视频平台限制：部分视频网站有反爬虫机制，可能无法正常播放，可查看 yt-dlp 支持的网站列表
3. 存储空间：视频缓存会占用磁盘空间，建议定期清理或调整 MAX_VIDEO_AGE 参数
4. 网络要求：播放高清视频需要较好的网络带宽，建议根据网络情况调整 DEFAULT_QUALITY
5. 安全建议：如公网访问，建议添加认证机制或限制访问 IP

参考文档

Matszwe02/ytdlp_web_player: Arbitraty internet video player powered by yt-dlp
地址：https://github.com/Matszwe02/ytdlp_web_player

yt-dlp/yt-dlp: A feature-rich command-line audio/video downloader
地址：https://github.com/yt-dlp/yt-dlp