你家里的小爱音箱，现在是不是只会用来定闹钟、问天气，或者偶尔听听那几首“版权限制”的歌？

明明家里 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

小贴士：

1. 记得把路径换成你自己的。
2. 如果你觉得命令行太硬核，也可以在 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，选择默认主题，就能看到管理后台了。

1. 登录小米账号： 在设置中填入你的 小米账号和密码，让 XiaoMusic 能“接管”音箱。
2. 选择设备： 保存配置后，在设备配置勾选你想要接管的小爱音箱型号。

3. 扫描音乐： 确认音乐文件夹路径正确，点击“扫描音乐”，然后开始享受音乐的美妙。

4. 各种“玩出花”的场景

配置好之后，你的生活可能会发生以下变化：

• 沉浸式办公神器： 设定一个“白噪音”文件夹。工作时喊一声：“小爱同学，放点下雨声”，高保真的本地音质比网络电台强多了。
• 娃的专属电台： 网上找的那些稀缺的绘本音频、英文儿歌，再也不用蓝牙连接手机播放了，直接存进文件夹，小爱随时待命。

• 老歌发烧友福音： 那些年收藏的无损 FLAC 专辑，终于能在音箱上焕发第二春，现在都能通过小爱音响随心点播。

5. 常见小困惑（避坑指南）

• Q：会把小爱音箱变“砖”吗？
• A： 完全不会。它只是通过技术手段发送播放指令，不破坏原系统。你依然可以用它控制灯光、查天气。
• Q：支持哪些设备？
• A： 绝大多数小米/红米小爱音箱都支持（只要能在米家 App 里正常操作的通常都没问题）。
• Q：离线能用吗？
• A： 因为需要与小米服务器交互指令，所以你的网络需要保持在线，且部署 XiaoMusic 的设备（NAS 或电脑）不能关机。

写在最后

折腾智能家居的乐趣，就在于把那些原本“平平无奇”的设备，变成完全契合自己生活习惯的“得力助手”。

感谢 XiaoMusic 开发者 hanxi 大神把这个工具做得非常易用，真的建议每个有小爱音箱的朋友都试试。

赶紧动手试试吧！