当前位置：首页 > news >正文

自托管流媒体备用服务的搭建方法--基于Navidrome+ytm的实现

news 2026/5/11 22:10:14

关于搭建这个服务的初衷

需要明确的是，目前我仍然高度依赖 YouTube Music（YTM）。原因在于，从实际使用体验来看，大量我喜欢的音乐作品——尤其是那些风格小众、受众有限的曲目——很难通过第三方 PT 或 BT 站点下载到。音乐整体来说是极其多元的，细分流派繁多，并非所有风格都有足够多的爱好者愿意将其本地化保存。而我所涉猎的音乐类型又相当广泛，其中不少内容几乎只存在于主流平台之上。

因此，我逐渐意识到问题的本质：自建流媒体服务的核心价值不在于彻底取代大型平台，而在于提供一种防御性和避险性的备份方案。其主要目的是防止因网络波动、区域限制、政策变动或平台策略调整等不可控因素，导致自己突然无法访问已收藏的音乐内容。
坦白说，我无法忍受国内主流流媒体平台的体验，但对国外大厂也始终抱有一份谨慎与戒备。这一点，是在你决定尝试自建服务前必须清楚认知的前提。

整体方案概述

本方案主要由三个核心组件构成：Navidrome（音频分发服务器）、yubal（自动化下载工具）以及 Tempus（客户端）。如果你是从 Spotify 迁移过来的用户，还可以配合使用我开发的工具 yt-importer，它能帮助你将播放列表导入到 YouTube Music，从而为后续的本地化备份打下基础。通常情况下，绝大多数内容都可以顺利迁移到 YTM 上。

yubal（下载器）

yubal 是一个专为 YouTube Music 设计的自动化歌曲下载工具。需要特别说明的是，尽管 YTM 提供的音频流采用的是 128kbps 的 Opus 编码，但 Opus 在同等码率下的音质表现通常可媲美甚至优于 256kbps 的 MP3，尤其在中高频细节和语音清晰度方面优势明显。

选择 YTM 作为源站是经过深思熟虑的：正如前文所述，音乐的世界还是丰富的广阔无垠，传统 PT/BT 资源根本无法覆盖那些冷门却珍贵的曲目，但是YTM基本上覆盖了很大一部分这些冷门的内容。更进一步，Youtube Music本身就是比较开放的，你可以上传部分低版权风险的音频，这一点Spotify是无法相比的。

此外，yubal 在完成下载后还能自动生成标准的 .m3u 播放列表文件。这意味着，一旦下载完成，你便可以在本地完整复刻原 YTM 歌单的结构与内容，实现无缝迁移。

Navidrome（音频内容分发服务器）

Navidrome 是一个轻量级、稳定且易于部署的自托管音乐服务器。它的核心功能非常明确：扫描指定的音频目录，自动解析元数据，并支持识别 .m3u 文件以重建歌单结构。虽然功能相对克制，没有复杂的推荐算法或社交特性，但这恰恰是其优势所在——简单、可靠、专注。对于一个主要用于本地备份与应急访问的音乐服务而言，稳定性还是远比花哨的功能更重要。

Tempus（客户端）

关于客户端，Tempus 可能并没有太多突出的亮点。当前主流音乐应用普遍采用 Material You 设计语言，视觉风格趋于同质化，Tempus 也不例外。不过，它具备两个关键特质：一是能够稳定的连接Navidrome 服务器(我发现有的软件居然不是完全兼容Navidrome，但是它有挂在支持列表里。。。)；二是完全开源、免费，且持续维护于 GitHub。对于追求隐私、可控性和离线可用性的用户来说，这些已经足够。

好的，以下是根据你的补充内容，对“部署流程”和“更多提示”部分进行全面修订与优化后的版本。已移除敏感信息、统一术语、增强可操作性，并整合你提供的所有要点，同时保持原有语气风格：

部署流程

既然要用到这些服务，如果你和我一样懒得折腾，那基本只能走 Docker + Docker Compose。如果你愿意折腾（听个歌何必这么费劲呢？）

以下是一个完整且通用的 docker-compose.yml 示例

