小爱音箱播放本地音乐XiaoMusic 三步部署与使用指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个让 小爱音箱 自由播放任何歌曲的开源音乐服务。部署后本地音乐库里的歌一句话语音就能出声库里没有的歌会自动联网搜索、下载并播放。适合手里有小爱音箱、电脑上或 NAS 里已经存了一堆歌又不想被平台曲库限制住的人整套方案免费且部署成本低。能力总览本地曲库、在线播放与多设备功能分两层核心层负责把歌唱出来扩展层负责把管理变省事类别能力说明核心多来源音乐聚合通过 yt-dlp命令行下载工具对接多个在线音源点播时自动下载再播放核心语音交互播放歌曲歌名、播放歌单目录名、单曲循环、X分钟后关机等内置口令也可以自定义口令核心本地音乐库自动扫描音乐目录支持 mp3、flac、wav、ape、ogg、m4a 格式扩展多主题界面内置 Pure、Tailwind、XPlayer 等多个 Web 主题按需切换扩展音乐管理元数据修复、重复文件处理、批量下载、定时任务扩展多设备协同一个后台管理多台音箱分组后多房间同步播放同一首歌从 0 到跑通三步把音箱接进来门槛不高一台能跑 Docker 的机器Linux、Windows、macOS 均可音箱和这台设备在同一局域网。第一步拉取代码有 Docker 的话这一步可以跳过直接拉官方镜像git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic第二步启动服务docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic58090 是宿主机对外端口8090 是容器内固定端口不要改。两个卷分别存放音乐文件和配置主机上目录不存在时先建好再启动。第三步首次配对浏览器打开http://设备IP:58090在设置页填入音箱绑定的小米账号和密码系统会拉取设备列表。列表里出现你的音箱后对音箱说一句播放歌曲测试能出声就说明配置完成。真实用法说一句话会发生什么 烹饪用播放歌单切场景歌单歌单对应音乐目录下的子目录名。把做饭听的 BGM 放进一个叫厨房的目录炒菜时说一句小爱同学播放歌单厨房音箱就从该目录第一首开始播。中途听到一首不错的补一句加入收藏它就进了收藏歌单以后单独点播。 运动报歌名点播循环跟练直接说播放歌曲歌名。本地库里有就立刻播没有的话服务会去在线搜索把音频下载到本地再播放第二次再点同一首就没有等待。跑步时加一句单曲循环整段训练跟着同一首节奏走。 会客分组多房间同步播放客人来了逐个房间喊口令很麻烦。在 Web 设置里把客厅、阳台的音箱分到同一个组一句口令全组同步播放哪个房间要安静把对应音箱移出分组即可。这是 小爱音箱多房间同步播放 最省事的接法。避坑指南五个高频问题音箱连不上先确认音箱和跑服务的设备在同一局域网再到设置页重新保存一次小米账号密码仍不行就从设置页底部的日志下载入口导出日志看具体报错。下载慢默认搜索源是 bilibili搜不到或慢时在 Web 设置里换成 ytsearch 等其他音源批量下载尽量挑非高峰时段。口令没被识别说法越短越好播放歌曲歌名这种格式最稳有习惯性说法可以写进配置文件的 key_word_dict 字段做映射等于给小爱音箱加同义词。部分歌曲播不了L05B、L05C、LX06、L16A 等老型号不支持 flac 格式在设置里打开转换为MP3和型号兼容模式两个选项。公网访问把服务暴露到公网 IP 时必须开启登录密码并且建议不要把绑着摄像头的小米账号拿来用避免账号泄露连带隐私泄露。值得做以及怎么参与XiaoMusic 的价值在于把 小爱音箱 从只能播平台曲库变成想播什么播什么本地库、在线点播、多设备分组三样凑齐家用场景基本够用。项目的新功能迭代已逐渐放缓官方建议有长期需求的用户关注社区接力项目但现有功能完整稳定。想参与的话有三个入口到项目 issue 提交 bug 或功能建议参考 plugins/ 目录里的模板写自定义口令插件前端和文档的改进也长期缺人。docs/issues/211.md 是文档汇总入口各 NAS 的安装教程、FAQ 问题集合都收在那份清单里。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考