yt-dlp-web-ui：基于yt-dlp的网页用户界面

发表于 更新于 分类于 Waline： 阅读次数： 本文字数： 2.5k 阅读时长 ≈ 2 分钟
yt-dlp-web-ui 是一个为 yt-dlp 提供网页用户界面的开源项目。

本文软件由网友 John Doe 推荐，只是写完又忘发了；

简介

什么是 yt-dlp ？

yt-dlp 是一个功能丰富的命令行音频/视频下载工具，支持从数千个网站下载内容。它是 youtube-dl 的一个分支，基于已不再活跃的 youtube-dlc 开发。yt-dlp 提供了许多高级功能和选项，使用户能够控制下载过程，并支持多种输出格式和后处理选项。该工具适合需要批量下载或处理在线媒体的用户。

什么是 yt-dlp-web-ui ？

yt-dlp-web-ui 是一个为 yt-dlp 提供网页用户界面的开源项目。yt-dlp-web-ui 的目标是通过直观的网页界面简化 yt-dlp 的使用，让用户无需命令行即可轻松下载视频、音频和其他媒体文件。

项目特点

  • 易用性：通过简单的网页界面配置和启动下载任务。
  • 支持多种格式：视频、音频、字幕等多种格式下载。
  • 任务队列：支持多个下载任务排队处理。
  • 多语言支持：支持多种语言，方便不同地区用户使用。
  • 自定义配置：允许用户自定义下载选项，如视频质量、格式等。
  • 跨平台支持：可在任何支持 Docker 的平台上运行。

应用场合

  • 希望从 YouTube 或其他支持的网站下载视频、音频等媒体内容的用户。
  • 不想通过命令行操作 yt-dlp 的用户。
  • 需要批量下载或管理下载任务的用户。
  • 希望在 Docker 环境中快速部署和使用 yt-dlp 的工具。

从功能上来说，yt-dlp-web-ui 和老苏之前介绍的 yt-dlp-web 是差不多的，底层都是基于 yt-dlp，所区别的只在界面上

文章传送门：带Web界面的yt-dlp视频下载器

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 marcobaobao ，选择第一个 marcobaobao/yt-dlp-webui，版本选择 latest。

本文写作时， latest 版本对应的软件版本为 UI v3.2.5 和 yt-dlp v2025.01.26；

卷

在 docker 文件夹中，创建一个新文件夹 yt-dlp-webui，并在其中建两个子文件夹 config 和 downloads

文件夹 装载路径 说明
docker/yt-dlp-webui/config /config 存放数据库等
docker/yt-dlp-webui/downloads /downloads 存放下载文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
3022 3033

命令行安装

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 新建文件夹 yt-dlp-webui 和 子目录
mkdir -p /volume1/docker/yt-dlp-webui/{downloads,config}

# 进入 yt-dlp-webui 目录
cd /volume1/docker/yt-dlp-webui

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name yt-dlp-webui \
   -p 3022:3033 \
   -v $(pwd)/downloads:/downloads \
   -v $(pwd)/config:/config \
   marcobaobao/yt-dlp-webui

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
version: '3'

services:
  yt-dlp-webui:
    image: marcobaobao/yt-dlp-webui
    container_name: yt-dlp-webui
    restart: unless-stopped
    ports:
      - 3022:3033
    volumes:
      - ./downloads:/downloads
      - ./config:/config
    healthcheck:
      test: curl -f http://localhost:3033 || exit 1

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 yt-dlp-webui 和 子目录
mkdir -p /volume1/docker/yt-dlp-webui/{downloads,config}

# 进入 yt-dlp-webui 目录
cd /volume1/docker/yt-dlp-webui

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:3022 就能看到主界面

中文

在设置界面，找到 Language

下拉找到 Chinese，自动会切换为中文

下载

测试了一个老苏上传到 B 站的视频，地址：https://www.bilibili.com/video/BV13TNcedEqD

不知道为什么没有生成缩率图

归档里能看到文件

又试了一个微博的视频，地址： https://weibo.com/tv/show/1034:5133045703835668?from=old_pc_videoshow

不仅没有封面，连文件大小都没有，不过在归档里是有的

播放没问题，文件保存在 downloads 目录中

支持的站点

经常有网友问这类下载软件支持哪些站点，其实这取决于底层依赖的 yt-dlp ，而跟它使用什么样的 UI 无关

可以执行 docker exec yt-dlp-webui yt-dlp --list-extractors ，会列出大约 2000 个站点，但微信视频号应该是不行的

参考文档

marcopeocchi/yt-dlp-web-ui: A terrible web ui for yt-dlp 🙄 Aimed to be self-hosted
地址：https://github.com/marcopeocchi/yt-dlp-web-ui

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