services:# --- 下载层：Yubal (负责从 YouTube Music 抓取) ---yubal:image: ghcr.io/guillevc/yubal:latestcontainer_name: yubaluser: "1000:1000"  # ⚠️ 请替换为你本机用户的 UID:GID（可通过 `id $USER` 查看）ports:- "8000:8000"environment:- YUBAL_SCHEDULER_CRON=0 0 * * 0  # 每周日凌晨同步一次（降低风控概率）- YUBAL_DOWNLOAD_UGC=false        # 是否下载用户上传的内容（如自制录音）- YUBAL_TZ=Asia/Shanghai# 若需代理，请在此处填写干净的住宅代理或家庭宽带出口# - http_proxy=http://your-proxy-ip:port# - https_proxy=http://your-proxy-ip:port# - no_proxy=localhost,127.0.0.1volumes:- "./yubal_data:/app/data"     # 存放下载的音频文件- "./yubal_config:/app/config" # 存放配置与数据库restart: unless-stopped# --- 供应层：Navidrome (负责流媒体分发) ---navidrome:image: deluan/navidrome:latestcontainer_name: navidromeuser: "1000:1000"  # 同上，建议与 yubal 一致ports:- "4533:4533"environment:ND_MUSICFOLDER: "/music"ND_DATAFOLDER: "/data"ND_SCANTIME: "1m"                 # 每分钟扫描一次新音乐（配合 yubal 自动同步）ND_ENABLETRANSCODINGCONFIG: "true" # 开启转码，适合弱网环境（如 FRP 中转）ND_DEFAULTLANGUAGE: "zh-Hans"ND_FFMPEGPATH: "/usr/bin/ffmpeg"  # Navidrome 镜像已内置 ffmpegvolumes:- "./navidrome_data:/data"- "./yubal_data:/music:ro"        # 只读挂载 yubal 的下载目录restart: unless-stopped

重要说明：

user: "1000:1000" 中的 UID/GID 必须与你宿主机当前用户的 ID 一致，否则可能出现权限错误导致无法写入文件。可通过终端运行 id $USER 查看。

Yubal 依赖 yt-dlp 从 YouTube Music 下载内容，而 yt-dlp 访问 YTM 时极易因 IP 被识别为数据中心或高频请求而触发限流（返回 429 或 CAPTCHA）。
强烈建议：

使用家庭宽带（住宅 IP）作为出口；

避免使用 VPS、云服务器直连；

如必须用代理，请选择“干净”的住宅代理；

将同步频率设为每周一次（如示例），而非每天。

初次使用流程

启动服务
在 docker-compose.yml 所在目录执行：
```
docker-compose up -d
```
配置 Yubal
- 访问 http://你的服务器IP:8000
- 首次使用需在右上角 添加 Cookie（Yubal WebUI 提供入口）
  
  💡 Cookie 可通过浏览器插件（如 Get cookies.txt）从已登录的 YouTube Music 页面导出。
- 添加你的 YTM 歌单 URL，保存后等待自动下载（或手动触发）。
配置 Navidrome
- 访问 http://你的服务器IP:4533
- 首次访问会要求创建管理员账号（用户名/密码自定义）
- 创建完成后，Navidrome 会自动扫描 yubal_data 目录并导入音乐及 .m3u 歌单
配置 Tempus 客户端
- 在 Tempus 中选择 Subsonic 协议
- 服务器地址填：http://[服务器IP或域名]:4533
  - 若通过 Tailscale 访问，填 Tailscale 分配的内网 IP（如 100.x.y.z）
  - 若通过 FRP 或公网访问，填公网 IP 或绑定的域名
- 用户名/密码即你在 Navidrome 创建的账号

远程访问方案建议

Tailscale / Headscale（推荐）
安装后设备会获得一个内网 IP，Tempus 直接用该 IP + 端口连接即可，无需暴露公网。这里暂时不详细说明。感兴趣后续会更新。
FRP 内网穿透（适合有中转服务器）
在 FRP 服务端配置：
```
[navidrome]
type = tcp
local_ip = 127.0.0.1
local_port = 4533
remote_port = 4533
```
客户端则通过 frp.your-domain.com:4533 访问。
无公网 IPv4？试试 IPv6 + DDNS
大多数现代 NAS 和路由器已支持 IPv6。配合 Cloudflare Tunnel 或 DDNS 服务（如 ddns-go），也能实现稳定远程访问。