影音与下载

MeTube:用网页管理视频下载任务

  • 0 次阅读
  • 0 条评论
文章摘要

MeTube 为 yt-dlp 提供网页入口,用来管理自己有权保存的视频与音频任务。支持站点随 yt-dlp 和平台变化,播放列表批量任务需要先估算空间。 网页负责提交任务,yt-dlp 负责解析与下载,文件保存在映射目录。站点变更可能影响旧版本解析。 适合常开 NAS 承担视频或音频保存。单链接跑通后再处理列表,提前估算空间。

项目介绍

MeTube 为 yt-dlp 提供网页入口,用来管理自己有权保存的视频与音频任务。支持站点随 yt-dlp 和平台变化,播放列表批量任务需要先估算空间。

网页负责提交任务,yt-dlp 负责解析与下载,文件保存在映射目录。站点变更可能影响旧版本解析。

适合常开 NAS 承担视频或音频保存。单链接跑通后再处理列表,提前估算空间。

核心功能

功能 作用与使用方式
链接提交 添加获准保存的内容
格式选择 核对音视频需求
队列查看 跟踪任务进度
列表任务 按范围批量处理
输出目录 检查实际文件

界面展示

MeTube 官方项目配图

图 1:官方仓库提供的项目示意图,用于说明功能与布局。

项目信息

项目 说明
类型 Docker
分类 影音与下载
项目仓库 alexta69/metube
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 创建下载目录 /volume1/downloads/metube 并给予容器运行用户写权限。按下面配置启动,访问 http://NAS_IP:8081。
  2. 粘贴一个公开测试视频链接,选择格式并观察任务日志,完成后核对文件、音轨与字幕。
  3. 需要调整 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 许可 保留来源与许可;图片只做等比例缩小和压缩。