用 Docker 在飞牛云 NAS 搭建 XiaoMusic，让小爱音箱畅听本地音乐

你是否遇到过这样的困扰：飞牛云 NAS 里存储了大量喜爱的歌曲，却无法通过小爱音箱直接播放？其实，借助 Docker 搭建 XiaoMusic 项目，就能轻松解决这个问题，让小爱音箱与 NAS 里的音乐库无缝连接，实现语音控制、自动下载歌曲等便捷功能。

认识 XiaoMusic：功能与优势

• 开源可控：基于 MIT 开源协议，代码完全公开，用户可自主掌握数据与功能，无需担心隐私泄露。
• 跨平台部署：支持 Docker 部署，兼容飞牛云 NAS 等主流 NAS 平台，一键即可完成安装，新手也能快速上手。
• 智能联动：本地没有所需歌曲时，会自动通过 yt-dlp 下载，无需手动操作；既能通过语音指令控制小爱音箱，也能在网页端直接管理播放。
• 高度自定义：可自由设置语音口令，比如将 “播放歌曲” 改为专属指令；还支持编写插件，拓展功能边界。
• 多端控制：提供网页端（支持默认、怀旧、Tailwind 等多种主题）和微信小程序控制界面，操作灵活多样。

支持设备与音乐格式

兼容的小爱音箱型号

• 小爱音箱（L06A）、Redmi 小爱音箱 Play（L07A）
• 小米 AI 音箱（S12/S12A/MDZ-25-DA）、小爱音箱万能遥控版（LX5A）
• 小爱音箱 Play（2019 款，LX05）、小米 AI 音箱第二代（L15A）
• Xiaomi Sound（L16A）、Xiaomi Sound Pro（L17A）
• 触屏版（LX04、X10A、X08A 等）及小米智能音箱系列（OH2P、OH2）

支持的音乐格式

部署步骤：用 Docker 在飞牛云 NAS 搭建 XiaoMusic

准备条件

1. 一台飞牛云 NAS（其他品牌 NAS 也可参考此方法）；
2. 访问 XiaoMusic 的 GitHub 项目地址（https://github.com/hanxi/xiaomusic/）获取最新资源；
3. （可选）域名，用于远程访问（需注意安全设置）。

具体部署操作

1. 新建 Docker Compose 项目
   在 NAS 的 Docker 管理界面中，新增一个 Compose 项目，命名为 “xiaomusic”。
2. 配置 Compose 文件
   复制以下配置内容，根据实际需求调整本地目录映射（如./music1可改为 NAS 中存放歌曲的文件夹路径）：

   services:
     xiaomusic:  # 定义服务名称为 xiaomusic
       image: docker.hanxi.cc/hanxi/xiaomusic  # 使用来自 hanxi 的 XiaoMusic 镜像
       container_name: xiaomusic  # 容器名称为 xiaomusic
       restart: always  # 容器异常退出后自动重启
       ports:
         - 58090:8090  # 映射端口：宿主机58090端口 -> 容器内部8090端口
       environment:
         XIAOMUSIC_PUBLIC_PORT: 58090  # 设置 XiaoMusic 的对外访问端口
       volumes:
         - ./music1:/app/music/music1  # 映射本地自定义目录 music1 文件夹到容器内指定目录
         - ./music2:/app/music/music2  # 映射本地自定义目录 music2 文件夹到容器内指定目录
         - ./xiaomusic_music:/app/music  # 映射本地总音乐目录到容器内 /app/music
         - ./xiaomusic_conf:/app/conf  # 映射本地配置文件夹到容器内的配置目录
   

3. 启动容器
   保存配置后启动项目，容器会自动拉取镜像并运行。若国内网络拉取镜像失败，可尝试更换镜像仓库，例如：
   • https://proxy.1panel.live/
   • https://docker.1panel.top/
   • https://mirror.azure.cn/

配置与使用：让小爱音箱 “听懂” 你的 NAS

1. 访问 Web 界面
   在浏览器中输入http://NAS的IP:58090（例如http://192.168.31.115:58090），进入 XiaoMusic 设置面板。
2. 绑定小爱音箱
   • 填写小米账号和密码，完成登录；
   • 选择需要控制的小爱音箱设备（至少勾选 1 个）；
   • 确认 NAS 的 IP 和端口（默认自动填充），保存配置。
3. 语音控制指令
   配置完成后，即可通过小爱同学语音控制播放，常用指令包括：
   • “播放歌曲周杰伦晴天”：播放指定歌曲，本地无文件时自动下载；
   • “上一首”“下一首”“随机播放”：控制播放状态；
   • “加入收藏”：将当前歌曲添加到收藏歌单；
   • “搜索播放林俊杰”：搜索并播放相关歌曲；
   • “刷新列表”：当 NAS 中新增歌曲时，更新播放列表。

安全提醒

• 若配置公网访问 XiaoMusic，务必开启密码登录，并设置复杂密码，避免账号泄露；
• 不建议将绑定摄像头的小米账号用于本项目，防止监控数据泄露；
• 避免在公共场所 WiFi 环境下使用，降低账号被盗风险。