MeTube

5天前发布 4 00

MeTube 将 yt-dlp 的强大能力封装为简洁的 Web 界面，在保持高度可配置的同时，大幅降低使用门槛。无论是下载单个视频，还是管理数百项播放列表任务，它都提供了一套稳定、可控、可持久化的解决方案。

所在地：

美国

收录时间：

2025-12-02

打开网站手机查看

下载服务 # MeTube # yt-dlp

MeTube

打开网站

MeTube 是一个开源的 Web 图形界面，基于强大的 yt-dlp（youtube-dl 的活跃分支），支持从 YouTube 及数十个其他视频网站下载视频或音频，并原生支持播放列表批量下载。所有操作通过浏览器完成，无需命令行。

项目采用容器化设计，推荐通过 Docker 或 docker-compose 部署，配置灵活，适合个人媒体库搭建或轻量级下载服务。

快速启动

使用 Docker

docker run -d \
  -p 8081:8081 \
  -v /your/download/path:/downloads \
  ghcr.io/alexta69/metube

使用 docker-compose

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

访问 http://localhost:8081 即可使用。

核心配置（通过环境变量）

所有配置项均可通过 Docker 的 -e 参数或 docker-compose.yml 中的 environment 字段设置。

▶ 下载行为控制

变量	说明	默认值
`DOWNLOAD_MODE`	下载调度模式： • `sequential`：串行 • `concurrent`：完全并发 • `limited`：限并发	`limited`
`MAX_CONCURRENT_DOWNLOADS`	限并发模式下的最大同时下载数	`3`
`DELETE_FILE_ON_TRASHCAN`	勾选“删除”时是否物理删除文件	`false`
`DEFAULT_OPTION_PLAYLIST_STRICT_MODE`	严格播放列表模式（仅识别明确播放列表 URL）	`false`
`DEFAULT_OPTION_PLAYLIST_ITEM_LIMIT`	播放列表最大下载条目数（0 = 无限制）	`0`

▶ 存储与目录管理

变量	说明	默认值
`DOWNLOAD_DIR`	视频下载目录	`/downloads`（Docker 内）
`AUDIO_DOWNLOAD_DIR`	音频下载目录（若未设，使用 `DOWNLOAD_DIR`）	同上
`CUSTOM_DIRS`	允许选择自定义子目录	`true`
`CREATE_CUSTOM_DIRS`	允许自动创建新目录	`true`
`CUSTOM_DIRS_EXCLUDE_REGEX`	排除某些目录（如隐藏目录）	`(^
`DOWNLOAD_DIRS_INDEXABLE`	是否允许 Web 目录浏览	`false`
`STATE_DIR`	任务队列持久化路径	`/downloads/.metube`
`TEMP_DIR`	临时文件目录（建议 SSD 或 `tmpfs`）	`/downloads`

⚠️ 注意：若使用 tmpfs 作 TEMP_DIR，下载任务中断后无法续传。

▶ 文件命名与 yt-dlp 集成

变量	说明	默认值
`OUTPUT_TEMPLATE`	单视频文件名模板（支持 yt-dlp 语法）	`%(title)s.%(ext)s`
`OUTPUT_TEMPLATE_PLAYLIST`	播放列表模板（留空则用上者）	`%(playlist_title)s/%(title)s.%(ext)s`
`OUTPUT_TEMPLATE_CHAPTER`	按章节拆分时的模板	`%(title)s - %(section_number)s %(section_title)s.%(ext)s`
`YTDL_OPTIONS`	以 JSON 格式传给 yt-dlp 的额外参数	—
`YTDL_OPTIONS_FILE`	从文件加载 yt-dlp 配置（支持热重载）	—

示例：YTDL_OPTIONS='{"format": "bestvideo+bestaudio", "postprocessors": [{"key": "FFmpegMerger"}]}'

▶ Web 服务与安全

变量	说明
`URL_PREFIX`	反向代理路径前缀（如 `/metube`）
`PUBLIC_HOST_URL`	公开访问的下载链接基础 URL
`HTTPS`、`CERTFILE`、`KEYFILE`	启用 HTTPS 所需配置
`ROBOTS_TXT`	自定义 `robots.txt` 路径
`ENABLE_ACCESSLOG`	是否记录 HTTP 访问日志

▶ 系统与界面

变量	说明	默认值
`UID` / `GID`	运行用户/组 ID	`1000`
`UMASK`	文件创建权限掩码	`022`
`DEFAULT_THEME`	界面主题（`light`/`dark`/`auto`）	`auto`
`LOGLEVEL`	日志级别	`INFO`

典型使用场景

个人视频归档：批量下载 YouTube 播放列表到 NAS；
离线学习库：保存教学视频，按课程自动分目录；
音频提取：仅下载音频并保存至独立文件夹；
家庭媒体中心：配合 Plex/Jellyfin，自动入库。

数据统计

暂无评论

暂无评论...

MeTube