群晖部署XiaoMusic：小米音箱Pro的音乐自由之路

一、事件驱动

小爱音箱Pro进家好几年了，虽支持语音交互与内容播放，但经常无法播放想听的歌曲。

老婆说：“你号称IT狂人，就不能想想办法嘛？”

既然老婆发话了，那咱就得想办法解决，好在找到了XiaoMusic，这是个开源的解决方案，可以使NAS与小爱音箱连接，实现播放本地音乐和自动搜索下载歌曲的功能。

---

二、准备工作

1. 设备及存储

• NAS设备：群晖NAS。不好意思，卖给客户的都是正版群晖，自己家里用个黑的；

• 存储规划：单独插了块500GB硬盘，用来存放音乐文件，想来是足够的；

• 网络环境：群晖NAS与小米音箱需处于同一局域网内，在不在同一个VLAN倒是无所谓。

注意：安装XiaoMusic的时候，群晖NAS需要科学上网一次，我用的方法是，电脑上的clash开启代理：即Allow LAN启用。

然后群晖的网络设置里面，代理服务器打开，填写电脑的IP地址和代理端口就行，默认是7890端口。

2. 小米账号及小米音箱的具体型号

• 小米账号：需与米家APP登录账号一致；

• 设备型号：就在小爱音箱底部标签，我家的是LX06。

---

三、部署步骤（图文详解）

1. Docker环境配置

1. 在群晖「套件中心」安装Docker

2. 搜索并拉取镜像：hanxi/xiaomusic

3. 创建容器时填写关键参数： • 环境变量（必填）：

   MI_USER=小米账号
   MI_PASS=小米账号的密码
   MI_HARDWARE=LX06  # 自家的音箱型号
   XIAOMUSIC_HOSTNAME=群晖内网IP
   XIAOMUSIC_SEARCH=bilisearch:  # 启用B站搜索

   • 文件夹映射：

   /volume1/music:/app/music  # 本地音乐存储路径

   • 端口映射：8090:8090（默认端口）

   

2. 后台配置

1. 访问http://群晖IP:8090进入管理界面，点击「怀旧主题」

2. 勾选音箱型号，确认账号密码、端口、目录等设置；

3. 保存后通过「测试播放」验证连接状态，如果有声音，表示配置成功。

---

四、功能亮点

1. 语音点播，自由播放

• 支持FLAC/WAV/MP3等格式，无损播放NAS中存储的歌曲以及有声读物等。 • 自动创建JSON歌单，支持语音指令，比如：“播放歌曲郑智化的星星点灯”，如果本地没有这首歌曲，会触发自动下载，然后再播放，并且添加到列表。

2. 手机点播，一样方便

• 自适应页面，支持手机登录，可点播、可下载，也可创建不同的播放列表，很方便。

五、常见问题

音箱无响应

• 检查网络是否通畅群；

• 检查8090端口是否有响应； 

• 确认账号密码是否正确； 

• 确认设备型号与米家APP是否一致。

---

总结：在群晖上部署XiaoMusic，成功为老婆打造了个性化的乐库，得好评一个。