一起来打造一个全面的音乐管理平台Music ssistant！

前言

最近不是换了手机（华为）嘛，然后一个比较头疼的问题就是我的两个支持AirPlay的音箱没有办法连接播放了。我也试过一个AirMusic的软件，但是没有搞定，很是头疼。

无意中发现了这个软件，Music Assistant--https://www.music-assistant.io/

Music Assistant 是一款专为整合在线与离线音乐资源而设计的库管理工具，它完美嵌入Home Assistant生态系统，让家中的每一个角落都能轻松流淌您最爱的旋律。 通过这款开源软件，您可以将各种音乐服务与本地收藏统一管理，并直接指令家中支持的媒体播放器播放，无需繁琐操作，享受无缝音乐体验。

• 全平台音乐聚合：无缝对接Spotify、Apple Music、QQMusic等主流流媒体，同时支持本地音乐库、NAS远程文件，一个工具管理所有音乐资源。

• 全屋音响联动：支持AirPlay、UPNPDLNA、Google Cast、Sonos等多种设备，可实现多房间同步播放、跨设备切换，打造专属家庭音响系统。

• 语音+自动化双重控制：与Home Assistant深度集成，支持语音指令（如“在客厅播放Pink Floyd”“暂停卧室音乐”），可设置定时播放、场景触发（如起床自动播放晨曲）。

• 专业播放体验：支持无缝播放、淡入淡出、音量标准化，可同步歌曲元数据、专辑封面，兼顾音质与视觉体验。
  这么好的东西，不是正好解决我的问题吗？那就马上部署一个吧。

老规矩，部署的平台还是绿联的DXP4800上。

部署Music assistant

1.去绿联的docker新建项目，输入以下代码。

services: music-assistant-server: image: ghcr.io/music-assistant/server:beta # 可替换为beta版本以获取最新测试版 container_name: music-assistant-server restart: unless-stopped # 网络模式必须设置为host，Music Assistant才能正常工作 network_mode: host volumes: - ./data:/data - ./config:/config - /volume1/music:/music #本地音乐目录 #- /你的MP3:/MP3 #可以挂载多个目录，添加本地来源时设置好名称就行了 cap_add: - SYS_ADMIN - DAC_READ_SEARCH security_opt: - apparmor:unconfined environment: # 日志级别配置，默认值为info，可选值：critical、error、warning、info、debug - LOG_LEVEL=info

完成后显示如下

2.用浏览器nasip:8095 这个地址进入登录页面，设定用户名和密码

3.去lucky做个反代
这个是非必须的哈，毕竟一般不会远程播放音乐哈

4.设定中文

5.添加QQ音乐

6.扫码登录，提示老版本的插件只支持QQ扫码登录音乐会员。后来我去插件作者xiasi0的帖子下反馈了下，前天提示我大佬更新了插件，解决了这个问题。再次感谢。

7.登录完成后保存

8.可以看到会员下的播放列表都同步过来了

9.去这里https://github.com/music-assistant/mobile-app/releases下载APP

10.登录APP，就可以选择不同的音箱来播放了。这个登录可以用本地地址也支持反代的那个远程域名。

两个音箱都可以正常播放和调节音量了，还不影响其他功能，比如看视频，打电话什么的。

微信扫码登录

如果想马上体验微信扫码登录会员的，可以按照下面的步骤来。

1.https://github.com/xiasi0/server 去这里下载最新的插件，解压出qqmusic文件夹并上传到NAS的temp文件夹。

2.ssh连接NAS 显示所有运行的容器

docker ps

3.在容器内查找插件的路径

docker exec 0cc237c0119a find / -name "qqmusic" 2>/dev/null

4.拷贝刚才下载的插件去覆盖这个原来的插件，然后重启容器

docker cp /volume1/temp/qqmusic 0cc237c0119a:/app/venv/lib/python3.14/site-packages/music_assistant/providers/

5.现在再添加音乐的时候会出来两个选项

整合到Home Assistant

这个非常简单，你安装了Music Assistant后，HA会自动扫到这个平台，去HA的设备与服务添加就好了。

这样这次的教程就全部结束了。这样我也可以直接用新手机播放音乐了。感谢阅读，码字不易，请友善交流。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～