项目介绍
MeTube 为 yt-dlp 提供网页入口,用来管理自己有权保存的视频与音频任务。支持站点随 yt-dlp 和平台变化,播放列表批量任务需要先估算空间。
网页负责提交任务,yt-dlp 负责解析与下载,文件保存在映射目录。站点变更可能影响旧版本解析。
适合常开 NAS 承担视频或音频保存。单链接跑通后再处理列表,提前估算空间。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 链接提交 | 添加获准保存的内容 |
| 格式选择 | 核对音视频需求 |
| 队列查看 | 跟踪任务进度 |
| 列表任务 | 按范围批量处理 |
| 输出目录 | 检查实际文件 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 影音与下载 |
| 项目仓库 | alexta69/metube |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 创建下载目录
/volume1/downloads/metube并给予容器运行用户写权限。按下面配置启动,访问http://NAS_IP:8081。 - 粘贴一个公开测试视频链接,选择格式并观察任务日志,完成后核对文件、音轨与字幕。
- 需要调整 yt-dlp 参数时参照项目文档设置,不直接复制陌生账号 Cookie。批量列表先小规模测试并限制任务量。
首次使用与操作检查
下载一条测试视频,播放并检查音轨字幕,再测试小列表。
失败先看日志和 yt-dlp 版本。Cookie 只使用自己的必要会话,文件写入失败核对权限。
Docker Compose
依据官方 README 的 Compose 整理,下载目录改为群晖示例路径。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/metube/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/metube /volume1/downloads/metube
cd /volume1/docker/metube
HALO_PREPARE
cd /volume1/docker/metube
services:
metube:
image: ghcr.io/alexta69/metube:latest
restart: unless-stopped
ports:
- "8081:8081"
volumes:
- /volume1/downloads/metube:/downloads
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 网页可访问但任务失败时,分别检查上游支持、网络与下载目录权限。
- 界面不应无认证暴露公网,避免被其他人提交大量任务。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
下载文件独立备份,保存 Compose 和自定义选项,登录凭据不进入可公开配置。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 alexta69/metube 官方仓库,按 AGPL 许可 保留来源与许可;图片只做等比例缩小和压缩。