前言
现在大多数家庭里估计都有小爱音箱吧？
你喊一声“小爱同学，播放某某歌曲”，结果却被那句“开通会员畅享全区”打断，烦得不行。
开会员当然能听全区，但现在国内各大平台坑多得很，懒得吐槽了。
如果你和我一样喜欢听歌，手里又有一堆音乐资源，碰巧还有台能跑 Docker 的设备，那这个教程就很适合你——没错，就是 xiaomusic 容器。不得不说，它真是拯救了我这个爱听歌的穷人。
如果你有多台小爱设备，不用担心，它们只要绑定在同一个小米账号下，并且在同一个组网环境里，只要有一台配置了 XiaoMusic，其他设备也都能共享这个功能。这样，你无论在哪个角落，都能让小爱同学播放你喜欢的本地音乐。
这次我用比较火的 飞牛OS 来示范部署。当然，你也可以在 OpenWrt 或 群晖 上部署。
教程开始
这里不再重复介绍如何给飞牛OS添加存储空间。
如果你还不会添加存储，请先参考我之前写的《飞牛OS详细安装教程》
点击这里跳转到飞牛OS详细安装教程
1.创建文件夹
打开飞牛OS后台
点击 文件管理 → 点击上面的 新建文件夹
创建一个名为 docker 的文件夹
打开 docker，在 docker 文件夹内创建一个 xiaomusic 文件夹
选择刚创建的 xiaomusic 文件夹
点击 更多 菜单 → 详细信息
点击 复制原始路径，将路径保存下来，后面创建容器时会用到
返回主目录，再创建一个 music 文件夹，同样复制原始路径保存备用
2.启用 Docker
进入飞牛OS后台，点击 Docker
点击 启用 Docker
如果是第一次启用，会提示选择存储位置 → 选择之前创建的存储池
开机自启：如果开关未开启，请打开
至此，Docker 成功启用
3.拉取 Xiaomusic 镜像
这里使用在线仓库直接搜索并拉取镜像。
进入飞牛OS后台，点击 Docker
切换到 镜像仓库 选项卡
在搜索框输入 xiaomusic
一般第一个搜索结果就是 hanxi/xiaomusic
点击 下载镜像 按钮
镜像标签保持默认
点击 确定 开始拉取最新版镜像
完成后，可在 本地镜像 选项卡查看是否成功
4.创建 Xiaomusic 容器
切换到 容器 选项卡
点击添加容器 按钮
- 镜像名称：选择刚拉取的 hanxi/xiaomusic:latest
- 容器名称：输入 xiaomusic（可自定义）
- 资源限制：保持不勾选
- 开机自动启动：按需开启
- 点击 下一步
高级设置
端口映射：
本地端口：8090（可自定义）
容器端口：8090（默认）
协议：TCP
存储位置映射：
将容器的存储空间映射到NAS上的文件夹
配置文件路径：
第一个填写 NAS 上的文件夹路径
粘贴上面复制的 xiaomusic 路径 /vol1/1000/docker/xiaomusic
音乐资源路径：
第二个填写 NAS 上的文件夹路径
粘贴上面复制的 music 路径 /vol1/1000/music
创建容器
点击 下一步按钮 → 确认信息 页面
核对容器名称、镜像名称、开机自启、端口和存储映射
勾选 创建后启动容器
点击 创建按钮 → 成功
容器运行检查
如果容器未运行：
点击 xiaomusic 容器 → 更多 → 运行日志
查看报错信息
不懂的可以用 Google 搜索错误内容
5.访问 Xiaomusic 面板并配置
浏览器输入：
飞牛OS后台IP:端口
例如：192.168.1.10:8090
进入 Xiaomusic 面板点击 默认主题 → 设置
填写小米账号信息（小米账号必须绑定你的小爱音箱）
启用功能：
- 目录监控：开启
- 刷新延迟：默认 60 秒，可以按需调整
- 均衡音量：loudnorm=I=-14:TP=-1.5:LRA=6
调节时务必确保音量峰值不超过 0 dB，否则小艾音箱播放时可能出现爆音
点击保存按钮
选择上面显示出来的小米音箱设备，再次点击保存按钮
测试播放：
回到面板选择一个设备，下面再选择一首歌曲播放测试
你也可以通过下面唤醒“小爱同学”的口令来播放本地歌曲（前提是该歌曲已保存在本地音乐库中）。
音乐库路径为上面映射到的 /vol1/1000/music
语音控制口令 & 提示音
功能 / 口令 / 提示音示例
播放歌曲：播放本地歌曲，本地播放歌曲，播放歌曲，放歌曲
播放列表：播放列表，播放歌单
停止：关机，暂停，停止，停止播放
本地搜索播放（临时列表）：本地搜索播放，搜索播放
停止提示音：收到，再见
单曲循环提示音：已经设置为单曲循环
全部循环提示音：已经设置为全部循环
随机播放提示音：已经设置为随机播放
单曲播放提示音：已经设置为单曲播放
顺序播放提示音：已经设置为顺序播放
6.异地组网说明
顺便说明一下：如果你进行了异地组网，只要是绑定在你小米账号下的设备，并且在同一个组网环境中，在设置里所有设备都可以勾选使用。也就是说，只要组网环境里有一台设备配置了 XiaoMusic，同一网络内的所有小爱同学都可以共享该功能
7.注意事项：
如果镜像拉取失败，可让飞牛OS使用可科学上网的环境，例如通过你的 OpenWrt，或者为飞牛OS单独配置科学上网。
如果在登录时填写小米账号和密码仍无法登录，请确认：
- 账号是否需要输入验证码；
- 或账号是否因异常状态被限制登录。
转载声明：
转载此文章请注明出处。
若本文内容侵犯了您的权益，请通过本站下方邮箱与我联系，我会尽快处理，谢谢！
发表回复