XiaoMusic小爱音箱音乐简单解锁Docker 五分钟装好【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic“小爱同学播放歌曲七里香”——音箱回一句需要会员或者播了绑定音乐应用里的另一首歌。XiaoMusic 接管的正是这类“播放歌曲”口令音源换成你自己的本地曲库加按需下载不依赖会员账号。它是怎么工作的XiaoMusic 是一个免费开源MIT 协议的小爱音箱音乐播放工具音乐由 yt-dlp 负责下载一般部署在 NAS 上。完整流程分四步用小米账号在 Web 后台登录拉取设备列表并勾选目标音箱服务轮询音箱的对话记录捕获带自定义前缀的口令默认前缀“播放歌曲”先匹配本地音乐库未命中时由 yt-dlp 在线搜索、下载并缓存到 NAS把歌曲的 HTTP 流链接推给音箱播放之后的上一首、下一首、循环模式都走语音控制。它能做什么分组能力基础播放播放歌曲歌名、播放本地歌曲、上一首/下一首、停止/关机、“X分钟后关机”播放模式单曲循环、全部循环、随机播放、顺序播放歌单管理播放歌单目录名、播放歌单第几个、加入/取消收藏网络音源网络歌单JSON 格式、电台m3u8、可直接填别人分享的链接曲库多级目录即多歌单支持 mp3/flac/wav/ape/ogg/m4a下载歌曲为 mp3最有辨识度的两点按需下载说“播放歌曲小猪佩奇的故事”会先把故事音频下载下来再播放下载后的歌留在本地曲库下次不再下载。Web 管理面板搜索、播放、切换设备、歌单管理都在一个页面完成家里有多台音箱时可以统一调度。5 分钟首次上手Docker 一条命令部署音乐目录和配置目录分开映射docker run -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic目录不存在就先mkdir -p /xiaomusic_music /xiaomusic_conf。启动后浏览器打开http://NAS_IP:58090填入小米账号密码保存设备列表出现后勾选音箱即可。不想用容器时也可以pip install -U xiaomusic安装后用xiaomusic --config config.json运行。必须修改的参数Web 设置页开关很多实际只有这几项要改其余保持默认即可参数作用建议值account/password登录小米云拉设备列表和对话记录你日常登录小米 App 的账号hostnameNAS的IP或域名音箱拉取音频用的地址NAS 的局域网 IPv4不能填 localhost 或 IPv6/app/music挂载本地曲库与下载缓存目录独立目录别和/app/conf混用语音口令获取对话记录开关决定语音指令是否生效用时打开不用时关闭口令前缀触发接管的关键词默认“播放歌曲”可自定义⚠️ 常见坑位排查1. 保存账号后后台看不到设备日志出现 Login failed 原因账号密码错误、开了本地代理或触发了小米风控。 处理到 mi.com 重新登录一次通过滑块验证能解决大多数情况关闭本地代理或把容器网络从 bridge 改为 host仍不行就在米家 App 里重新绑定音箱再试。2. 网页能播放语音口令没反应原因语音口令开关默认是关的口令前缀不匹配也不行——默认前缀是“播放歌曲”说“播放音乐”不会被识别。 处理打开开关、统一前缀首次保存 did 后重启一次容器。3. 日志显示正在播放音箱却不出声原因hostname指向音箱访问不到的地址比如填了 localhost、端口映射不对、与音箱不同网段、填了 IPv6。 处理先把日志里的歌曲 http 链接丢到浏览器验证能否打开再核对局域网 IPv4 和端口关闭 NAS 防火墙触屏版机型可尝试打开“型号兼容模式”。4. flac 歌曲无法播放原因L05B、L05C、LX06、L16A 等型号不支持 flac 格式。 处理设置中开启“转换为MP3”会增加 CPU 消耗或提前用其他工具批量转成 mp3。5. 用了一天之后语音控制、设备列表失效原因轮询对话记录过于频繁被小米限流。 处理不用时随手关闭语音口令或用内置定时任务按时开关例如早上开启、午夜关闭。 进阶定制自定义口令与网络歌单自定义口令在plugins/目录放自写的 .py 插件再在配置的user_key_word_dict里把一句话映射到exec#code1(参数)或exec#httpget(url)说出口令即可触发对应脚本或 HTTP 请求容器运行时需要把 plugins 目录挂载进容器。格式参考配置示例用法见自定义口令功能说明user_key_word_dict: { 开始晨间音乐: exec#code1(\morning\), 打开灯光: exec#httpget(\http://192.168.2.5:8080/light/on\) }网络歌单设置页填一段 JSON 或直接给一个分享链接电台m3u8和歌曲链接可以混排已有 M3U 电台文件可用内置转换工具转成该格式详见网络歌单配置和如何添加m3u格式文件的电台。设备兼容与安全边界设备范围已测试型号包括 L05B、L05C、L06A、L07A、LX05、LX06、LX5A、L15A、L16A、L17A、L09A、S12 及触屏版X08 系列、LX04 等、M01小爱音箱HD。作者认为各设备类型大多已支持播放新机型可直接尝试。已知限制接管依赖轮询对话记录音箱自带回答到 XiaoMusic 打断之间存在延迟不是无缝衔接进度条暂不支持拖动小爱音箱播放中被接管期间问天气等功能会被打断需先说“关机”。另外 README 已声明作者停止维护该项目现有功能可继续使用但新问题不再跟进长期使用建议关注社区接力项目。安全与隐私小米账号密码或 cookie以明文存放在服务端暴露公网时必须开启 Web 登录密码并设复杂口令不要在公共 WiFi 下操作强烈不建议把摄像头绑定到同一个小爱音箱账号账号泄露时监控录像会一并暴露。遇到问题去哪查官方文档部署入口与 FAQ 索引配置示例全部配置项与默认值FAQ问题集合按现象排查各类常见报错文档汇总端口修改、定时任务、设备分组等专题想先试跑照“5 分钟首次上手”一节执行一条 docker 命令即可。Web 页面看到设备后说一句“播放歌曲”就是成功。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考