🔥 BRAVE 質押池已上線 — 在錢包搜尋 BRAVE 即可委託
简体

Brave基地

MeTube：一款支持HomeLab自托管的YouTube下载器

    • 2024 年 3 月 7 日 下午 2:24 #21684
      Brave

      在数字内容消费时代，视频和音频资源的离线保存需求日益增长。本文将深入介绍 MeTube——一款功能强大的自托管流媒体下载工具，帮助你在 HomeLab 环境中构建属于自己的媒体下载服务。

      一、为什么你需要 MeTube

      1.1 YouTube 的价值与局限

      YouTube 是世界上最大的视频分享平台，它拥有海量的视频和音乐资源，涵盖了各种类型和风格，满足了不同用户的需求和喜好。然而，YouTube 也有一些不便之处：

      问题类型具体表现
      🔒 版权限制部分视频因版权问题无法在特定地区播放
      🌍 地区限制某些内容仅对特定国家/地区的用户开放
      📢 广告插播非会员用户需要观看大量广告
      📶 网络波动在线观看依赖稳定的网络连接
      ❌ 内容下架优质内容可能随时被删除或设为私密，一旦下架便无法再次访问

      这些问题都会影响用户的观看体验和效率。

      1.2 离线保存的实际需求

      有时候，用户可能想要将 YouTube 上的视频和音乐下载到本地，以便于：

      • 📴 离线观看：在没有网络的环境下（如飞机、地铁）享受内容
      • 💾 个人收藏：保存珍贵的教程、演讲或稀有内容
      • 🔄 内容转发：分享给没有 YouTube 访问权限的朋友
      • ✂️ 二次编辑：用于学习笔记、视频剪辑等创作用途
      • 🛡️ 内容备份：防止喜爱的视频因版权争议、创作者删除或平台政策变化而永久丢失

      但 YouTube 并不提供官方的下载功能，这就需要用户寻找其他的解决方案。

      1.3 MeTube 的解决方案

      MeTube 就是一款可以帮助用户下载 YouTube 视频和音乐的工具。它是由开发者 alexta69 创建的开源项目，基于 yt-dlp 这个强大的命令行工具提供了友好的网页界面，可以让用户自主搭建一个 YouTube 下载器，享受更多的自由和便利。

      💡 什么是 yt-dlp？

      yt-dlp 是 youtube-dl 的一个活跃维护的分支（fork），于 2021 年启动。截至 2025 年，yt-dlp 在 GitHub 上已获得超过 130,000 颗星标，拥有活跃的 Discord 和 Reddit 社区。相比原版 youtube-dl，yt-dlp 具有以下显著优势：

      特性youtube-dlyt-dlp
      下载速度单线程，有时仅 80kbps多线程并行下载，可达满速
      更新频率更新缓慢频繁更新，快速适应网站变化
      格式选择基于比特率，可能选择低分辨率智能选择最高质量，支持 VP9/AV1
      额外功能需要额外步骤添加字幕/缩略图内置章节分割、字幕嵌入等
      社区支持开发停滞已被 Debian 12 和 Ubuntu 22.04 采用为默认

      正因为 yt-dlp 的这些优势，MeTube 选择以 yt-dlp 作为其核心下载引擎，确保用户获得最佳的下载体验。

      二、MeTube 支持 HomeLab 部署

      2.1 什么是 HomeLab？

      HomeLab（家庭实验室）是指在家中搭建的个人服务器环境，用于学习、实验和运行各种自托管服务。通过 HomeLab，你可以：

      • 🔐 完全掌控自己的数据和隐私
      • 🎓 学习服务器管理、网络配置等技能
      • 💰 避免订阅云服务的长期费用
      • 🛠️ 根据个人需求定制服务功能

      MeTube 支持在 HomeLab 中部署，你可以选择多种方式来搭建，包括使用 Umbrel、Docker 或 Docker Compose 等。

      2.2 使用 Umbrel 部署（推荐新手）

      你可以使用 Umbrel 作为 HomeLab 的底层系统。Umbrel 是一个美观易用的家庭服务器操作系统，提供一键式应用安装体验。

      📋 Umbrel 安装前提条件：

      根据你的硬件选择合适的安装方式：

      平台最低配置要求
      Raspberry Pi 54GB RAM，750GB+ 存储空间
      x86 系统双核 64 位处理器（推荐四核）、4GB RAM（推荐 8GB+）、32GB 存储
      Linux 虚拟机与 x86 系统相同

      🔧 在 Umbrel 中安装 MeTube：

      1. 首先按照 Umbrel 官方指南 安装 Umbrel 系统
      2. 在浏览器中访问 http://umbrel.local 进入 Umbrel 界面
      3. 在 Umbrel 的应用商店中搜索 “MeTube”
      4. 点击安装按钮

      安装过程可能需要几分钟，安装完成后，你就可以在 Umbrel 的网页界面中访问 MeTube 了。

      📊 Umbrel 版 MeTube 当前版本信息（截至 2025 年 12 月）：

      版本号更新内容
      2025.12.14升级 yt-dlp 至 2025.12.8 版本，切换至维护更好的 Watchtower 分支
      2025.12.09升级至 Angular 20 前端框架，修复 GitHub 登录问题

      2.3 使用 Docker 部署（推荐进阶用户）

      对于熟悉 Docker 的用户，可以使用以下命令快速部署 MeTube：

      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
    environment:
      - UID=1000
      - GID=1000
      - MAX_CONCURRENT_DOWNLOADS=3
      - DEFAULT_THEME=auto

      ⚙️ 主要环境变量说明：

      变量名说明默认值
      UID / GID运行 MeTube 的用户/组 ID1000
      MAX_CONCURRENT_DOWNLOADS最大同时下载数3
      DEFAULT_THEME界面主题（light/dark/auto）auto
      DOWNLOAD_DIR下载保存路径/downloads
      AUDIO_DOWNLOAD_DIR音频单独保存路径同 DOWNLOAD_DIR
      DELETE_FILE_ON_TRASHCAN从界面删除时是否同时删除文件false
      TEMP_DIR临时文件路径（建议设为 SSD）/downloads

      🔒 HTTPS 配置示例：

      services:
  metube:
    image: ghcr.io/alexta69/metube
    container_name: metube
    restart: unless-stopped
    ports:
      - "8081:8081"
    volumes:
      - /path/to/downloads:/downloads
      - /path/to/ssl/crt:/ssl/crt.pem
      - /path/to/ssl/key:/ssl/key.pem
    environment:
      - HTTPS=true
      - CERTFILE=/ssl/crt.pem
      - KEYFILE=/ssl/key.pem

      🔄 保持 MeTube 更新：

      MeTube 项目提供自动化的每夜构建（nightly build），会自动检查 yt-dlp 的新版本并更新 Docker 镜像。建议安装 Watchtower 来自动更新你的 MeTube 容器，确保始终支持最新的网站变化。

      三、MeTube 的使用方法

      3.1 基本操作流程

      MeTube 的使用方法很简单，你只需要在浏览器中输入 MeTube 的网址（默认为 http://你的服务器IP:8081），就可以看到一个简洁的界面。

      📥 下载步骤：

      1. 在 MeTube 的搜索框中输入视频的 URL
      2. 选择你想要的下载选项（视频格式、分辨率、是否仅下载音频等）
      3. 点击添加按钮，开始下载

      📊 管理功能：

      • 你可以在 MeTube 的下载队列中查看下载进度和状态
      • 在完成列表中查看已下载的视频
      • 在设置中调整下载参数，例如下载目录、文件名模板、代理服务器等
      • 在帮助中查看常见问题和解决方法

      3.2 浏览器扩展（提升效率）

      MeTube 提供浏览器扩展，让你可以在观看视频时一键发送下载任务：

      平台安装方式功能特点
      ChromeChrome 网上应用店 或开发者模式安装右键菜单快速发送
      FirefoxFirefox 附加组件支持快捷键（默认 Ctrl+Shift+M）、SSO 认证（Authentik、Authelia、Keycloak）、自定义请求头
      iOS SafariiCloud 快捷指令从分享菜单发送 URL

      ⚠️ 注意：如果你在 HTTPS 页面使用扩展，MeTube 实例必须配置在 HTTPS 反向代理之后才能正常工作。

      3.3 高级功能（2025-2026 新增）

      MeTube 最新版本（2026.01.01）引入了以下新功能：

      功能说明
      📑 章节分割可将长视频按章节自动分割为多个独立文件，带有 UI 控制界面
      📁 章节文件追踪自动管理分割后的章节文件
      🎨 主题切换支持亮色/暗色/自动主题
      📋 播放列表模板自定义播放列表下载的文件命名规则（OUTPUT_TEMPLATE_PLAYLIST）
      📝 章节命名模板自定义章节文件的命名规则（OUTPUT_TEMPLATE_CHAPTER）

      四、MeTube 支持多个平台的音视频下载

      4.1 支持的网站

      MeTube 支持从 YouTube 和其他数十个视频和音乐网站下载流媒体内容。得益于 yt-dlp 的强大能力，MeTube 实际上支持超过 1,800 个网站的内容提取。

      🌟 主要支持的平台包括：

      类别平台
      📺 视频平台YouTube、Vimeo、Dailymotion、Bilibili
      📱 社交媒体Facebook、Instagram、Twitter/X、TikTok、Reddit
      🎵 音乐平台SoundCloud、Bandcamp
      📡 直播平台Twitch
      💾 云存储Google Drive
      📰 新闻媒体BBC、CNN、各大新闻网站的嵌入视频

      💡 提示：完整的支持列表可在 yt-dlp 官方文档 中查看。需要注意的是，由于网站会不断更新，某些站点的支持可能会暂时失效，yt-dlp 团队会通过更新来修复这些问题。仅 YouTube 平台就有 26 个专门的提取器，分别处理普通视频、播放列表、频道、搜索结果、Shorts、直播等不同类型的内容。

      4.2 支持的格式和质量

      MeTube 支持视频和音频的多种格式和质量，用户可以根据自己的设备和需求，选择合适的格式和质量：

      类型支持的格式
      🎬 视频格式MP4、MKV、WEBM、AVI、MOV
      🎵 音频格式MP3、M4A、FLAC、OGG、WAV、OPUS
      📊 视频编码H.264、H.265/HEVC、VP9、AV1
      🔊 音频编码AAC、MP3、FLAC、Opus、Vorbis

      4.3 元数据下载

      MeTube 还支持下载视频的字幕、封面、描述等元数据，用户可以在下载选项中勾选相应的选项，就可以将这些元数据一并下载到本地。

      可下载的元数据包括：

      • 🖼️ 视频缩略图/封面图
      • 📝 视频标题和描述
      • 🏷️ 标签和分类信息
      • 👤 上传者信息
      • 📅 上传日期
      • 💬 字幕文件（支持多语言）
      • 📑 章节信息（如果视频包含章节标记）

      4.4 播放列表支持

      MeTube 还支持创建和管理播放列表，用户可以将多个视频或音乐添加到一个播放列表中，然后一次性下载整个播放列表，或者选择下载其中的某些视频或音乐，这样可以节省用户的时间和操作。

      📋 播放列表功能要点：

      • ✅ 支持批量添加整个播放列表
      • ✅ 可选择性下载列表中的特定视频
      • ✅ 支持频道视频批量下载
      • ✅ 保持原播放列表的顺序和编号

      五、MeTube 简单易用、功能强大

      5.1 核心优势总结

      MeTube 的优点是简单易用、功能强大、兼容广泛，它是一款适合于音乐和视频爱好者的工具。

      优势说明
      🎨 界面简洁用户无需安装任何软件或插件，只需要在浏览器中访问 MeTube 的网址，就可以使用全部功能，操作起来非常方便
      ⚡ 功能全面可以从多个视频和音乐网站下载流媒体内容，可以选择多种格式和质量，可以下载元数据和播放列表，可以实现视频和音频的转换和合并
      🔧 兼容广泛可以在任何设备和浏览器上使用 MeTube，无需担心兼容性问题
      🔄 持续更新MeTube 通过每夜自动构建保持与 yt-dlp 同步更新，确保及时适应各视频网站的变化
      🔒 隐私保护自托管意味着你的下载历史和偏好完全保留在本地，无需担心数据泄露
      💾 本地存储下载的文件直接保存在你的服务器上，可以通过局域网任意设备访问

      5.2 与其他下载方案的对比

      选择 MeTube 而非在线下载服务或桌面软件的理由：

      方案优点缺点
      在线下载网站无需安装广告多、有时效性、隐私风险、功能有限
      桌面软件功能强大需要每台设备安装、占用本地资源
      MeTube（自托管）一次部署全家使用、无广告、隐私安全、功能完整需要初始配置、需要服务器/NAS

      5.3 适用场景

      MeTube 特别适合以下用户群体：

      • 🏠 HomeLab 爱好者：作为自托管服务生态的一部分
      • 👨‍👩‍👧‍👦 家庭用户：一次部署，全家共享使用
      • 🎓 学习者：下载教程视频离线学习
      • 🎬 内容创作者：收集素材用于二次创作（请注意版权）
      • 🌍 经常出差/旅行的人：提前下载内容供离线观看

      六、小结

      MeTube 是一款支持自托管的 YouTube 下载器，基于 yt-dlp 这个开源工具的网页界面，可以让用户从 YouTube 和其他数十个个视频和音乐网站下载流媒体内容，支持视频和音频的多种格式和质量，非常适合在 HomeLab 中部署使用。

      🔑 核心要点回顾：

      1. 为什么需要：解决 YouTube 的版权限制、地区限制、广告和离线需求
      2. 技术基础：基于 yt-dlp，相比 youtube-dl 有更快的下载速度和更好的兼容性
      3. 部署方式：支持 Umbrel 一键安装或 Docker/Docker Compose 自定义部署
      4. 平台支持：支持 1,800+ 网站，涵盖主流视频、音乐和社交平台
      5. 核心优势：简单易用、功能强大、隐私安全、持续更新

      📖 参考资源

  • 抱歉，回覆主題必需先登入。