MeTube：开源视频下载平台的终极指南

探索如何搭建自己的开源视频下载平台，MeTube为您提供了一站式解决方案。作为视频分享网站的自托管方案，这个项目让您能够轻松获取来自多个网站的视频内容。无论您是新手还是普通用户，都能快速上手这个功能强大的开源视频平台。

【免费下载链接】metube Self-hosted YouTube downloader (web UI for youtube-dl / yt-dlp) 项目地址: https://gitcode.com/GitHub_Trending/me/metube

一键部署教程

MeTube支持多种部署方式，最简单的就是使用Docker：

Docker快速启动

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

docker-compose配置

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

功能模块详解

核心下载引擎

• 下载工具支持：基于强大的下载引擎，支持多个视频网站
• 播放列表下载：完整支持播放列表批量下载功能
• 多格式选择：提供最佳质量、iOS兼容等多种下载选项

界面设计特点

• 现代化UI：采用Angular框架构建的响应式界面
• 实时进度显示：下载队列和进度一目了然
• 自定义主题：支持明暗主题自动切换

高级配置选项

• 下载模式控制：支持顺序下载、并发下载和限制并发数
• 文件命名模板：自定义下载文件的命名规则
• 目录管理：灵活的下载目录配置和自定义文件夹创建

环境变量配置指南

下载行为设置

• DOWNLOAD_MODE：控制下载调度模式（sequential、concurrent、limited）
• MAX_CONCURRENT_DOWNLOADS：限制同时下载的数量
• DEFAULT_OPTION_PLAYLIST_STRICT_MODE：严格播放列表模式开关

存储目录配置

• DOWNLOAD_DIR：视频下载存储路径
• AUDIO_DOWNLOAD_DIR：纯音频文件存储路径
• CUSTOM_DIRS：启用自定义目录下载功能

浏览器扩展集成

MeTube提供丰富的浏览器扩展支持，让您能够：

• Chrome扩展：右键直接发送视频到MeTube
• Firefox插件：便捷的视频下载管理
• iOS快捷指令：Safari浏览器快速分享

反向代理配置

NGINX配置示例

location /metube/ {
    proxy_pass http://metube:8081;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

Apache配置 支持在子目录下部署MeTube，满足不同服务器环境需求。

本地开发与构建

如果您希望进行二次开发或本地构建：

前端构建

cd ui
npm install
node_modules/.bin/ng build

后端运行

uv sync
uv run python3 app/main.py

项目采用现代技术栈：

• 前端：Angular框架
• 后端：Python 3.13+
• 依赖管理：使用uv工具进行包管理

常见问题解决

下载失败排查

• 首先使用下载命令行工具测试下载
• 检查网络连接和视频链接有效性
• 验证下载工具版本是否为最新

权限问题处理

• 确保下载目录具有写入权限
• 检查Docker容器的用户权限设置

MeTube作为一个开源视频下载平台，不仅提供了强大的下载功能，还拥有活跃的社区支持和持续更新。无论您是想搭建个人视频下载服务，还是学习现代Web应用开发，这个项目都是绝佳的选择。

【免费下载链接】metube Self-hosted YouTube downloader (web UI for youtube-dl / yt-dlp) 项目地址: https://gitcode.com/GitHub_Trending/me/metube