小爱音箱音乐播放：把 NAS 里的无损音乐推给音箱
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
小爱音箱音乐播放是一个叫 xiaomusic 的开源项目。它把 NAS 或电脑目录里的音乐文件推给小爱音箱播放，本地找不到歌时再用 yt-dlp 在线下载后播放。全程保留小爱同学的语音控制，照常说"播放""下一首"就行。
它能帮你做什么
第一个场景：NAS 里存了一堆 FLAC 无损音乐，音箱自带的音乐服务却放不了。xiaomusic 会扫描music_path指向的目录，mp3、flac、wav、ape、ogg、m4a 六种格式都能识别，说"播放本地歌曲"就把歌单推上去。注意 L05B、L05C、LX06、L16A 这几个型号不支持 flac，需要打开"转换为MP3"开关。
第二个场景：本地曲库里没有的歌，不用自己去找资源。直接说"播放歌曲 周杰伦晴天"，服务会用 yt-dlp 搜索并下载成 mp3 再播放。"播放歌曲小猪佩奇的故事"这种说法也会先把故事音频下载下来再播，给孩子放睡前故事很省事。
第三个场景：睡前让音箱自己关。说"10分钟后关机"，它会按时停止播放并关机，不用爬下床按遥控器。配合网页端还能把目录建成歌单，"播放歌单收藏"放你精选的，"播放歌单其他"放剩下的。
一条路径跑通
推荐用 Docker 部署 xiaomusic，四步跑通。
第一步，在宿主机建两个目录，音乐和配置分开存放，避免混在一起：
mkdir -p /xiaomusic_music /xiaomusic_conf第二步，启动容器，宿主机 58090 端口映射到容器内 8090：
docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic第三步，浏览器打开http://NAS_IP:58090，输入小米账号和密码保存，设备列表就会拉出来，其余参数在网页上按需改。
第四步，对小爱说"播放歌曲"，听到歌声就算跑通了。
其他路径一句话带过：Python 环境直接pip install -U xiaomusic再执行xiaomusic --config config.json，配置模板见 config-example.json；Docker Compose 用户参考 README.md 里的 compose 片段，加上restart: always适合长期跑。
配置一次就懂
配置文件不用全看，第一次只用关心这四个字段：
| 字段 | 示例值 | 说明 |
|---|---|---|
| account / password | 你的小米账号 | 首次必填，保存后才能拉取设备列表 |
| music_path | music | 本地音乐目录，自动扫描六种音频格式 |
| convert_to_mp3 | false | 型号不支持 flac 时设为 true，边转边播 |
| search_prefix | bilisearch: | 在线下载时 yt-dlp 的搜索前缀 |
语音指令速查
让 xiaomusic 接管语音后，常用指令分三组。
- 播放：播放歌曲、播放歌曲周杰伦晴天、播放本地歌曲、播放歌手周杰伦
- 切换：上一首、下一首、单曲循环、全部循环、随机播放、停止播放
- 歌单管理：播放歌单收藏、播放歌单其他、加入收藏、取消收藏
这套口令让 xiaomusic 成了小爱音箱播放本地音乐最顺手的入口，不常用的两条值得记住：播放歌曲小猪佩奇的故事（自动下载后播放，适合儿童内容）和10分钟后关机（定时停播）。
踩坑三则
连接失败
现象：服务启动正常，但设备列表为空，音箱不受控制。
原因：小米账号密码没保存成功，或音箱与服务器不在同一局域网。
解决：网页端重新输入账号密码并保存；确认音箱与 NAS 在同一局域网；重启音箱和服务后再试。
播放无声
现象：进度条在走，音箱没有声音。
原因：音箱音量被拉到最低，或格式不被该型号支持（如 L05B 放 flac）。
解决：说"声音大一点"检查音量；换一首 mp3 测试；打开"转换为MP3"再播一次。
下载失效
现象：说"播放歌曲 xxx"没反应，下载任务一直为空。
原因：宿主机网络访问不到下载源，或镜像内 yt-dlp 版本过旧。
解决：在宿主机上手动访问下载源确认可达；给proxy字段配置代理；升级到最新镜像版本。
安全提醒与项目现状
- 服务暴露公网时，务必开启密码登录（httpauth 相关字段）并设复杂密码
- 公共 WiFi 下不要运行，防止小米账号密码随请求泄露
- 别把同一个小爱账号绑定摄像头，账号一旦泄露，监控录像有暴露风险
项目作者已宣布停止维护，不再接受新功能开发与 bug 修复，官方建议迁移到社区接力项目 songloft-org/songloft 获取后续更新。存量功能不受影响，只是新 bug 不再有人接。
跑通之后你会发现，音箱终于能播放自己曲库里的歌了，日常配置也就第一次那几个输入框。动手前可以翻一下 docs/ 和 xiaomusic/plugins/ 里的插件源码，了解它能再往哪扩展。
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
