小爱音箱变身免费本地音乐库：XiaoMusic 部署与使用指南

小爱音箱变身免费本地音乐库：XiaoMusic 部署与使用指南

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

"小爱同学，播放周杰伦的《七里香》。"——"抱歉，这首歌需要开通音乐会员才能播放。"这个场景，估计每个小爱音箱用户都经历过。XiaoMusic 是一个开源项目，它拦截小爱音箱的语音指令，用 yt-dlp 把歌从网上下载回本地音乐库，再让音箱播放。说白了，就是在音箱旁边架了个私人唱片柜，歌想要哪首就去网上淘哪首，音箱只管从柜子里放。

一条 Docker 命令装好，网页填个账号就能绑音箱

部署不用写代码。在跑服务的机器上建两个目录（一个放音乐、一个放配置），执行下面这条命令：

docker run -d --name xiaomusic --restart always \ -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic

然后浏览器打开 http://你的服务器IP:58090 进入 Web 面板。必做的配置只有一件事：填小米账号密码并保存，页面就会拉出你的音箱设备列表，勾选要控制的设备即可，其余设置项保持默认就能用。面板右上角切换控制设备，左侧能看播放列表、账号和设置：

绑好音箱后怎么说话：四个日常场景

• 听冷门和绝版歌："播放歌曲周杰伦晴天"。本地没有就联网搜索、下载完再放，第二次已经在库里，直接秒播。
• 给娃放故事："播放歌曲小猪佩奇的故事"，先下载故事音频再播放，娃的固定故事时间不用你碰手机。
• 管自己的曲库：音乐目录下的每个子目录会被直接识别成一个歌单，一句"播放歌单流行"就能播。Web 端也有本地音乐库列表页，全部歌曲、收藏、下载各有标签：

• 日常控制：下一首、上一首、单曲循环、全部循环、随机播放、关机，按平时的习惯说就行。

两个可定制点：改口令前缀、整歌单

自定义语音口令：在 Web 设置（或参考 config-example.json）的 key_word_dict / user_key_word_dict 里，可以把任意前缀映射到具体动作，比如"晚上安眠"播舒缓歌单、"早晨唤醒"放新闻电台。想干更复杂的事可以写插件，仓库里附带的示例插件 plugins/code1.py 就是最小参考。

网络歌单：除了本地目录，还能配置 JSON 格式的网络歌单，电台和歌曲都支持，别人分享的链接可以直接用；项目还自带 M3U 电台文件转换工具，把你现有的电台列表一键转成可用格式，具体用法看项目文档里的"如何配置网络歌单"一篇。

先看这张音箱型号表，确认你的设备在不在

不在表里的型号一般也能直接试。部分型号（如 L05B、L05C）不支持 flac 格式，遇到就打开设置里的【转换为MP3】开关。

四个高频坑：遇到 X，先查 Y

• 如果填完小米账号密码后设备列表拉不出来（Login Failed），先检查账号密码是否正确、是否开着加速代理；关代理、在浏览器登录 mi.com 过一次人脸或滑块验证，一般就能解决。
• 如果网页端点按钮能放、但"播放歌曲 xxx"没反应，先检查【获取对话记录】（即主页的【语音口令】）开关是否打开；默认口令前缀是"播放歌曲"，说"播放音乐"是不认的。
• 如果日志显示正在播放但音箱没声音，先检查音箱和跑 xiaomusic 的机器是否在同一个局域网、"NAS的IP或域名"和端口是否填对；触屏版型号再试试打开【型号兼容模式】。
• 如果之前能用、过几天语音又失效或设备消失，先检查是不是【语音口令】开关长期开着（频繁拉取对话记录会导致登录失效）；不用的时段随手关掉，或用定时任务自动开合。

放第一首歌试试

XiaoMusic 的一句话价值：音箱能放的歌，不再被会员曲库框住，而是你自己说了算的本地唱片柜。先按上面的命令部署，再喊一句"播放歌曲 xxx"验证一遍；卡住了先翻 docs/issues/99.md 这份 FAQ 问题集合，或到项目文档里列出的社区讨论区提问。另外提前说一句：作者已停止更新此项目，若遇到新 bug，可按 README 里的说明找社区接力项目继续用。

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic