视频下载神器MeTube！Docker部署保姆级教程，一看就会

Metube 是一款基于 yt-dlp 内核的开源自托管视频下载工具，以简洁的网页图形界面消除了命令行操作门槛，支持从 YouTube 及上百个主流视频平台下载视频与音频。它不仅能一键下载单个资源，还可批量抓取整个播放列表，用户可自由选择不同分辨率和格式（含纯音频选项），同时支持字幕、封面等元数据下载，配合 Docker 可快速部署在 NAS、树莓派等设备上，实现家庭网络内的集中化、全天候下载管理，让普通用户也能轻松构建个人媒体库，安全高效地保存在线优质内容。

img

功能特点：

多平台兼容：支持 YouTube、B 站、抖音、Twitter 等数百个主流视频 / 音频平台，覆盖常见下载场景
可视化操作：提供直观 Web 界面，无需命令行，可直接粘贴链接发起下载，支持批量添加任务、批量下载
灵活格式选择：可自定义选择音视频格式（MP4、MKV、MP3 等）、分辨率（从标清到 4K/8K）、比特率，满足不同需求
播放列表 / 合集下载：支持一键下载 YouTube 等平台的整个播放列表、频道合集，自动按顺序整理文件
基于 Docker 容器化部署，镜像体积小，配置简单，支持本地搭建或私有服务器部署，保护下载隐私
无广告无捆绑：开源免费，无内置广告，不强制捆绑软件，可自由扩展功能（基于源码二次开发）
支持浏览器扩展，Chrome、Firefox、Edge，浏览器扩展允许您右键点击视频并直接发送到 MeTube

MeTube 中实际负责视频下载的引擎是 yt-dlp，支持的视频网站可参考yt-dlp

img

Docker安装部署Metube

1、创建本地持久化目录

mkdir -p /opt/metube/downloads

2、Docker命令安装

下载镜像

docker pull ghcr.io/alexta69/metube:latest

Docker命令行启动：

docker run -d -p 8081:8081 -v /opt/metube/downloads:/downloads ghcr.io/alexta69/metube

3、Docker Compose方式安装

services: metube: image: ghcr.io/alexta69/metube container_name: metube restart: unless-stopped ports: - "8081:8081" volumes: - /opt/metube/downloads:/downloads

Metube使用

1、下载视频

过滤广告：

metube允许通过YTDL_OPTIONS环境变量传递自定义参数给yt-dlp。要启用广告过滤，需配置SponsorBlock相关参数：

Docker 添加环境变量： -e "YTDL_OPTIONS={"sponsorblock_remove": ["all"], "postprocessors": [{"key": "SponsorBlock"}]}"

在MeTube主界面，点击"Advanced Options"展开高级设置面板。关键配置项包括：

Quality：选择视频质量，字幕下载不受此选项影响
Format：建议选择"mp4"格式以获得最佳字幕兼容性
Auto Start：设置Yes，则添加URL后自动开始下载

img

2、参数设置

可以通过环境变量设置某些值，可在 docker 命令行上使用 -e 参数，或在 docker-compose 中的 environment: 部分进行配置。

1）下载行为设置：

DOWNLOAD_MODE：此标志控制下载的调度和执行方式。选项包括 sequential（顺序）、concurrent（并发）和 limited（限制并发）。默认为 limited：
sequential：下载将逐个处理。只有前一个下载完成后，新的下载才会开始。此模式有助于节省系统资源或确保下载严格按顺序进行
concurrent：下载在添加后立即开始，对同时运行的下载数量没有内置限制。如果同时启动过多下载，此模式可能会使系统不堪重负
limited：下载并发启动，但受并发限制的约束。在此模式下，使用信号量控制，因此在任何给定时间最多运行固定数量的下载
MAX_CONCURRENT_DOWNLOADS：此标志仅在 DOWNLOAD_MODE 设置为 limited 时使用。它指定允许的最大同时下载数。例如，如果设置为 5，则最多将有五个下载并发运行，任何额外的下载将等待，直到某个活动下载完成。默认为 3
DELETE_FILE_ON_TRASHCAN：如果为 true，当从 UI 的“已完成”部分将下载文件放入回收站时，服务器上的下载文件将被删除。默认为 false
DEFAULT_OPTION_PLAYLIST_STRICT_MODE：如果为 true，“严格播放列表模式”开关将默认启用。在此模式下，仅当 URL 严格指向播放列表时才会下载播放列表。指向播放列表中视频的 URL 将被视为与直接视频 URL 相同。默认为 false
DEFAULT_OPTION_PLAYLIST_ITEM_LIMIT：可下载的播放列表项目最大数量。默认为 0（无限制）