MeTube：一款支持HomeLab自托管的YouTube下载器
-
MeTube：一款支持HomeLab自托管的YouTube下载器
目录- 一、为什么你需要 MeTube
- 1.1 YouTube 的价值与局限
- 1.2 离线保存的实际需求
- 1.3 MeTube 的解决方案
- 二、MeTube 支持 HomeLab 部署
- 2.1 什么是 HomeLab？
- 2.2 使用 Umbrel 部署（推荐新手）
- 2.3 使用 Docker 部署（推荐进阶用户）
- 三、MeTube 的使用方法
- 3.1 基本操作流程
- 3.2 浏览器扩展（提升效率）
- 3.3 高级功能（2025-2026 新增）
- 四、MeTube 支持多个平台的音视频下载
- 4.1 支持的网站
- 4.2 支持的格式和质量
- 4.3 元数据下载
- 4.4 播放列表支持
- 五、MeTube 简单易用、功能强大
- 5.1 核心优势总结
- 5.2 与其他下载方案的对比
- 5.3 适用场景
- 六、小结
- 📖 参考资源
在数字内容消费时代，视频和音频资源的离线保存需求日益增长。本文将深入介绍 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-dl yt-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 5 4GB RAM，750GB+ 存储空间 x86 系统 双核 64 位处理器（推荐四核）、4GB RAM（推荐 8GB+）、32GB 存储 Linux 虚拟机 与 x86 系统相同 🔧 在 Umbrel 中安装 MeTube：
- 首先按照 Umbrel 官方指南 安装 Umbrel 系统
- 在浏览器中访问
http://umbrel.local进入 Umbrel 界面 - 在 Umbrel 的应用商店中搜索 "MeTube"
- 点击安装按钮
安装过程可能需要几分钟，安装完成后，你就可以在 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 的用户/组 ID 1000 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），就可以看到一个简洁的界面。📥 下载步骤：
- 在 MeTube 的搜索框中输入视频的 URL
- 选择你想要的下载选项（视频格式、分辨率、是否仅下载音频等）
- 点击添加按钮，开始下载
📊 管理功能：
- 你可以在 MeTube 的下载队列中查看下载进度和状态
- 在完成列表中查看已下载的视频
- 在设置中调整下载参数，例如下载目录、文件名模板、代理服务器等
- 在帮助中查看常见问题和解决方法
3.2 浏览器扩展（提升效率）
MeTube 提供浏览器扩展，让你可以在观看视频时一键发送下载任务：
平台 安装方式 功能特点 Chrome Chrome 网上应用店 或开发者模式安装 右键菜单快速发送 Firefox Firefox 附加组件 支持快捷键（默认 Ctrl+Shift+M）、SSO 认证（Authentik、Authelia、Keycloak）、自定义请求头 iOS Safari iCloud 快捷指令 从分享菜单发送 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 中部署使用。
🔑 核心要点回顾：
- 为什么需要：解决 YouTube 的版权限制、地区限制、广告和离线需求
- 技术基础：基于 yt-dlp，相比 youtube-dl 有更快的下载速度和更好的兼容性
- 部署方式：支持 Umbrel 一键安装或 Docker/Docker Compose 自定义部署
- 平台支持：支持 1,800+ 网站，涵盖主流视频、音乐和社交平台
- 核心优势：简单易用、功能强大、隐私安全、持续更新
📖 参考资源
-
0 回复
歡迎留言回复交流。
Log in to reply.