企业官网建设流程全解析

小爱音箱秒变私人点歌台：XiaoMusic 一句话语音点播完整部署指南

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

你有没有过这种时刻：辛辛苦苦整理了一整盘无损音乐，想在客厅用音箱好好享受，却发现小爱同学只会播放曲库里那些"会员专属"的歌曲，想听的歌没有、音质被压缩、切歌还得在手机 App 里翻半天？如果有一句话就能让音箱直接播放你自己收藏的音乐库呢？XiaoMusic 正是为此而生——它是一款开源工具，让你通过语音口令指挥小爱音箱播放本地和在线音乐，想听的歌找不到时，还能用 yt-dlp 自动帮你下载。今天这份指南，就带你从零开始把它跑起来。

先看看成果：你的音箱会变成什么样

部署完成后，你的小爱音箱会从一个"只会读会员曲库的播放器"，升级成私人点歌台。只需动嘴，就能做到：

• 点歌：说"播放歌曲周杰伦晴天"，自动检索并播放
• 切歌：说"下一首""上一首"，说"停止播放"即刻安静
• 模式：支持"单曲循环""全部循环""随机播放""顺序播放"
• 歌单：说"播放歌单流行音乐"，按文件夹歌单整单播放
• 收藏：说"加入收藏"，当前歌曲进入你的收藏歌单

更妙的是，这些口令全部可以自定义，你甚至能教会音箱执行"自定义任务"。所有操作都在网页后台完成，手机、电脑浏览器都能访问。

部署后的网页控制台：设备切换、播放列表、音量调节、全屏歌词一目了然

动手前先排雷：这些条件提前备好

好消息是 XiaoMusic 的部署门槛很低，但下面几点如果不提前确认，很容易卡在半路。花两分钟对一遍，能省下你一下午。

三个高频易错点，请先记住：

1. 端口别搞混：浏览器访问用的是你映射出去的主机端口（如58090），容器内固定8090不要动。
2. 两个挂载目录要分开：音乐目录和配置目录各自独立，别混在一个文件夹里。
3. 登录失败先查代理：如果绑定账号时提示 Login Failed，绝大多数情况是设备开了加速代理，关掉代理再试。

核心实操：Docker 一键部署的最小可行路径

第一步：创建目录，各司其职

在运行 Docker 的机器上建好两个目录，一个放歌、一个放配置：

mkdir -p /xiaomusic_music mkdir -p /xiaomusic_conf

音乐目录将来可以塞进各种子文件夹，比如按歌手、按专辑分类，XiaoMusic 会自动把子目录识别成歌单。

第二步：编写 docker-compose.yml

这是部署的核心，文件内容如下，我来逐行说明每一段的用途：

services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic # 国内镜像，拉取更快 container_name: xiaomusic # 容器命名，方便后续管理 restart: always # 异常退出自动重启，服务更稳 ports: - "58090:8090" # 左边是浏览器访问端口，右边是容器端口 volumes: - /xiaomusic_music:/app/music # 冒号左边是主机音乐目录，右边是容器内固定路径 - /xiaomusic_conf:/app/conf # 配置文件目录，同样挂载到容器内

为什么这么写：容器里的/app/music和/app/conf是写死的固定路径，不要修改；你只需要把冒号左边的目录换成自己机器上的实际路径。58090可以改成你喜欢的端口，8090保持原样。

第三步：一键启动

保存文件后，在docker-compose.yml所在目录执行：

docker-compose up -d

等镜像下载完、容器启动好，在浏览器输入http://你的设备IP:58090，就能看到网页后台了。想确认运行状态，可以执行docker ps | grep xiaomusic查看容器是否在运行。

第四步：绑定小米账号，这一步最关键

打开网页后台进入设置页面，这里要做三件事：

1. 填入小米账号和密码，保存。带*号的都是必填项，其他参数暂时不用动
2. 保存后系统会自动拉取你的设备列表，刷新页面
3. 勾选要控制的那台小爱音箱，再次保存

完成这步，音箱和 XiaoMusic 之间的"桥梁"就算打通了。

第五步：打开语音口令开关

最后一步容易被忽略：语音口令功能默认是关闭的。去设置页面打开【获取对话记录】（也叫【语音口令】）开关，你的点歌之旅才算真正解锁。建议不用的时候随手关掉它，因为频繁请求可能导致账号登录受限。

