企业官网建设流程全解析

小爱音箱音乐解锁怎么做：xiaomusic 部署与配置实战

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

小爱音箱被会员墙卡住？xiaomusic 免费听歌方案

晚上你对音箱说"小爱同学，播放周杰伦的《七里香》"，得到的回答是"需要开通音乐会员"。开源项目 xiaomusic 做的就是小爱音箱音乐解锁：在你家的 NAS 或服务器上跑一个服务，把你点播的歌曲自动下载并缓存到本地，再通过小爱音箱播放。部署一次，全家用语音就能免费点播歌曲、歌单和儿童故事，不用再按月付会员费。

xiaomusic 原理：拦截口令、下载缓存、本地播放

一句话定位：xiaomusic 把小爱音箱变成能播全网音乐的本地播放器。原理不复杂，分三步：先拦截你发给小爱的语音指令，判断是不是要点播新歌；然后用 yt-dlp 引擎把歌曲下载成 mp3，存进本地音乐库；最后把本地文件推给音箱播放。音箱本身不用改任何东西，下载过的歌下次直接秒播。

xiaomusic 部署教程：Docker 一行命令装好

推荐路线是 Docker，一条命令就能拉起来：

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

需要替换的只有两处：58090是宿主机端口，改成任意空闲端口；/xiaomusic_music 和 /xiaomusic_conf是宿主机上的音乐目录和配置目录，不存在就先mkdir -p建好。8090 是容器内固定端口，不要动。启动成功后访问http://NAS_IP:58090进入 web 设置页，带*号的必填项配完即可使用。

备选路线是 pip，适合已有 Python 环境的老玩家：

pip install -U xiaomusic xiaomusic --config config.json

config.json 可以直接参考仓库里的 config-example.json 复制一份再改。

小爱音箱免费播放音乐：四个日常场景

日常点歌。说"播放歌曲周杰伦晴天"，它会搜索、下载、播放一气呵成；"下一首""上一首""停止播放"也全部响应，切歌不用掏手机。

给孩子放故事。说"播放歌曲小猪佩奇的故事"，它会先把故事音频下载下来再播，睡前点播比家长手动找资源省心。

多房间分工。说"播放歌单+目录名"，比如"播放歌单流行音乐"，就播放该目录下的歌单；家里有多台音箱时，客厅放轻音乐、卧室放故事，各播各的互不干扰。

自定义唤醒词。在配置里加一句"晨间唤醒"，音箱就触发你预设好的动作，比如播放晨间歌单——具体写法在下一节。

自定义语音指令配置步骤：改一个字典就行

大部分配置都在 web 页面上点选完成，真正需要动手的只有两处。

第一处是小米账号和密码：在设置页填入并保存后，服务才能拉取到你家音箱的设备列表，这一步是整个连接的前提。

第二处是自定义指令字典user_key_word_dict，把口令映射到内置插件（plugins/目录下的 code1、httpget、httppost）：

"user_key_word_dict": { "晨间唤醒": "exec#code1(\"播放晨间音乐\")", "睡前故事": "exec#code1(\"播放儿童故事\")" }

其余像存储路径、端口、播放模式，页面都有说明；逐项详解建议直接翻官方文档，不必在这篇里逐条展开。

小爱音箱兼容型号与高频问题排查

已测试支持的常见型号：

绝大多数型号都能正常播放，拿不准的先查 FAQ 再动手。

Q：部署后连不上音箱？先核对小米账号和密码，再确认服务与音箱在同一网络；还不行就从 web 页底部的"下载日志文件"按钮取日志排查。

Q：有些歌播不了，音质怎么保证？本地库支持 mp3、flac、wav、ape、ogg、m4a，下载的曲目是 mp3；个别型号（L05B、L05C、LX06、L16A）不支持 flac，打开"转换为 MP3"和"型号兼容模式"即可。

Q：映射到公网安全吗？一定要开启密码登录并设置复杂密码，别在公共 WiFi 下配置；另外不建议使用绑定了摄像头的小米账号，尽量缩小泄露面。

Q：长期维护怎么样？作者在 README 里已声明停止维护，功能以现状为准，README 同时推荐迁移到社区接力项目 songloft，部署前可以心里有数。

xiaomusic 值不值得装：一句话总结

xiaomusic 的价值就一件事：把会员墙挡住的歌，变成你自己音乐库里的文件。配置细节和踩坑经验，官方文档与 FAQ 合集 基本都有现成答案。

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