XiaoMusic：5 分钟让小爱音箱点播任意歌曲
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
先想象一下
你对客厅的小爱音箱说一句"播放歌曲周杰伦晴天"，下一秒歌就响了起来——这就是 XiaoMusic 让你家的音箱做到的事。XiaoMusic 是一个开源项目，它用 yt-dlp（一个多平台音视频下载库）先把你想听的歌搜出来、下载到本地，再交给音箱播放。从此"下一首""单曲循环""加入收藏"都可以直接说出口，不用打开手机翻列表；你说一句"播放小猪佩奇的故事"，它会先把故事音频下载下来再播放，音箱还能兼当故事机。
XiaoMusic 能帮你做什么
部署完之后，除了说歌名，你还能直接做这三件事：
语音点播全网歌曲——说完歌名就开始下载和播放，不用切平台、不用开会员，下过的歌保存在本地，随时可以重听。
全语音控制——上一首/下一首、单曲循环/全部循环/随机播放、加收藏/取消收藏、播放歌单，全部说一句话就行。
定时任务 + 节假日识别——可以设置音箱在固定时间自动播放歌单或自动关机，定时表达式后面加 #workday 或 #offday，会结合内置的节假日数据自动区分工作日和休息日。
目前确认能用的设备有这些：
| 型号 | 设备名称 |
|---|---|
| L06A | 小爱音箱 |
| L07A | Redmi小爱音箱 Play |
| LX06 | 小爱音箱Pro |
| L16A | Xiaomi Sound |
| L17A | Xiaomi Sound Pro |
Web 后台里的歌曲列表页面：
XiaoMusic 怎么部署：5 分钟快速上手
新建一个 docker-compose.yml 文件，把下面的内容贴进去，再用 docker compose up -d 启动：
services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf跑起来之后，浏览器打开 http://你的服务器IP:58090（58090 是主机上的端口，可以改成任意空闲端口），就能看到 XiaoMusic 的 Web 后台；输入小米账号和密码保存后，会出现你绑定的小爱音箱设备列表。
启动时如果报目录不存在，先建好这两个目录：
mkdir -p /xiaomusic_music /xiaomusic_confXiaoMusic 配置方法：3 个进阶技巧
服务跑起来后，有 3 个配置配对了体验才好：
技巧一：先打开语音口令开关。语音指令默认是关闭的，要在设置页打开【获取对话记录】才能用嘴控制；默认口令前缀是"播放歌曲"，说"播放音乐"是不会被识别的。平时不用语音就随手关掉，避免影响账号登录状态。
技巧二：部分无损歌放不出来时开兼容模式。L05B、L05C、LX06、L16A 已知不支持 flac 文件，在设置里打开【转换为MP3】和【型号兼容模式】就能解决。
技巧三：用定时任务让音箱自动待命。设置页可以添加 cron 格式（"每天固定时间执行"的通用写法）任务，比如早 7 点播歌单、晚 11 点让音箱关机，表达式后可以加 #workday 或 #offday。
Web 后台的带标注操作引导图，可以对照着熟悉界面：
XiaoMusic 常见问题与扩展
- 设备列表看不到（Login Failed）：先试试关闭加速代理、在米家 App 或 mi.com 官网重新登录，FAQ 集合里有一整套常见报错和对应解法。
- 遇到问题先在 Web 设置页底部点【下载日志文件】，反馈前把日志里账号密码这类敏感信息删掉。
- 想写自己的语音口令，可以在 plugins/ 目录下写 JS 插件；配置项默认示例见 config-example.json。
- 提醒一句：README 中已说明项目停止维护，长期使用的读者请留意社区后续版本。
本项目仅供个人学习和研究使用，请遵守版权法规。
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
