【开源项目】解放小爱音箱！用XiaoMusic打造你的私人无限曲库

作为一个爱折腾音乐的技术宅，我受够了小爱音箱的"版权限制"------想听首小众曲子或本地收藏，它总回我"没找到相关资源"。直到我挖到XiaoMusic 这个开源神器，它用自动下载+本地音乐接管，把小爱音箱变成"无限点歌机"。今天我就手把手分享真实部署体验，让你家小爱彻底解放！

（核心痛点解决+实测能力）

我当初被两点吸引：

真·无限曲库 ：当小爱搜不到歌时，XiaoMusic 自动调用 yt-dlp 从 B 站/YouTube 下载音频，转成 MP 3 存入 NAS，下次语音指令直接播本地文件。
原生语音控制兼容：不需要改唤醒词，直接说"播放歌曲《海底时光机》"就能触发自动下载和播放，切歌、收藏等指令全支持。
本地音乐党的福音：我 NAS 里攒了 10 年积累的 FLAC 无损专辑，现在终于能直接对小爱说"播放本地音乐《爵士夜现场》"。

⚠️ 注意：它不是破解版，而是用技术绕开平台限制，下载公开资源的音乐（如 B 站 MV、YouTube 音频），合法且免费。

设备需求 ：
- 小爱音箱（支持 Pro/Play/经典版等主流型号）
- NAS 或 Linux 主机（我用群晖 DS 220+，威联通/绿联等带 Docker 的型号均可）
账号：小米账号密码（用于绑定设备）

创建目录

在 NAS 上新建 xiaomusic 文件夹，内部再建两个子文件夹：music（存音乐）、conf（存配置）。
Docker 一键部署

打开 NAS 的 Docker 套件 → 选择Compose （推荐）或命令行 部署。

推荐 Compose 配置（直接复制）：
yaml 复制代码
```
services:  
  xiaomusic:  
    image: docker.hanxi.cc/hanxi/xiaomusic  # 国内镜像加速  
    container_name: xiaomusic  
    restart: unless-stopped  
    ports:  
      - 58090:8090  # 端口映射  
    environment:  
      XIAOMUSIC_PUBLIC_PORT: 58090  
    volumes:  
      - /volume1/docker/xiaomusic/music:/app/music  # 左侧替换你的NAS路径  
      - /volume1/docker/xiaomusic/conf:/app/conf
```
⚠️ 避坑点：
- 若启动报错"目录不存在"，需用 SSH 登录 NAS 执行 mkdir -p /volume1/docker/xiaomusic/{music,conf}；
- 国内用户务必用 docker.hanxi.cc 镜像源，否则拉取慢或失败。
绑定小米账号与设备

浏览器打开 http://你的NAS_IP:58090 → 进入控制台 → 设置页填写：
- 小米账号密码
- 设备型号（如 LX01 对应小爱音箱 Pro，型号列表见官方文档）
- 勾选要绑定的音箱
💡 技巧：若设备列表为空，去米家 APP 退出账号重登即可刷新。

Web 控制台（http://NAS_IP:58090）不仅能看实时下载日志，还能编辑歌单、清理缓存，甚至直接网页播放测试

播放卡顿：检查 NAS 性能，音乐文件过大时开启 MP 3 转码（设置 → 转换为 MP 3 → true）；
登录失败 ：
- 错误提示"账号密码错误" → 去小米官网重置密码；
- 设备无法绑定 → 修改 NAS 的 DNS 为 223.5.5.5；
下载失败 ：
- 更换搜索源（设置 → XIAOMUSIC_SEARCH → ytsearch 换成 bilisearch）；
- 配置代理（支持 HTTP/SOCKS 5）。

折腾 XiaoMusic 一周后，我家小爱音箱彻底"重生"------从会员曲库的囚徒变成真正的家庭 DJ。技术本质是解决问题：它用开源工具链（Docker+yt-dlp）打破资源垄断，成本是 0，但换来的音乐自由无价。

如果你也想告别"灰色一分钟试听"，直接上 GitHub 搜 hanxi/xiaomusic 开搞吧！遇到坑随时回来看这篇，评论区交流更欢迎 👨‍💻

附资源直达

官方文档（FAQ/型号支持）：xdocs.hanxi.cc

往期回顾：