飞牛NAS + XiaoMusic：让小米音箱免费畅听 NAS 里的音乐

小爱音箱总是提示“试听版”？厌倦了音乐平台的会员墙？这篇教程教你在飞牛 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

搜索此博客

Cola Ice X 的博客