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

IT狂人日志 2025-03-20 12:00:08
群晖部署XiaoMusic:小米音箱Pro的本地音乐自由之路一、事件驱动

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

老婆说:“你号称IT狂人,就不能想想办法嘛?”

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

二、准备工作1. 设备及存储

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

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

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

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

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

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

• 小米账号:需与米家APP登录账号一致;

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

三、部署步骤(图文详解)1. Docker环境配置

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

搜索并拉取镜像:hanxi/xiaomusic

创建容器时填写关键参数: • 环境变量(必填):

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

• 文件夹映射:

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

• 端口映射:8090:8090(默认端口)

2. 后台配置

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

勾选音箱型号,确认账号密码、端口、目录等设置;

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

四、功能亮点1. 语音点播,自由播放

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

2. 手机点播,一样方便

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

五、常见问题

音箱无响应• 检查网络是否通畅群; • 检查8090端口是否有响应; • 确认账号密码是否正确; • 确认设备型号与米家APP是否一致。

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

0 阅读:5

IT狂人日志

简介:网络工程师,从事IT行业20年,写点原创技术类文章