小爱音箱播放音乐一键搞定XiaoMusic 完整部署实战指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic晚上十点你瘫在沙发上手机只剩 3% 电却突然很想听那首高三常听的歌。你对小爱喊播放音箱却只回一句没有找到相关资源——想听自己的歌怎么就这么难开源项目 XiaoMusic 正是为这个瞬间而生它让小爱音箱按你的语音口令播放本地与在线音乐。读完这篇 XiaoMusic 完整教程30 分钟就能让音箱真正听懂你的歌单。一张表看清 XiaoMusic 全貌在动手之前先花 30 秒建立整体认知。这个小爱音箱播放音乐工具到底能做什么、适合谁看这张能力速览表就够了想了解的直接告诉你答案它是什么开源工具让小爱音箱按语音口令播放本地和在线音乐音乐由 yt-dlp 负责下载核心能力语音点歌、播放模式切换、歌单与收藏、网络歌单、在线搜索下载、插件扩展、定时任务适合谁用家里有小爱音箱的音乐爱好者、NAS 玩家、想摆脱会员曲库限制的懒人上手难度极低一条 Docker 命令 网页里填一次小米账号兼容设备覆盖 L05B、L05C、L06A、LX05、Xiaomi Sound 等主流小爱音箱型号音频格式mp3、flac、wav、ape、ogg、m4a 全兼容说白了XiaoMusic 就像在音箱和你之间架了一座桥你动嘴它跑腿。它会解析你说出的歌名和歌手去本地音乐库或在线资源里找再推给音箱播放。小贴士如果你家音箱型号比较老如 L05B、L05C后面记得开启转换为 MP3选项兼容性会好很多。看完这张表是不是觉得这项目挺对胃口下面直接进入正题——三步快速上手你不需要读一页说明书。三步快速上手一条命令部署小爱音箱部署这件事比想象中简单得多。你只需要三个动作建两个文件夹、敲一条命令、打开网页绑账号。第一步给音乐和配置各准备一个家mkdir -p /xiaomusic_music /xiaomusic_conf为什么这么做music 目录专门放你的歌conf 目录存配置和小米账号信息。两者分开既方便定期备份也避免容器升级时互相干扰。目录名你可以随意改但音乐归音乐、配置归配置的原则别丢。第二步一条命令把服务拉起来docker run -d --name xiaomusic --restartalways \ -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ docker.hanxi.cc/hanxi/xiaomusic为什么这么做Docker 会自动装好所有依赖你只需要把两个目录挂进容器里。国内用户直接用docker.hanxi.cc/hanxi/xiaomusic这个国内镜像源下载速度更快海外网络环境则可以换成官方镜像hanxi/xiaomusic。当然你习惯用 docker compose 写配置文件启动也一样效果相同。第三步打开网页验证 绑定小米账号浏览器访问http://你的设备IP:58090看到管理界面就说明部署成功。接着在设置页填入小米账号和密码并保存刷新页面后勾选你想控制的小爱音箱设备再点一次保存大功告成。到这里你的小爱音箱已经上线了。但一个工具好不好用要看它能不能满足日常需求。接下来我按真实使用场景拆开讲——不是罗列配置项而是告诉你每种情况该怎么用。场景化功能解读六个场景一套语音口令场景一瘫着不动动嘴就能点歌这是 XiaoMusic 最基础也最核心的用法。对着音箱说播放歌曲周杰伦晴天—— 指定歌名自动匹配本地音乐库上一首 / 下一首—— 切歌不用再摸手机停止播放 / 关机—— 一声令下安静收场小爱同学把你说的话转成文字后XiaoMusic 会做模糊匹配所以哪怕你的发音、断句不太标准只要歌名大致对得上它都能找出来。场景二按心情控制播放节奏听歌这件事心情不同节奏就不同。XiaoMusic 给你备好了四套脾气口令效果单曲循环一首歌听到腻为止全部循环整个歌单从头到尾反复播随机播放给歌单来点命运的安排顺序播放规规矩矩按顺序来比如睡前想听白噪音说单曲循环就行周末大扫除想让氛围热起来随机播放更带感。场景三把歌单整个交给音箱如果你按文件夹整理了音乐那恭喜你XiaoMusic 会自动把每个文件夹识别成一个歌单播放歌单华语经典—— 直接开播整个目录播放歌单第3个—— 跳到歌单里的指定位置加入收藏 / 取消收藏—— 听到好歌随手收藏下次说播放歌单收藏就能直达这种按文件夹即歌单的设计非常省心——你在电脑上怎么整理音箱就怎么播完全不用额外建清单。场景四本地没有的歌在线现找现下这是 XiaoMusic 最让人惊喜的地方。当你本地没有某首歌时直接说播放xxx它会调用 yt-dlp 自动去在线资源搜索并下载下载完立刻播放。比如有孩子的家庭可以对小爱说播放小猪佩奇的故事它会自动找内容、下载、开播——哄娃神器实锤。唯一要注意的下载默认走的是bilisearch:搜索源如果你的网络环境访问不畅可以在配置里换个搜索源或给下载加代理。场景五玩转别人的歌单想白嫖朋友整理的歌单XiaoMusic 支持 JSON 格式的网络歌单配置还能直接挂载别人分享的歌单链接。项目里还配了一个 m3u 转 JSON 的小工具能把现成的 m3u 电台文件一键转成网络歌单格式导入即可播放连手动整理都省了。场景六按自己的习惯调教它每个人说话方式不同好在口令是可以自定义的。配置文件里的key_word_dict支持你自由增删触发词比如把放歌映射到播放指令把静一静映射到停止指令。完整的配置项参考示例见 config-example.json照着改就行。到这里日常需求基本都覆盖了。不过既然是开源项目总有些隐藏关卡值得挖一挖。下一节我把踩坑经验和进阶玩法一并交给你。进阶玩法与 FAQ避坑指南常见问题为什么会翻车问题一绑定了账号音箱却毫无反应原因大多是设备没勾选或者手机和音箱不在同一局域网。解决回到网页设置确认设备列表里已勾选目标音箱并保存再确认部署设备与音箱在同一个 Wi-Fi 下。还不行就去页面底部点【下载日志文件】看看具体报错。问题二无损歌曲放不出来原因部分旧型号如 L05B、L05C、LX06、L16A不支持 flac 格式。解决在设置里同时开启【转换为 MP3】和【型号兼容模式】让系统自动转码一劳永逸。问题三想在外网访问又怕账号泄露原因默认关闭了 HTTP 认证暴露到公网很危险。解决开启密码登录并设置强密码不要在公共 Wi-Fi 下配置更别把音箱的小米账号绑定摄像头之类的隐私设备。少有人知的好玩玩法玩法一定时任务当闹钟。通过 xiaomusic/crontab.py 配置定时播放早上 7 点让喜欢的歌把你叫醒晚上 10 点自动放助眠曲比闹钟温柔多了。玩法二多音箱轮流上岗。家里不止一个小爱Web 界面里直接切换设备让音乐跟着你在客厅、卧室之间流转。玩法三插件扩展无上限。项目预留了插件接口plugins/ 目录下就有现成的 HTTP 请求类插件示例你甚至可以自定义语音口令触发脚本让小爱音箱不止会放歌。玩法归玩法还是要提醒一句凡是把服务暴露到公网的用法务必先做好密码保护安全永远排第一。总结与行动清单回头看XiaoMusic 的魅力其实就一句话它把想听歌这件小事变回了它本该有的样子——动动嘴就行。核心优势再帮你划个重点语音即遥控点歌、切歌、调模式全程不用碰手机摆脱会员本地曲库 在线自动下载想听什么有什么部署极简一条 Docker 命令新手也能零压力搞定扩展性强歌单、插件、定时任务越玩越顺手下一步按这份清单行动吧克隆项目源码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic建好/xiaomusic_music和/xiaomusic_conf两个目录用一条 Docker 命令启动容器打开网页绑定小米账号、勾选音箱设备往音乐目录里丢几首歌然后喊一句播放歌曲探索歌单、在线下载、插件和定时任务这些进阶功能音乐是生活的调味剂而好的工具是让调味变得毫不费力。当那句小爱同学播放周杰伦的晴天真的能换来回应的旋律时你会发现原来智能生活可以这么具体。祝你玩得开心也期待你在社区里分享自己的玩法——毕竟开源的意义就在于让每个人都能把它变成自己想要的样子。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考