十分钟搭建一个带Web界面的yt-dlp视频下载器｜好玩儿的Docker项目

本博客用什么VPS？创作不易，欢迎请咕咕喝杯咖啡☕☕☕

1. 唠嗑

yt-dlp 是一款基于 youtube-dl 开发的开源命令行视频下载工具，支持从 1000+ 个平台获取内容。它不仅能下载 YouTube 视频，还支持包括 B站、网易云音乐、Vimeo、Twitter 等主流平台。

2. ytdlpwebui主要功能

这是一个基于 yt-dlp 的自托管 Web UI 和 RPC 服务项目，专为 NAS 和服务器环境设计。项目通过 Docker 容器提供轻量级部署（镜像体积仅 18MB），支持以下核心功能：

多平台视频下载：支持 YouTube、B站等 1000+ 平台的视频/音频下载，可自动选择最高画质或手动指定格式
任务队列管理：通过 --qs 参数控制并发下载数量（默认 2 个并行任务）
远程控制接口：提供 JSON-RPC 1.0 API 和 WebSocket 实时状态推送，支持 JWT 认证（需配置 --auth 参数）
定制化前端：允许替换默认 Material 风格界面，自定义前端只需符合指定目录结构即可加载
系统集成：提供 Docker Compose 部署模板和 Systemd 服务配置方案，支持 SQLite 数据库存储任务记录

典型应用场景包括 NAS 媒体库自动归档、直播流监控等，项目通过 --driver 参数可指定不同版本的 yt-dlp 执行文件，最新版本已适配 2025 年 YouTube 的 HDR10+ 格式下载需求。

3. 相关地址

官方GitHub地址：https://github.com/marcopiovanello/yt-dlp-web-ui (全新项目，目前1.1个star，欢迎大家去给项目点星星！）

4. 搭建环境

服务器：这边强烈建议用非大陆的服务器，不然很多网站访问不了，咕咕这边用的香港的腾讯云轻量应用服务器，建议服务器内存1G以上，当然你也可以选择其他高性价比的服务器。
系统：Debian 11 （DD 脚本非必需 DD，用原来的系统也 OK，之后教程都是用 Debian 或者 Ubuntu 搭建～）
安装好 Docker、Docker-compose（相关脚本）
【必需】域名一枚，并做好解析到服务器上（域名购买、域名解析视频教程）
【非必需】提前安装好宝塔面板海外版本 aapanel，并安装好 Nginx（安装地址）
【非必需本教程选用】安装好 Nginx Proxy Manager（相关教程）

5. 搭建视频（过俩天补充 = =）

5.1 YouTube

视频地址：

5.2 哔哩哔哩

哔哩哔哩：

6. 搭建方式

6.1 安装 Docker 与 Nginx Proxy Manager

可以直接参考这篇内容：

https://blog.laoda.de/archives/nginxproxymanager/

6.2 创建安装目录

创建一下安装的目录：

sudo -i

mkdir -p /root/data/docker_data/ytdlpwebui

cd /root/data/docker_data/ytdlpwebui

mkdir config

cd config

vim config.yml

这边我们用最简单的认证方式（更多认证方式，可以参考官方的wiki），粘贴填入这些内容，其中your_username改成你自己的登录名字，your_password改成你的密码。

require_auth: true
username: your_username
password: your_password

完成之后，按一下 esc，然后 :wq 保存退出。

接着我们来编辑下docker-compose.yml

cd ..
vim docker-compose.yml

services:
  yt-dlp-webui:
    image: marcobaobao/yt-dlp-webui
    ports:
      - 3035:3033
    volumes:
      - ./downloads:/downloads # replace <your dir> with a directory on your host system
      - ./config:/config    # directory where config.yml will be stored
    healthcheck:
      test: curl -f http://localhost:3033 || exit 1
    restart: unless-stopped

其中的3035可以改成服务器上没有用过的端口，记得修改自己的用户名和密码，修改完成之后，可以在英文输入法下，按 i 修改，完成之后，按一下 esc，然后 :wq 保存退出。

6.3 查看端口是否被占用

查看端口是否被占用（以 3035 为例），输入：

lsof -i:3035  #查看 3035 端口是否被占用，如果被占用，重新自定义一个端口

如果啥也没出现，表示端口未被占用，我们可以继续下面的操作了～

如果出现：

-bash: lsof: command not found

运行：

apt install lsof  #安装 lsof

如果端口没有被占用（被占用了就修改一下端口，比如改成 8381，注意 docker 命令行里和防火墙都要改）

6.4 启动 ytdlpwebui

cd /root/data/docker_data/ytdlpwebui

docker compose up -d   # 注意，老版本用户用 docker-compose up -d

耐心等待拉取好镜像，出现 done的字样之后，

