基于 yt-dlp 的开源 Web 视频播放器部署指南

启动方式

命令行启动 (Docker CLI)

熟悉命令行的用户可以直接执行以下命令一键启动：

mkdir -p /volume1/docker/ytdlp_web_player/data
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 登录服务器后，进入该目录执行：

docker-compose up -d

使用体验

启动成功后，在浏览器访问 http://<IP>:5038 即可进入界面。

粘贴任意视频链接（如 Bilibili 或 YouTube 视频），系统会自动解析并加载预览。确认无误后即可开始播放。界面简洁流畅，支持全屏及倍速调节。

注意事项

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

参考资料

• Matszwe02/ytdlp_web_player
• yt-dlp/yt-dlp