小爱音箱总是提示“试听版”？厌倦了音乐平台的会员墙？这篇教程教你在飞牛 NAS（fnOS）上部署 XiaoMusic，绑定小米账号后，只要跟小爱同学说一声，就能免费播放你收藏多年的本地曲库。
一、为什么要用 XiaoMusic？
很多人家里有小爱音箱、也有 NAS，却两者互不相通——小爱只能播放付费平台的歌，NAS 里存的几千首无损音乐就此蒙尘。
XiaoMusic 是 GitHub 上开发者（@hanxi）维护的开源项目，核心逻辑是：
- 在 NAS 上跑一个轻量服务，把本地音乐“伪装”成网络资源；
- 通过绑定小米账号，接管小爱的播放指令；
- 小爱接到“播放歌曲 XXX”的语音命令后，实际播放的是你 NAS 里的文件。
免费、开源、无需破解音箱固件，这就是它的魅力所在。
二、准备工作
2.1 你需要准备
| 设备 / 账号 |
说明 |
| 飞牛 NAS（fnOS 系统） |
已启用 Docker 功能 |
| 小爱音箱（小米系） |
支持市面上主流型号（详见下方列表） |
| 小米账号 |
建议专门注册一个，避免绑定摄像头等隐私设备的主账号 |
| 本地音乐文件 |
支持 MP3、FLAC、WAV 等常见格式 |
2.2 支持的音箱型号
| 型号代码 |
音箱名称 |
| L06A | 小爱音箱 |
| L07A | Redmi 小爱音箱 Play |
| S12 / MDZ-25-DA | 小米 AI 音箱 |
| LX06 | 小爱音箱 Pro |
| LX05 | 小爱音箱 Play（2019 款） |
| L05B / L05C | 小爱音箱 Play / Play 增强版 |
| L15A | 小米 AI 音箱（第二代） |
| L16A / L17A | Xiaomi Sound / Xiaomi Sound Pro |
| L09A | 小米音箱 Art |
| OH2P | XIAOMI 智能音箱 Pro |
| LX04 / X10A / X08A | 小爱触屏版 |
💡 特殊型号配置提示：
• X08C / X08E / X8F：需在设置中开启“型号兼容模式”。
• M01 / XMYX01JY（小爱音箱 HD）：需开启“特殊型号获取对话记录”。
三、在飞牛 NAS 上部署 XiaoMusic
3.1 整理音乐文件夹
首先在 NAS 上准备好音乐目录，建议路径简洁，例如：/vol1/music/
在飞牛 NAS 的文件管理中，右键点击该文件夹 → 详细信息，复制“原始路径”备用。
3.2 方法一：Docker Compose 部署（推荐）
第一步：修改镜像源（加速国内拉取）
打开飞牛 NAS 的 Docker 管理 → 镜像仓库 → 仓库设置，将地址改为：
https://docker.1ms.run
修改后点击右上角重启 Docker 服务。
第二步：创建项目目录
在文件管理中（建议存放在非系统盘），新建文件夹：
/vol1/docker/xiaomusic/
并在该文件夹内新建两个子目录：
/vol1/docker/xiaomusic/conf//vol1/docker/xiaomusic/music/（也可以直接挂载你存歌的实际目录）
第三步：创建 docker-compose.yml
新建 docker-compose.yml 文件，填入以下内容：
services:
xiaomusic:
image: docker.hanxi.cc/hanxi/xiaomusic
container_name: xiaomusic
restart: always
ports:
- 8090:8090
volumes:
- /vol1/docker/xiaomusic/music:/app/music # 改为你的实际音乐路径
- /vol1/docker/xiaomusic/conf:/app/conf # 配置文件存储路径
第四步：启动项目
1. 打开飞牛 NAS Docker 管理；
2. 点击 项目 → 创建项目；
3. 项目名填写 xiaomusic，路径选择刚才存放 docker-compose.yml 的目录；
4. 确认创建，等待容器拉取并启动完毕（状态变为绿色“运行中”）。
3.3 方法二：SSH 命令快速部署
若习惯终端操作，SSH 登录 NAS 后执行以下命令：
docker run -d \
--name xiaomusic \
--restart always \
-p 8090:8090 \
-v /vol1/docker/xiaomusic/music:/app/music \
-v /vol1/docker/xiaomusic/conf:/app/conf \
docker.hanxi.cc/hanxi/xiaomusic
四、配置 XiaoMusic
部署完成后，在浏览器中访问：http://你的NAS内网IP:8090
4.1 绑定小米账号
- 进入 Web 管理界面，点击右上角设置（齿轮图标）；
- 输入你的小米账号与密码；
- 填写 NAS 的局域网 IP 与端口
8090；
- 点击保存。
💡 首次保存后系统会自动连接小米服务器拉取设备，请刷新页面加载列表。
4.2 选择音箱设备
刷新页面后，在设备列表中勾选你的小爱音箱型号，再次点击保存。
4.3 验证曲库
在主界面确认是否能列出 NAS 中的音乐。如果列表为空，请排查：
- Docker 目录挂载映射路径是否正确；
- 飞牛 NAS 文件权限是否允许 Docker 容器读取。
五、语音控制命令清单
| 语音指令（对小爱说） |
触发效果 |
| 播放本地歌曲 | 随机播放 NAS 本地音乐库 |
| 播放歌曲 周杰伦 晴天 | 精确播放指定歌手与曲目 |
| 搜索播放 林俊杰 | 本地曲库搜索并播放 |
| 播放列表 古典音乐 | 播放指定的本地歌单/文件夹 |
| 下一首 / 上一首 | 切歌控制 |
| 单曲循环 / 随机播放 | 切换播放模式 |
| 加入收藏 / 播放列表收藏 | 收藏当前音乐 / 播放收藏夹 |
| 刷新列表 | 重新扫描 NAS 音乐目录 |
| 停止播放 | 退出播放 |
🎉 隐藏玩法： 对小爱说 “播放歌曲 小猪佩奇的故事”，XiaoMusic 会自动从网络搜索抓取并播放，本地没有的音频也能实时收听！
六、进阶玩法与配置
6.1 开机自启
在 Docker Compose 中配置了 restart: always（或 unless-stopped），容器会随 NAS 开机和 Docker 服务自动运行。
6.2 外网远程点歌（内网穿透）
若希望在公司或外网也能控制家中音箱，可配合内网穿透工具（如 cpolar）：
# 安装 cpolar
curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
# 创建 8090 端口穿透隧道
cpolar http 8090
通过生成的公网安全地址，即可在外部网络访问 Web 管理后台。
七、常见问题排查
- Q：小爱没有反应 / 依然走了官方试听版播放？
A： 确认音箱与 NAS 处于同一局域网内；尝试将网络模式切换为 host；语音指令建议使用“播放本地歌曲”。
- Q：音乐列表为空？
A： 检查卷映射路径；在飞牛文件管理中右键点击音乐文件夹 → 权限管理，确认赋予了读取权限。
- Q：FLAC 无损音频播放有杂音或卡顿？
A： 进入 XiaoMusic 的“高级设置”，开启 MP3 实时转码 功能。
- Q：账号保存后刷不出音箱列表？
A： 确认该小米账号在“米家 / 小爱音箱”App 中已成功绑定音箱，保存设置后强制刷新页面。
- Q：担心账号安全与隐私？
A： 强烈建议单独注册一个小号，仅将小爱音箱共享/绑定到该账号下。
八、总结与相关链接
| 特性 |
说明 |
| 完全免费 | 无须订阅第三方音乐 VIP |
| 开源可靠 | GitHub 持续维护，社区活跃度高 |
| 部署极简 | 飞牛 NAS 图形化 Docker 5 分钟上手 |
| 功能丰富 | 本地曲库播控、歌单管理、在线点歌一应俱全 |
| 本地私密 | 音频直接内网串流，不经第三方云端转发 |
• 项目开源地址： GitHub - hanxi/xiaomusic
• XiaoMusic 官方文档： xdocs.hanxi.cc
• 飞牛社区讨论： club.fnnas.com
评论
发表评论