
XiaoMusic免费部署指南从零到小爱音箱播放任意歌曲只要10分钟【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对音箱说小爱同学播放歌曲周杰伦晴天它不回答找不到而是先把这首歌用 yt-dlp 下载到你的 NAS 或电脑上再开始播放。XiaoMusic 就是为小爱音箱音乐播放做的开源项目它用小爱账号接管你的音箱歌曲来源换成你本地的音乐库或你指定的在线来源下载下来的文件存在你能直接看到的目录里。 说播放歌曲之后的30秒音箱端到底发生了什么整个过程大致是这样小爱识别到你的口令XiaoMusic 在本地音乐目录里找对应文件找不到就先用 yt-dlp 把它下载到下载目录存成 mp3再把链接递给音箱。也就是说音箱播放的其实是你自己家里的文件音乐源不再看某个流媒体平台的脸色。本地音乐库支持 mp3、flac、wav、ape、ogg、m4a整个目录都会被扫到。除了语音还有一个网页端可以手动操作搜索本地歌曲库、播放、删除、加入收藏全部 / 所有歌曲 / 收藏 / 下载几个标签页随便切选哪台音箱播、把进度条拖到任意位置都行。三个小尴尬分别有对应解法歌在平台库里音箱却说没找到XiaoMusic 的解法是把云音乐变成自己家目录里的文件在线歌曲统一由 yt-dlp 下载到下载目录存成 mp3之后播放全程走本地不依赖平台的播放服务。这也解释了为什么第一次放一首新歌会慢半拍——得先下载。本地音乐散在好几个子文件夹歌曲库按目录组织。说播放歌单 其他就放整个文件夹说播放歌曲 歌名就放指定那一首。收藏是一个专门的歌单正在听的歌说一句加入收藏就能收进去。另外可以配一个 json 格式的网络歌单电台、网络电台都支持后台还自带 m3u 转换工具把电台 m3u 文件直接转成网络歌单。固定口令不是你想说的那几个口令词表可以完全自定义。config-example.json 里的 key_word_dict 就是口令和动作的一一对应表下一首上一首单曲循环加入收藏分钟后关机这些默认都有你也可以加自己的比如把开始工作映射到某个固定歌单早上进书房说一声就响。plugins 目录里有现成的 httpget.py、httppost.py 示例愿意动配置文件的人还能用一句话口令去触发一个 HTTP 请求。⏱️ 最小可行上手Docker启动命令与10分钟时间线第0分钟拉源码主要为了看配置示例和支持的型号列表git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic第2分钟Docker 起容器。主机上如果没有这两个目录先建一下Windows 主机换成自己盘符的路径mkdir -p /xiaomusic_music /xiaomusic_conf docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic第4分钟浏览器打开 http://NAS_IP:58090 换成你的主机 IP。带*号的两项是必配小米账号和密码不填的话设备列表是空的。第6分钟设备列表里出现你的音箱名。项目里有一份已测试支持型号清单主流 L 系、LX 系都在里面以仓库最新文档为准。第8分钟在设置页打开获取对话记录开关——语音控制靠的就是它而且默认是关的。第10分钟说播放歌曲 晴天。歌不在本地就先下载下完就响。登录失败、语音没反应时的三条排查路线我第一个踩的坑就是登录后看不到设备。项目自己的 FAQ 问题集合 里有总结多数是加速代理的锅先关代理再去 mi.com 官网重新登录一遍按经验能解决 99% 的 login failed。第二种是网页能播但语音没用大多是口令开关没开或者说的词对不上——默认前缀是播放歌曲说播放音乐是不行的实在拉不到对话记录重启一次容器往往就恢复。第三种是日志显示正在播放但没声音音箱只认主机的局域网 IPhostname 要填 192.168 开头的那个填 localhost 没用。拿日志里的歌曲链接丢进浏览器试一下浏览器能播而音箱不响基本就是地址或端口映射的问题。️ 跑起来之后值得动的几个配置位置先是格式兼容。L05B、L05C、LX06、L16A 这几个型号不支持 flac遇到播不了的歌在设置里打开转换为MP3和型号兼容模式即可代价是转换要吃 CPU按需开启就好。再是存放布局。用 Docker Compose 的话可以挂多个歌曲目录比如一个放下载、一个放本地收藏在 compose 文件里加几行映射就行。conf 目录和 music 目录建议分开以后挪音乐时配置还在。第三是安全。只在局域网用没什么额外要求一旦要公网访问必须开启密码登录并设一个复杂密码另外建议绑这台音箱的小米账号不要再挂摄像头。前端还有 pure、tailwind、xplayer 等多套主题都放在 xiaomusic/static/ 目录下换一套顺眼的就行。跑完上面那条 docker run 命令、在设置页填好小米账号密码后等设备列表里出现你的音箱名字对着它说一声播放歌曲 晴天——歌响起来这套配置就算完成了。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考