理论上我们就可以输入 http://ip:3035 访问了。

但是这边这个服务必须先搞一下反向代理！http使用明文传输太危险，我们部署在公网一定要考虑使用反向代理工具配置SSL！

做反向代理前，你需要一个域名！

namesilo 上面 xyz 后缀的域名一年就 7 块钱，可以年抛。（冷知识，namesilo上 6位数字的xyz续费永远都是0.99美元 = =）

如果想要长期使用，还是建议买 com 后缀的域名，更加正规一些，可以输入 gugugu 来获得 1 美元的优惠（不知道现在还有没有）

namesilo 自带隐私保护，咕咕一直在用这家，价格也是这些注册商里面比较低的，关键是他家不像其他家域名注册商，没有七七八八的套路！（就是后台界面有些丑古老 = =）

【域名购买】Namesilo 优惠码和域名解析教程（附带服务器购买推荐和注意事项）

我们接着往下看！

7. 反向代理

7.1 利用 Nginx Proxy Manager

在添加反向代理之前，确保你已经完成了域名解析，不会的可以看这个：域名一枚，并做好解析到服务器上（域名购买、域名解析视频教程）（名称改成你自己想要的域名前缀即可）

之后，登陆 Nginx Proxy Manager（不会的看这个：安装 Nginx Proxy Manager（相关教程））

注意：

Nginx Proxy Manager（以下简称 NPM）会用到 80、443 端口，所以本机不能占用（比如原来就有 Nginx）

直接丢几张图：

注意填写对应的 域名、IP 和 端口，按文章来的话，应该是 3035

IP 填写：

如果 Nginx Proxy Manager 和 ytdlpwebui 在同一台服务器上，可以在终端输入：

ip addr show docker0

查看对应的 Docker 容器内部 IP。

否则直接填 ytdlpwebui 所在的服务器 IP 就行。

7.2 利用宝塔面板

发现还是有不少小伙伴习惯用宝塔面板，这边也贴一个宝塔面板的反代配置：

直接新建一个站点，不要数据库，不要 php，纯静态即可。

然后打开下面的配置，修改 Nginx 的配置。

代码如下：

location / {
      proxy_pass http://127.0.0.1:3035/;       # 注意改成你实际使用的端口
      rewrite ^/(.*)$ /$1 break;
      proxy_redirect off;
      proxy_set_header Host $host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Upgrade-Insecure-Requests 1;
      proxy_set_header X-Forwarded-Proto https;
    }

此方法对 90% 的反向代理都能生效，然后就可以用域名来安装访问了。

有同学可能会问，为什么不直接用宝塔自带的反向代理功能。

也可以，不过咕咕自己之前遇到过当有多个网站需要反代的时候，在这边设置会报错的情况 = =

所以后来就不用了，直接用上面的方法来操作了。

8. 使用教程

8.1 下载视频

见视频或者自己琢磨一下，很简单。

输入网址之后，提示需要登录才可以使用，输入我们前面设置的账号密码

首页是这个样子，

设置部分，支持把语言改成中文的，

选一个YouTube视频，可以尝试下载，

下载成功之后，可以选择点击观看或者下载到本地观看了。

8.2 更新 ytdlpwebui

这个项目后续应该也会有更新，所以提供一个更新的方式。

cd /root/data/docker_data/ytdlpwebui

docker compose pull

docker compose up -d    # 请不要使用 docker compose stop 来停止容器，因为这么做需要额外的时间等待容器停止；docker compose up -d 直接升级容器时会自动停止并立刻重建新的容器，完全没有必要浪费那些时间。

docker image prune  # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

提示：

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]

输入 y

利用 Docker 搭建的应用，更新非常容易～

8.3 卸载 ytdlpwebui

同样进入安装页面，先停止所有容器。

cd /root/data/docker_data/ytdlpwebui

docker compose down

cd ..

rm -rf /root/data/docker_data/ytdlpwebui  # 完全删除

可以卸载得很干净。

9. 常见问题及注意点

目前发现推特和哔哩哔哩的视频下载完成之后会显示0B，

大家有问题欢迎评论区交流。

10. 结尾

祝大家用得开心，有问题可以去 GitHub 提 Issues，也可以在评论区互相交流探讨。

同时，有能力给项目做贡献的同学，也欢迎积极加入到项目中来，贡献自己的一份力量！

最后，感谢开发人员们的辛苦付出，让我们能用到这么优秀的项目！

参考资料

官方GitHub：https://github.com/marcopiovanello/yt-dlp-web-ui

---------------
如何觉得文章内容不错，欢迎点击一下广告，支持一下咕咕😍😍😍

原创文章，作者：Roy，如若转载，请注明出处：https://iwanlab.com/docker-compose-install-yt-dlp-web-ui/