music-assistant/server

这是什么？

核心功能

• 01将多个流媒体服务接入同一个音乐库
• 02支持控制多种联网音箱
• 03设计上可作为 Home Assistant 应用运行，便于自动化
• 04提供 Docker 镜像，方便自行部署
• 05基于 Python 开发，音频处理依赖 ffmpeg

适用场景

• 在家中各个房间的音箱上播放流媒体音乐
• 为 Home Assistant 自动化方案加入音乐播放功能
• 在树莓派或 NAS 上搭建家庭音乐服务

快速上手

1. 1

   在 Home Assistant 中安装 Music Assistant 应用（推荐）

2. 2

   或运行官方 Docker 容器镜像

   docker pull ghcr.io/music-assistant/server
3. 3

   开发环境：使用安装脚本创建虚拟环境并安装依赖

   scripts/setup.sh
4. 4

   开发环境：在本地运行服务，地址为 http://localhost:8095

   python -m music_assistant --log-level debug

使用前须知

• !未发布到 PyPI，因此不支持使用 pip 安装。
• !除通过应用或容器运行外，需要自行提供较新的 ffmpeg（7.0+）及系统依赖。
• !设计为在常开设备上运行，与 Home Assistant 配合使用效果最佳。
• !不支持第三方发行版的软件包。

收录于专题

标签

常见问题

server 是什么？

自托管音乐库管理器，连接流媒体服务和多种联网音箱，常与 Home Assistant 配合使用。 Music Assistant 是一款免费开源的媒体库管理器，可以连接你的流媒体服务和多种联网音箱，在一处统一管理和播放音乐。服务端是整个项目的核心，需要部署在树莓派、NAS 或小型 Intel NUC 等常年开机的设备上。

server 可以免费使用吗？用的什么许可证？

server 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

server 还在维护吗？

活跃维护中。server 最近一次提交是在 2026年10月24日。

server 适合用来做什么？

在家中各个房间的音箱上播放流媒体音乐 为 Home Assistant 自动化方案加入音乐播放功能 在树莓派或 NAS 上搭建家庭音乐服务

server 怎么安装和运行？

在 Home Assistant 中安装 Music Assistant 应用（推荐） 或运行官方 Docker 容器镜像: docker pull ghcr.io/music-assistant/server 开发环境：使用安装脚本创建虚拟环境并安装依赖: scripts/setup.sh 开发环境：在本地运行服务，地址为 http://localhost:8095: python -m music_assistant --log-level debug

在哪里获取 server？

源代码和安装说明在 GitHub 上：https://github.com/music-assistant/server