引言
作为一个爱折腾音乐的技术宅，我受够了小爱音箱的“版权限制”——想听首小众曲子或本地收藏，它总回我“没找到相关资源”。直到我挖到XiaoMusic这个开源神器，它用自动下载+本地音乐接管，把小爱音箱变成“无限点歌机”。今天我就手把手分享真实部署体验，让你家小爱彻底解放！
一、为什么选 XiaoMusic？不只是跳过会员
（核心痛点解决+实测能力）
我当初被两点吸引：
- 真·无限曲库：当小爱搜不到歌时，XiaoMusic 自动调用
yt-dlp 从 B 站/YouTube 下载音频，转成 MP 3 存入 NAS，下次语音指令直接播本地文件。原生语音控制兼容：不需要改唤醒词，直接说“播放歌曲《海底时光机》”就能触发自动下载和播放，切歌、收藏等指令全支持。本地音乐党的福音：我 NAS 里攒了 10 年积累的 FLAC 无损专辑，现在终于能直接对小爱说“播放本地音乐《爵士夜现场》”。⚠️ 注意：它不是破解版，而是用技术绕开平台限制，下载公开资源的音乐（如 B 站 MV、YouTube 音频），合法且免费。
二、手把手部署：10 分钟搞定（附避坑指南）
▍准备工作
- 设备需求：
- 小爱音箱（支持 Pro/Play/经典版等主流型号）NAS 或 Linux 主机（我用群晖 DS 220+，威联通/绿联等带 Docker 的型号均可）
▍关键步骤（以群晖 NAS 为例）
创建目录
在 NAS 上新建 xiaomusic 文件夹，内部再建两个子文件夹：music（存音乐）、conf（存配置）。
Docker 一键部署
打开 NAS 的 Docker 套件 → 选择Compose（推荐）或命令行部署。
推荐 Compose 配置（直接复制）：
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 退出账号重登即可刷新。
三、真实体验：比原版音箱更“聪明”的玩法
▍基础操作：动动嘴就能搞定
- 冷门歌曲自由：说“播放《水星记》”，自动下载 B 站最高音质版并播放；管理本地音乐：“播放本地音乐《周杰伦》FLAC” → 直接读取 NAS 文件夹；收藏夹联动：听到喜欢的说“加入收藏”，歌单同步到 Web 控制台。
▍进阶玩法
- 多音箱组播：在配置页设置设备分组，说“全屋播放《旅行团》”，客厅/卧室音箱同步开播；自定义唤醒词：修改源码中的
command_triggers 参数（需 Python 基础），比如改成“小爱同学，来首 XXX”；无损格式兼容：部分型号不支持 FLAC？在设置中打开转换为 MP 3，下载时自动转码。▍管理界面真香
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
往期回顾：
🔥【开源项目】免费且本地运行：用 DeepEval 测测你的大模型接口有没有缩水
