你家里的小爱音箱，现在是不是只会用来定闹钟、问天气，或者偶尔听听那几首“版权限制”的歌？
明明家里 NAS 里存了好几个 T 的高品质音乐，或者网盘里塞满了周杰伦，可小爱就是不给播。这种“守着宝库没钥匙”的感觉，确实挺让人心塞的。
今天，我要为你安利一个开源大神 hanxi 开发的神器：XiaoMusic。
它能直接让你的小爱音箱“灵魂进化”，跳过那些繁琐的限制，直接播放你自己的本地音乐、网盘音乐。关键是：完全免费，操作还贼有意思！
1. 为什么 XiaoMusic 是“小爱救星”？
简单来说，XiaoMusic 是一个部署在本地的智能中转站。它通过小米的协议接口，把你的小爱音箱连接到你自己的私人音乐库（本地硬盘、NAS）。
有了它，你可以：
- 听你想听： 彻底摆脱平台会员限制，本地有什么，小爱就能播什么。
- 原声语音控制： 依然可以对着音箱说：“小爱同学，播放《七里香》”，它会自动在你的私人库里精准匹配并播放。
- 高保真体验： 支持 FLAC、WAV 等无损格式，发挥音箱硬件的真实实力。
- 全图形化操作： 拥有清爽的 Web 后台，手机打开网页就能变身“掌上遥控器”。
2. 三分钟部署指南：让音箱立刻“起飞”
别被“安装”两个字吓到，其实非常简单。最推荐使用 Docker部署，无论你是用 NAS（比如群晖、飞牛）还是用一台一直开启的 Windows/Linux 电脑，都能轻松搞定。
方式一：Docker 一键运行
在终端中输入以下代码（记得根据实际情况修改路径）：
# 如果镜像拉取报错，推荐用国内的 docker.io/hanxi/xiaomusic
docker run -d \
--name xiaomusic \
--restart always \
-p 58090:8090 \
-v /你的音乐文件夹:/app/music \
-v /你的配置文件夹:/app/conf \
hanxi/xiaomusic
方式二：Docker Compose（推荐，更易维护）
创建一个 docker-compose.yml 文件，填入以下内容：
# 如果镜像拉取报错，推荐用国内的 docker.io/hanxi/xiaomusic
services:
xiaomusic:
image: hanxi/xiaomusic
container_name: xiaomusic
restart: unless-stopped
ports:
- 58090:8090
environment:
XIAOMUSIC_PUBLIC_PORT: 58090
volumes:
- /你的音乐文件夹:/app/music
- /你的配置文件夹:/app/conf
命令行执行，一定要在yaml文件所在路径
# 在yaml文件路径下执行
docker compose up -d
小贴士：
- 记得把路径换成你自己的。
- 如果你觉得命令行太硬核，也可以在 NAS 的 Docker 里搜索
hanxi/xiaomusic直接下载安装。
后续如何升级呢？
先停止容器，拉取最新镜像，然后重新启动容器即可。
提供常用命令作参考
# Docker常用命令
# 停止容器
docker stop xiaomusic
# 删除容器
docker rm xiaomusic
# 拉取镜像
docker pull hanxi/xiaomusic
# Docker compose常用命令（记得在yaml文件所在路径执行）
# 后台模式启动容器
docker compose -p xiaomusic up -d
# 停止删除容器
docker compose down
3. 配置一下，立刻起飞
安装好后，在浏览器输入 http://你的IP:58090，选择默认主题，就能看到管理后台了。
- 登录小米账号： 在设置中填入你的 小米账号和密码，让 XiaoMusic 能“接管”音箱。
- 选择设备： 保存配置后，在设备配置勾选你想要接管的小爱音箱型号。
- 扫描音乐： 确认音乐文件夹路径正确，点击“扫描音乐”，然后开始享受音乐的美妙。
4. 各种“玩出花”的场景
配置好之后，你的生活可能会发生以下变化：
- 沉浸式办公神器： 设定一个“白噪音”文件夹。工作时喊一声：“小爱同学，放点下雨声”，高保真的本地音质比网络电台强多了。
- 娃的专属电台： 网上找的那些稀缺的绘本音频、英文儿歌，再也不用蓝牙连接手机播放了，直接存进文件夹，小爱随时待命。
- 老歌发烧友福音： 那些年收藏的无损 FLAC 专辑，终于能在音箱上焕发第二春，现在都能通过小爱音响随心点播。
5. 常见小困惑（避坑指南）
- Q：会把小爱音箱变“砖”吗？
- A： 完全不会。它只是通过技术手段发送播放指令，不破坏原系统。你依然可以用它控制灯光、查天气。
- Q：支持哪些设备？
- A： 绝大多数小米/红米小爱音箱都支持（只要能在米家 App 里正常操作的通常都没问题）。
- Q：离线能用吗？
- A： 因为需要与小米服务器交互指令，所以你的网络需要保持在线，且部署 XiaoMusic 的设备（NAS 或电脑）不能关机。
写在最后
折腾智能家居的乐趣，就在于把那些原本“平平无奇”的设备，变成完全契合自己生活习惯的“得力助手”。
感谢 XiaoMusic 开发者 hanxi 大神把这个工具做得非常易用，真的建议每个有小爱音箱的朋友都试试。
赶紧动手试试吧！
