XiaoMusic 实测：十分钟让小爱音箱免费播全网音乐

XiaoMusic 实测：十分钟让小爱音箱免费播全网音乐

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

有天下班回家，随口让小爱音箱放周杰伦的《晴天》，音箱先是一顿思考，然后回了句"暂无版权"。家里另一台老音箱放着儿歌倒是没这毛病，但孩子想听小猪佩奇，照样卡在版权上。折腾了一圈之后我找到了 XiaoMusic，一个跑在自己 NAS 上的小爱音箱音乐播放工具：音箱收到"播放歌曲"的语音指令后，它负责找到音乐、下载下来再播给你听，全程不掏会员费。

这个项目到底干什么

简单说，XiaoMusic 是给小爱音箱接了一套"自己找歌"的能力。服务常驻在你自己的电脑或 NAS 上，音箱说出"播放歌曲某某某"这类口令后，它通过 yt-dlp 把歌曲下载成 mp3 存进本地目录，再推送给音箱播放。第一次点播要等下载，第二次再点同一首就是本地秒播。我实测的日常用法就两种：下班路上想听什么，到家直接开口；给孩子放故事，一句"播放歌曲小猪佩奇的故事"就行，它会把故事音频下好再播，不用你手动往音箱里导文件。

三个典型场景实测

语音点播指定歌曲

我对着音箱说"播放歌曲周杰伦晴天"，服务先匹配本地音乐库，库里没有就调用下载源找歌，下完直接开播。我实测从开口到出声，热门歌曲第一次大约十几秒，之后再点就是即播。

口令的容错度还可以，歌名记岔了个字、只说"播放歌曲晴天"这种模糊说法，大部分时候也能命中。

下载儿童故事

家里有娃的场景我专门测了"播放歌曲小猪佩奇的故事"。跑起来之后它会先下载故事音频，然后正常播放，孩子追更不需要我碰手机。故事类资源比单曲大，第一次等得久一点，但之后走本地缓存。

多台音箱分组播放

家里有客厅和卧室两台音箱的话，Web 设置页里可以把它们都勾上，日常各自独立播——客厅播我的歌单、卧室放轻音乐。设置页还有个"设备分组配置"，把几台设备的 did 填进同一个组名，就能一起出声。我提醒一句：官方对这个功能标注了"不推荐"，多台同时播会有不到一秒的延迟差，人声还好，节奏快的歌会听出不同步，我一般只用来放背景音。

十分钟部署步骤

安装

最简单的路径是 Docker。下面这条命令拉取镜像并启动，把 58090 端口映射到外，同时把下载的音乐和配置分别挂到两个本地目录，方便以后迁移：

docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

如果不想用容器，pip install -U xiaomusic装完再执行xiaomusic --config config.json也能跑，配置文件照着根目录的 配置示例 抄一份改名即可。

配置

容器方式下基本不用改文件，我实际只做了三件事：进http://你的IP:58090的 Web 控制台，在账号设置里填小米账号和密码并保存；确认音乐目录指向的是你想要的位置；其他带*号的必填项补齐。如果用 pip 方式，最小配置长这样：

{ "account": "你的小米账号", "password": "你的小米密码", "music_path": "music" }

保存后服务会自动刷新设备列表，音箱会出现在页面上。

连接测试

我连上之后先说了句"播放歌曲"，音箱出声就证明链路通了；再试"下一首"、"单曲循环"确认播放模式指令也正常，然后才放心把它放到卧室跑。

连上之后值得试的功能

跑顺之后，我补测了三个进阶点，都不算难。

网络歌单：可以在配置里填一个 json 格式的歌单地址，电台和网络歌曲都支持，也支持直接挂别人分享的链接；仓库自带 m3u 转 json 的工具，旧电台文件不用手动整理。

自定义口令：配置示例 里的key_word_dict把口令映射到具体动作，我加了一句"播放歌曲下班歌单"指向自己的歌单，喊起来比默认口令顺口。

插件扩展：插件目录 里放了 httpget、httppost 这类现成 JS 插件，能自定义语音指令、接第三方接口，配合 crontab 的定时任务，做到每天固定时间自动放音乐。

遇到这些坑怎么办

• 填完账号密码后设备列表一直是空的：先确认 NAS 和音箱在同一局域网，再核对密码有没有输错；还不行就去 Web 设置页底部下载日志看一眼，一般能定位。
• 点播某首歌一直下载失败：多半是下载源抽风，换一个搜索源试试；网络受限的环境在配置里填 proxy，别在歌名上较劲。
• 部分格式播不出：L05B、LX06 这类机型不支持 flac，在设置里打开【转换为MP3】和【型号兼容模式】就解决了。
• 口令喊了没反应：去key_match_order里看看这个口令是不是排在了更长的关键词后面，顺序决定谁先命中，把常用的排前面。

收尾

跑了一个多月，我的体感是：部署十分钟，之后基本不用管，音箱从"什么都不敢放"变成"开口基本都能响"，省掉的是会员费，多花的是自己盘上的一点空间。想动手的话，仓库地址是https://gitcode.com/GitHub_Trending/xia/xiaomusic，clone 下来看看 README 和 配置示例，十分钟能见效。

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