
Music Assistant(简称 MA)是开源免费自托管音乐库管理服务,主打统一整合本地音频文件与各大流媒体平台,通过统一 Web 界面推送音乐至全屋各类播放设备,专为智能家居生态打造,可与 Home Assistant 深度联动实现音乐自动化场景。
核心参数:
核心参数:
- 部署方式:Docker 容器、Home Assistant 官方插件,支持树莓派 4+/NAS/Linux 服务器,低硬件资源占用
- 音源支持
- 流媒体:网易云音乐、QQ 音乐、Spotify、Tidal、Apple Music、YouTube Music
- 本地媒体:NAS / 硬盘 FLAC/MP3/WAV 无损音频,自动抓取元数据封面歌词
- 附加资源:播客、网络电台、有声书统一入库
- 播放设备兼容:AirPlay2、Google Cast、Sonos、DLNA、Snapcast、Yamaha 多平台音箱,支持多房间同步、独立分房播放、播放接力
- 音频核心功能:无缝播放、智能 BPM 交叉淡入、音量标准化、DSP 音效预设、无损音质优先自动切换
- 智能家居联动:接入 Home Assistant 实现自动化,离家自动暂停、定时播放、语音切歌、播报语音不打断背景音乐
- 前端界面:Vue3 渐进式 Web 应用,手机 / 电脑浏览器直接访问,歌单收藏、播放队列管理、收听记录同步 LastFM
- 开源协议:开源免费无功能限制,社区持续迭代,最新稳定版 v2.7
适配场景:NAS 无损音乐统一管理、多流媒体账号整合、全屋多音箱同步听歌、智能家居音乐自动化、自建私人音乐流媒体服务器
docker部署:
docker run -v <dir>:/data --network host --cap-add=DAC_READ_SEARCH --cap-add=SYS_ADMIN --security-opt apparmor:unconfined ghcr.io/music-assistant/server
数据卷是/data - 用<dir>替换为一个可写目录以确保数据卷在更新之间持久化。如果你想在MA内访问本地音乐文件,请确保同时挂载该本地目录,例如 /media
Docker compose:
services:
music-assistant-server:
image: ghcr.io/music-assistant/server:latest # <<< Desired release version here (or use beta to get the latest beta version)
container_name: music-assistant-server
restart: unless-stopped
# Network mode must be set to host for MA to work correctly
network_mode: host
volumes:
- ${USERDIR:-$HOME}/docker/music-assistant-server/data:/data/
# privileged caps (and security-opt) needed to mount smb folders within the container
cap_add:
- SYS_ADMIN
- DAC_READ_SEARCH
security_opt:
- apparmor:unconfined
environment:
# Provide logging level as environment variable.
# default=info, possible=(critical, error, warning, info, debug)
- LOG_LEVEL=info