「yubal」自托管 YouTube Music 下载器：自动整理标签、歌词和播放列表

如果你有一台 NAS 或长期在线的小服务器，yubal 适合用来把 YouTube Music 里的专辑、单曲和播放列表整理成自己的本地音乐库。它不是只把链接丢给下载器就结束，而是围绕“下载后怎么长期维护”做了一整套工作：曲目会按艺术家、年份、专辑归档，播放列表会生成 M3U 引用，后续同步也能继续复用已有文件。

这类工具最容易乱在元数据上。yubal 的重点是把标签、封面、歌词、ReplayGain 和文件格式选择放进同一条流水线里，支持 opus、mp3、m4a 等格式，也会用智能去重减少重复下载。对于已经在用 Navidrome、Jellyfin 或 Gonic 的人来说，它更像是一个面向 YouTube Music 来源的入库助手，而不是一次性的下载脚本。

项目提供 Web UI、CLI 和浏览器扩展：在网页里贴链接可以启动任务，扩展则能从 YouTube / YouTube Music 页面直接处理曲目或订阅播放列表。部署上也走典型 homelab 路线，Docker Compose 暴露 8000 端口，通过 volume 保存配置和数据，并可配置定时同步、时区、用户权限等参数。

截至这次记录，yubal 是一个 MIT 开源的 Python 项目，GitHub 约 1.2k stars。它依赖 yt-dlp 等生态能力，因此稳定性会受上游页面变化、账号 cookie、速率限制和平台策略影响。作者也在 README 里明确写了使用边界：仅用于个人归档，并遵守 YouTube 服务条款和适用版权法律。这个提醒很重要，尤其是多人共享、公开分发或商业使用场景，不应该把它当成规避授权的工具。