小爱音箱音乐解锁Docker 5 分钟部署与配置实践【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个基于 Python 与 FastAPI 的项目。它拦截小爱音箱的语音指令调用 yt-dlp 引擎把音乐下载到本地库从而完成小爱音箱音乐解锁。适合有基础服务器或 NAS 运维经验的用户。 工作原理XiaoMusic 通过小米云服务 API 与小爱音箱建立连接持续轮询最新的语音对话记录。当记录命中key_word_dict中的关键词后程序调用 yt-dlp 到对应平台搜索歌曲并下载。文件按目录写入music_path指定的本地库随后经 MiService 通道把播放地址下发给音箱执行。后续点播直接读本地文件不再产生额外的音频流量。歌名匹配支持模糊命中由enable_fuzzy_match选项控制。服务另提供 REST API启动后可访问/docs查看接口文档。⚙️ 部署与配置Docker 部署命令前提服务器已安装 Docker。执行以下命令docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic预期结果容器启动后浏览器访问http://服务器IP:58090即可进入 Web 设置页。若提示目录不存在先执行mkdir -p /xiaomusic_music /xiaomusic_conf创建。conf 目录放配置music 目录放音乐建议分开挂载。58090 是宿主机端口可按需修改8090 为容器端口不要改动。国内网络可把镜像名换成docker.hanxi.cc/hanxi/xiaomusic。偏好源码方式的话需 Python 环境执行pip install -U xiaomusic xiaomusic预期结果终端输出监听日志默认端口 8090。可加--config config.json指定配置文件参考仓库根目录的 config-example.json 编写。config.json 关键字段首次使用在 Web 页面输入小米账号密码。带*号的为必填项保存后才能拉取设备列表。关键字段如下account/password小米账号与密码music_path本地音乐库目录port服务端口默认 8090hostname服务内网地址用于向音箱下发播放地址search_prefixyt-dlp 搜索前缀默认bilisearch:convert_to_mp3是否统一转码为 mp3 功能与操作基础语音指令指令行为点播歌名本地没有则先下载再播放播放歌曲从本地音乐库点播上一首切到上一曲下一首切到下一曲随机播放 / 全部循环 / 单曲循环切换播放模式播放歌单目录名播放对应子目录加入收藏 / 取消收藏管理收藏歌单停止播放 / 关机停止播放歌名不限于音乐。输入故事名程序同样会先下载再播放适合儿童听故事场景。进阶用法自定义指令在user_key_word_dict字段中定义口令可指向 plugins/ 目录下的 code1、httpget、httppost 等内置插件user_key_word_dict: { 晨间唤醒: exec#code1(\播放晨间音乐\), 睡前安眠: exec#code1(\播放白噪音\) }多设备管理保存账号后自动拉取设备列表。页面右上角下拉框可切换当前受控设备多只音箱可分别控制。网络歌单在music_list_json字段配置 JSON 歌单支持电台与在线歌曲可直接使用他人分享的链接。仓库自带 m3u 转换页可把 m3u 电台文件转成 JSON 歌单。⚠️ 已知限制与注意维护状态README 顶部公告显示项目已停止维护不再接受新功能开发与 bug 修复。作者建议在 README 中查看社区接力项目的迁移指引。设备兼容已验证型号包括 L06A、L07A、S12/S12A、LX5A、LX05、L15A、L16A、L17A、LX06、LX01、L05B、L05C、L09A 及触屏版系列。L05B、L05C、LX06、L16A 不支持 flac可开启convert_to_mp3选项转码。未列出的型号建议先查阅 Issues 确认兼容性。账号安全配置公网访问时必须开启页面密码登录并设置复杂密码。不要在公共 WiFi 下运行。也不建议把该小米账号绑定摄像头避免账号泄露时牵连录像。格式与资源本地库支持 mp3、flac、wav、ape、ogg、m4a 共 6 种格式。歌曲获取依赖 yt-dlp个别平台资源可用性受平台自身策略影响。下载失败时可更换search_prefix前缀重试。 延伸阅读docs/index.md官方文档xiaomusic/核心源码docs/issues/问题清单【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
