小爱音箱本地音乐播放4步Docker部署与语音控制实战【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic周五晚上家里的网线断了客厅那台播了半年在线电台的音箱突然安静下来。大概是很多人会开始琢磨小爱音箱本地音乐播放的契机——在线播放看网络脸色自己硬盘里的歌本来应该随时能放。XiaoMusic 就是把小爱音箱接入本地音乐库的服务语音口令直接点播本地没有的歌还能用 yt-dlp 自动下载后播放。语音控制本地播放与按需下载说句话就能点播不用碰手机播放歌曲周杰伦晴天按歌名点下一首上一首切歌全部循环单曲循环换模式加入收藏把当前歌放进歌单30分钟后关机让它定时收工。体感上就是给音箱装了一整套实体按键只不过全换成动嘴。本地没有的歌先下载再播比较有意思的是播放歌曲并不只限本地库。说一句播放歌曲小猪佩奇的故事库里没有的话yt-dlp 会在后台把歌下下来存成 mp3 放进下载目录播完下载才轮到播放。说出来的话就是收藏不用手动管库。目录即歌单Web 后台统一管理音乐目录里的 mp3、flac、wav、ape、ogg、m4a 都会被识别每个子目录就是一个歌单播放歌单中文流行就是整个文件夹。Web 后台可以搜歌、点播、删掉下载错的文件、切换播放设备对网盘党来说很直观文件夹就是库库就是歌单。Docker 一条命令拉起服务 全程不用改代码也不用配环境变量先把源码拉下来看看git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic然后建两个目录分别放音乐和配置一条命令把容器跑起来。注意端口映射里的 8090 是容器内固定端口别动它mkdir -p /xiaomusic_music /xiaomusic_conf docker run -d -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic镜像拉取慢的话docs/issues/99.md 的 FAQ 里整理了几个可用的镜像源。Web 后台完成首次配置浏览器打开http://你的NAS-IP:58090依次做四件事填入小米账号密码并保存did 会自动获取不用手工查、在设备列表里选中要接入的小爱音箱、确认音乐路径指向主机上的/xiaomusic_music、保存并重启。小爱音箱本地音乐播放的配置基本都在这一步完成不需要碰配置文件。想往 NAS 上挂网盘的话把目录映射到容器的/app/music即可Web 里的路径不用改。最后说句播放歌曲测一下音箱应声播出来就通了。进阶玩法自定义口令、网络歌单、多目录曲库一句话绑定歌单想让卧室每天固定播一张歌单在配置文件的key_word_dict里加映射就行字段写法可参考仓库里的 config-example.jsonkey_word_dict: { 播放我的最爱: play_music_list#我的最爱, 晚安音乐: play_music_list#睡眠音乐 }以后说一句晚安音乐睡眠音乐目录里的歌就全播上了相当于给音箱加了自定义快捷键。把电台塞进歌单把 m3u 电台文件丢进后台的 m3u 转换工具生成 JSON 歌单再把music_list_url指向它说播放歌单某某电台就能听。电台条目会一直连续播放不会自动切下一首。曲库按目录分拆多个音乐目录分别挂到/app/music的子目录下每层目录都是一个独立歌单播放歌单播客就只播那个文件夹几百 G 的库也不乱。本地音乐播放常见问题排查口令没反应语音口令功能默认是关的去设置里打开获取对话记录开关不过它拉取请求比较频繁不用的时候随手关掉免得引起登录异常。没声音hostname 必须填音箱能访问到的局域网 IP别填 localhost也不带端口号且两者要同网段触屏版还放不出声的话打开型号兼容模式试试。Login Failed多半是小米账号登录态失效去 mi.com 官网重新登录一次人脸或滑块验证基本能解决开着代理的先关掉也可以在米家 App 里重新登录。部分歌播不了L05B、L05C 这类机型不支持 flac入库前批量转成 mp3或者在后台打开转换为MP3代价是实时转换比较吃 CPU。家里有闲置的小爱音箱、又囤着硬盘或 NAS 音乐库的话这套方案就是给音箱配上本地曲库的合适工具花几分钟用 Docker 拉起来之后播放歌曲这句话就离线也能用。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考