XiaoMusic完整指南让小爱音箱变身自由音乐播放器3步跑通【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个开源自托管音乐播放服务用语音口令让小米小爱音箱播放本地或在线下载的音乐适合想摆脱绑定平台曲库、愿意花 10 分钟做 Docker 配置的用户。 为什么需要它小爱自带播放依赖绑定的音乐账号曲库外的歌会卡在没有找到。XiaoMusic 接管语音口令歌不在库里就用 yt-dlp开源音视频下载工具联网搜索、下载再播放。本地音乐库直接扫描挂载目录每层目录就是一个播放列表支持 mp3、flac、wav 等格式。全部配置在网页完成填入小米账号密码后自动获取设备列表无需手动配置 did。 快速上手3 步跑通第一次播放第 1 步启动服务。先建好两个挂载目录然后执行docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic第 2 步绑定音箱。浏览器打开http://NAS_IP:58090在设置页输入小米账号密码并保存等设备列表刷新出来勾选要控制的小爱音箱。第 3 步播第一首歌。把 mp3/flac 文件放进音乐目录回首页点刷新列表然后说口令验证。默认前缀是播放歌曲比如播放歌曲周杰伦晴天本地没有的歌会自动走在线搜索下载。国内网络拉不动镜像时可参考 docs/issues/398.md 里的镜像源清单换源。 核心用法3 个代表性场景本地音乐库播放目录即歌单音乐目录挂载到容器的/app/music下每一层子目录都会被识别成独立播放列表一次挂多个目录也可以。口令播放本地歌曲播放歌单目录名随时切换当前歌曲说加入收藏就进了收藏列表。网页端有全部、所有歌曲、收藏、下载四个页签管理起来很直观。语音口令使用自然语言控制默认可用口令覆盖播放、上一首/下一首、单曲循环/全部循环/随机、分钟后关机、收藏、刷新列表。口令词可在设置页自定义config-example.json 里的key_word_dict是现成参考。获取对话记录开关是语音控制的前提但长期开着可能触发登录限制不用的时段建议关闭或用定时任务自动开关。对话示例小爱同学播放周杰伦的晴天。在线搜索与网络歌单本地库搜不到的歌直接在网页搜索框里搜点开即可下载并播放文件落在 download 目录。想听电台的话把 m3u 文件内容粘贴到内置的转换工具/static/m3u.html生成 json贴进歌单内容保存之后说播放列表所有电台就能放流程见 docs/issues/88.md。 避坑指南高频问题速查以下问题在 docs/issues/99.md 的 FAQ 里都有官方答复。问题排查步骤备注设备列表为空日志报 Login failed1. 关掉主机上的本地代理 2. 在 mi.com 重新登录 3. 米家/小爱音箱 App 重新绑定仍不行可改用 cookie 登录见 docs/issues/688.md网页能播但语音口令无效1. 确认获取对话记录开关已开 2. 首次保存 did 后重启一次容器 3. 检查口令带没带播放歌曲前缀M01/XMYX01JY 型号需额外开启特殊型号获取对话记录日志显示正在播放音箱没声音1. 把日志里的歌曲链接丢浏览器里测 2. 确认 hostname 是音箱能访问的局域网 IP 3. 检查端口映射触屏版可试开型号兼容模式flac 格式无法播放换 mp3 文件测试或在设置里打开转换为MP3L05B/L05C/LX06/L16A 已知不支持 flac转码较耗 CPU目录里有音乐但列表为空1. 检查卷挂载 2. 检查目录权限 3. 检查文件夹名编码文件夹名需为 UTF-8点刷新列表重新扫描它适合谁怎么开始适合家里有小米小爱音箱、且有一台能跑 Docker 的设备NAS、迷你主机、服务器的用户按上面 3 步先把链路跑通再慢慢调歌单和口令。注意 README 已声明作者停止维护官方建议社区接力项目 songloft长期使用前请把这个因素考虑进去。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考