📌 项目地址：music-assistant/server | ⭐ 1,706 颗星 | 🔧 Python | 📜 未标注
痛点与方案
当你同时拥有 Spotify、Tidal 的订阅，家里又混着 Sonos、AirPlay 音箱和 Google Cast 设备，想实现“离家自动暂停所有播放”或“门铃响时音乐自动降音”，会发现每个平台各自为政，没有统一控制层。Music Assistant 正是为了解决这一链条上的碎片化问题而生——它作为一个开源的媒体库管理器，一端对接多种流媒体服务（Spotify、Tidal、Qobuz、YouTube Music 等），另一端对接大量音箱协议（AirPlay、DLNA、Sonos、Google Cast、Squeezebox、UPnP 等），并提供统一播放队列、歌曲同步、音量控制等功能。更重要的是，它专为与 Home Assistant 协同工作而设计，使得任何智能家居事件都可以触发音乐相关的自动化。
实际用法：部署与基本操作
项目 README 强调，由于依赖 ffmpeg 等外部二进制组件，不支持直接通过 pip 安装，目前仅支持两种部署方式：
-
Home Assistant 插件（推荐）：直接在 Home Assistant 的 Supervisor 中添加仓库并安装。官方提供了一键添加按钮：
https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fmusic-assistant%2Fhome-assistant-addon
添加仓库后，在插件列表中搜索 “Music Assistant” 即可安装。 -
Docker 容器：需要在常开设备（树莓派、NAS、Intel NUC）上运行 Docker。完整的 docker run 命令请参考官方安装文档，因为具体参数取决于你的流媒体服务凭证、媒体库路径以及需要绑定的网络设备。
部署完成后，通过浏览器访问 http://<设备IP>:8095 进入 Web 界面。首次启动需配置至少一个流媒体提供商（例如登录 Spotify）以及至少一个播放器（例如发现局域网内的 Sonos 音箱）。之后就可以在 Music Assistant 内部创建播放列表、搜索音乐，并将音频流推送到任意已配置的播放器或播放器组上。
与同类工具的区别
在统一多平台播放这个领域，常见的替代品包括 Roon、Plex、Jellyfin 等，但 Music Assistant 的定位有明显差异：
| 特性 | Music Assistant | Roon | Plex / Jellyfin |
|---|---|---|---|
| 流媒体服务直连 | 多个（Spotify、Tidal 等） | 仅限 Tidal、Qobuz | 需自行获取文件或转码流 |
| 本地媒体库 | 支持（文件/文件夹） | 支持 | 核心功能 |
| 设备协议支持 | AirPlay、DLNA、Sonos、Google Cast、Squeezebox 等 | RAAT、AirPlay、Roon Ready | 依赖客户端 App |
| 开源免费 | 是 | 否（付费订阅） | Plex 部分付费，Jellyfin 免费 |
| 与 Home Assistant 集成 | 原生插件，深度自动化 | 无官方集成 | 可通过第三方插件，但非原生 |
关键差异：Music Assistant 并非一个纯粹的媒体服务器，而是一个流媒体聚合+音箱控制中枢，它不存储媒体文件（除非你添加本地文件夹），而是将远程流媒体服务的音轨实时转码后传递给受支持的播放器。并且它天生为自动化场景设计，Home Assistant 插件可以让自动化脚本直接触发“播放某电台”、“调整全屋音量”、“同步歌曲到多个房间”等操作。
需要注意的事项
- 运行设备要求：服务端必须 24 小时在线，推荐使用树莓派 4+、NAS 或 Intel NUC。内存建议 ≥2GB，部分流媒体转码需要一定 CPU 性能。
- Beta 阶段：项目处于活跃开发中，功能可能变化，部分协议（如 Spotify Connect 回传）仍在完善。使用前建议查阅 Beta 文档 了解最新状态。
- 依赖复杂：由于需要 ffmpeg、特定二进制文件，部署只能通过 Docker 或 HA 插件，不适合纯 Python 环境。如果你不熟悉容器或 Home Assistant，上手有一定门槛。
- 设备支持不完全：虽然支持多种协议，但并非所有型号都能完美控制（例如某些 DLNA 设备可能缺少音量同步）。建议先对照官方支持的设备列表确认。
- 隐私与数据：流媒体服务登录凭证存储在本地服务器，不会外传；但需要注意确保服务器网络安全，避免未授权访问。
总结
Music Assistant 为多平台、多设备音乐播放提供了一个统一的、可编程的控制层，尤其适合已将 Home Assistant 作为家庭自动化中枢的用户。如果你厌倦了在 Spotify、Sonos App、Tidal 之间来回切换，又想利用传感器触发音乐场景（如开门后自动恢复播放），这个项目值得一试。部署方式明确，文档完善，基于 Docker 或 HA 插件即可快速上手。