效果验证与进阶玩法：验收成果，再玩点花的

先说一句话验证成功

对着音箱说出默认口令前缀开头的指令："播放歌曲周杰伦晴天"。如果它开始播放你本地库里的歌，恭喜，整套系统已经跑通了！再试试"下一首""停止播放""加入收藏"，感受一下动嘴不动手的快乐。

后台的歌曲列表界面，支持按全部、收藏、下载等标签分类浏览

进阶玩法一：让小爱现搜现下，没有的歌也能播

这是最惊艳的隐藏功能。对小爱说一句"播放歌曲小猪佩奇的故事"，XiaoMusic 会先用 yt-dlp 把内容下载下来，然后直接开始播放！也就是说，曲库里没有的资源，你也能靠一句话"变"出来。想听什么新鲜内容，试试这个口令，效果立竿见影。

进阶玩法二：自定义语音口令与插件

默认口令不够顺手？你可以完全自定义。在config-example.json里，口令和指令的对应关系一目了然：

{ "播放歌曲": "play", "播放本地歌曲": "playlocal", "关机": "stop", "下一首": "play_next", "随机播放": "set_play_type_rnd", "分钟后关机": "stop_after_minute" }

把"播放歌曲"改成"来首歌"也完全可以。更进一步，XiaoMusic 支持插件扩展，你可以给音箱"教"自定义口令，让它去执行任意代码逻辑。这部分配置方式可以参考项目中的config-example.json与插件文档docs/issues/105.md。

进阶玩法三：定时任务与网络歌单

想每天早上被音乐叫醒？用xiaomusic/crontab.py配置定时播放即可，比如设定早上 7 点播放你的专属歌单。另外，项目支持 JSON 格式的网络歌单，还能把 m3u 电台文件一键转换成歌单格式，接入别人分享的电台资源，玩法参考docs/issues/78.md。

播放列表的动态折叠效果，歌单再多也不乱

常见问题速查（FAQ）

问题一：绑定账号时提示 Login Failed 登陆失败原因：多数是加速代理干扰，或账号安全验证未通过。 解法：先关闭设备上的代理再重试；也可以去小米官网登录一次账号完成人脸或滑块验证，基本能解决 99% 的登录问题。更完整的排查步骤见 FAQ 文档docs/issues/99.md。

问题二：网页后台能播放，语音控制却无效原因：语音口令开关没打开，或口令前缀不匹配。 解法：确认已在设置里打开【获取对话记录】开关；保存设备后记得重启一次容器；说话时必须以"播放歌曲"这类口令前缀开头，"播放音乐"这类词是无效的。

问题三：日志显示正在播放，但音箱没声音原因：通常是地址或端口配置问题，音箱访问不到服务。 解法：检查 hostname 是否填成了 Docker 主机地址且与音箱同处一个局域网；如果是触屏版设备，可尝试开启【型号兼容模式】。

问题四：无法播放 flac 无损格式原因：部分老型号音箱（如 L05B、L05C）不支持 flac。 解法：可在设置里打开【转换为MP3】选项，但会比较消耗 CPU；更稳妥的办法是提前把文件批量转为 mp3 再放入音乐库。

问题五：Docker 镜像拉取失败原因：网络原因导致镜像源不可达。 解法：更换镜像源或使用代理，不同 NAS 环境更换方式不同，网上搜索自己设备的镜像源配置方法即可。

总结与行动清单

从今天起，你的小爱音箱不再是"会员曲库播放器"，而是一个真正懂你收藏的私人点歌台。回顾一下这套方案的核心价值：

• 🎤纯语音控制：点歌、切歌、调模式，全程解放双手
• 🐳Docker 一键部署：两条命令搞定，NAS 玩家友好
• 🎵格式全面：无损、常见格式通吃，还支持自动下载
• 🔌扩展性强：口令自定义、插件、定时任务、网络歌单

现在就可以动手的清单：

1. 建好音乐与配置两个目录
2. 写好docker-compose.yml并启动容器
3. 在网页后台绑定小米账号与音箱
4. 打开【语音口令】开关
5. 对小爱说一句"播放歌曲"开头的指令，验收成果
6. 想自己折腾？克隆源码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic慢慢研究

音乐是生活的调味剂，而好的工具让享受变得毫无负担。别让收藏夹里的好歌继续吃灰了，现在就动手，让你的小爱音箱开口就唱，句句都对味。🎶

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic