小爱音箱免费听歌完整指南xiaomusic 十分钟部署说出歌名就能播【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic晚饭前你在厨房刷碗手上全是泡沫就随口朝客厅喊了一声小爱同学播放歌曲 晴天。几秒钟后音箱里真的响起了这首歌。没有会员弹窗没有让你打开 App也没人催你续费。这就是我要介绍的小爱音箱免费听歌方案项目名字叫 xiaomusic。它跑在你家 NAS 或一台旧电脑上是一个 Python 写的开源小服务MIT 协议。音箱一听到歌名它就用 yt-dlp 把歌下载下来存进本地然后放给你听。放过的歌第二次再点直接从本地出声音几乎不等待。适合谁家里有小米小爱音箱、愿意花十分钟搭个 Docker 环境、并且受够了这首歌需要开通会员的人。它到底是什么一句话说清楚xiaomusic 干两件事一是接上你的小米账号接管音箱的播放权二是当本地没这首歌时联网搜到、下载、缓存再播。从此音箱的音乐来源从某个音乐 App 的曲库变成你自己的本地音乐库 一切能搜到下载的歌。第一次部署十分钟跑起后台用 Docker 最省事一条命令docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic两个挂载目录建议分开music放音乐文件conf放配置容器里的/app/music、/app/conf不要动。目录不存在就先用mkdir -p建好。国内拉不动镜像的话换个镜像源即可。启动后浏览器打开http://你的主机IP:58090就是 Web 后台。在设置里填小米账号和密码保存之后设备列表会自动刷出来勾上要用的音箱基本就齐活了。控制台长什么样、按钮都在哪看这张标注图不想用 Docker 的话pip install -U xiaomusic然后xiaomusic --config config.json也能跑配置文件示例 里每个字段都有说明照着改就行。说出歌名就播它的完整流程默认口令前缀是播放歌曲。注意说播放音乐是没用的小爱只会按它自己的逻辑走——必须带前缀除非你另外改了口令词。流程是这样的本地音乐库里有的歌直接播没有的先搜索再下载下载完播。下载下来的都是 mp3存在download目录下次再点就是秒开。它还有模糊匹配歌名说错一两个字、同音字通常也能对上。还有个顺手的小玩法对音箱说播放歌曲 小猪佩奇的故事它会去找这个故事的音频下完再放。家里有小孩的话这一句顶得上一个故事机。把文件夹变成歌单音乐库自己整理这是 xiaomusic 最好用的设计之一目录结构就是歌单结构。把歌放进music目录的不同文件夹每一层的每个文件夹都会被认成一个播放列表。摇滚一个文件夹、睡前一个文件夹想听哪个说一句播放歌单 摇滚就行还能说播放列表第 3 个这种细的操作。支持的格式有 mp3、flac、wav、ape、ogg、m4a。不想让某些子目录被扫进去比如临时文件目录在忽略目录里填上名字就行逗号分隔。收藏功能也走语音听到好歌说加入收藏以后播放歌单收藏就能循环点这些歌不想要了说取消收藏。全语音操作一组张口就来的口令日常用得最多的大概是这串具体可在 配置示例 的key_word_dict里改下一首 / 上一首切歌关机 / 停止播放 / 暂停停下单曲循环 / 全部循环 / 随机播放 / 顺序播放切模式5 分钟后关机睡觉定时数字自己说刷新列表加完新歌让它重新扫一遍播放中想让音箱干别的比如查天气先说关机把 xiaomusic 的接管还回去再去问天气不然两边会打架。家里多台音箱右上角切换后台右上角那个下拉框就是设备切换器家里客厅、卧室各一台点一下换到目标音箱口令就指向谁。已测试支持的型号覆盖了 L06A、L07A、S12/S12A/MDZ-25-DA、LX5A、LX05、L15A、L16A、L17A、LX06、LX01、L05B、L05C、L09A 以及触屏版等主流机型维护者说目前基本所有设备类型都能播。查自己型号的名字去小米 IoT 平台搜xiaomi.wifispeaker就能对上。进阶玩法三个真正用得上的调整1. 自定义口令。配置示例 里留了user_key_word_dict字段比如user_key_word_dict: { 测试自定义口令: exec#code1(\hello\) }映射到exec#code1表示这句口令会调用 plugins/ 里的插件逻辑。目录里自带 code1、httpget、httppost 三个示例插件照抄一份改成自己的动作即可想给口令接什么逻辑自己说了算。2. 网络歌单。配置一个 JSON 格式的歌单music_list_json电台和歌曲都能放别人分享的链接可以直接拿来用。项目自带 m3u 转换工具手上有 m3u 电台文件的话转成网络歌单格式的 JSON 很省事具体用法见 文档目录。3. 定时任务。语音口令靠每秒拉取对话记录工作这个动作做多了容易触发限制。crontab_json可以按时开关比如白天开、深夜关。FAQ 里就有一个早上 6 点开、晚上 12 点关的现成配置抄过来就能用。第一次踩坑六种最常见的情况后台看不到设备。多半是登录验证没过日志里会有Login failed。按顺序试关掉本地代理局域网里的手机在米家 App 重新登录一次去 mi.com 官网登录一遍把人脸或滑块验证走一下——据 FAQ 统计这一步能解决绝大多数情况。网页后台能播说口令没反应。因为获取对话记录语音口令开关默认是关的去设置页打开它。另外记住前缀必须是播放歌曲首次保存完 did 要重启一次容器。用着用着设备列表消失了。对话记录拉太频繁被限制。不用语音时随手关掉语音口令开关把语音换成 Edge-TTS 音色也能减轻压力嫌手动麻烦就配定时任务。电脑上有声音箱没声。按这个顺序排把日志里的歌曲链接复制到浏览器打开打不开说明 hostname 或端口配错了主机地址必须和音箱在同一个局域网打不开 Windows 防火墙、地址别填 localhost链接能打开但音箱还是不放把型号兼容模式打开试试。个别歌放不出来。已知 L05B、L05C、LX06、L16A 这些型号不支持 flac。要么打开转换为 MP3费点 CPU要么自己批量转好。下载的歌本来就是 mp3不受影响。镜像拉不动 / 容器起不来。拉不动就换 Docker 镜像源启动报cant start new thread一般是 Docker 版本太老升级一下。更多疑难杂症项目里专门有一份 FAQ 问题集合从登录失败到端口配置基本都有人替你踩过一遍。开始之前两件小事一是安全。如果你要把后台暴露到公网一定开启密码登录并设个复杂密码公共 WiFi 下也别拿它登录小米账号密码泄露的代价不小。官方甚至明确不建议把这个小米账号绑摄像头。二是一句实话原作者已在 README 里宣布项目暂停新功能开发。功能本身已经稳定够用但遇到怪问题别指望有人快速修先翻 FAQ 找现成答案再去看社区讨论里有没有同款病例。十分钟的事值得一试。把 Docker 容器拉起来填上账号说一句播放歌曲看看你的音箱能不能真的接住——能接住后面就是慢慢整理文件夹的事了。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
