企业官网建设流程全解析

小爱音箱免费听全网音乐：XiaoMusic 三步完整部署与进阶玩法指南

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

XiaoMusic 是一个开源项目，能让小爱音箱免费听全网音乐：对音箱说一句"播放某某歌手的某首歌"，它会自动在全网搜到这首歌、下载到本地，再用音箱放出来——不办会员、不弹版权提示。这篇文章从部署到进阶玩法一次讲清。

它解决的是什么：告别"请开通会员"的尴尬 🎧

想象一下这样的周末早晨：你随口对小爱说"播放周杰伦的《七里香》"，得到的回应却是"该歌曲需要开通会员"。孩子想听的故事要付费，想点的老歌只能试听 30 秒，蓝牙连接又丢了音质和语音控制的乐趣。这些麻烦背后其实只有一件事：音箱内置平台的曲库和会员墙，挡住了你点歌的自由。XiaoMusic 的思路很直接——把歌先弄到你自己的设备上，音箱只负责播放。歌在本地，平台管不着你，自然就没有"暂无版权"这回事了。

它凭什么能做到：语音拦截 + 全网找歌 + 本地播放 🔍

整套机制用大白话讲，就是给音箱配了一位"隐形管家"，干活分三步：

第一步：竖起耳朵截获指令。绑定小米账号后，管家能实时听到你对音箱说的每句点歌请求，并从中提取出歌名、歌手这些信息，而不是让请求原路传回小米的音乐平台。

第二步：本地没有，就去全网"进货"。如果本地曲库里没有这首歌，管家会派出下载工具人 yt-dlp，到各大主流音乐平台把音频取回来，支持 MP3、FLAC、WAV、APE、OGG、M4A 等多种格式。

第三步：入库播放，越用越快。下载好的文件统一存在你的音乐目录里，相当于建了个"私人曲库"。第一次点播需要等下载，第二次开始直接从本地播放，响应飞快，还能做分类、收藏、歌单管理。

从零跑起来：Docker 一条命令部署 + 关键配置项速查 🐳

Docker 一键部署（推荐新手）

只要机器上装好 Docker，一条命令就能拉起服务：

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

参数不多，含义也不复杂：58090是你在自己机器上访问用的端口，8090是容器内部端口不用动；/xiaomusic_music放下载的音乐，/xiaomusic_conf放配置，两个目录建议分开、提前建好。启动成功后浏览器打开http://你的机器IP:58090，在 Web 设置页填入小米账号密码并保存，就能获取到家里的音箱设备列表了，其余参数带*号的必填、用不上的保持默认即可。

源码 / Pip 安装方式（备选）

想在本地环境里跑，也可以走 Python 路线：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic pip install -U xiaomusic cp config-example.json config.json xiaomusic --config config.json

先照着仓库里的 config-example.json 把配置抄一份出来，再启动服务即可。核心源码都在 xiaomusic/ 目录下，想深入看实现可以自己去翻。

关键配置项速查

效果说话：免费听歌体验前后对比 📊

前后体验对比

关键性能参考

一个隐藏的惊喜：直接对小爱说"播放歌曲小猪佩奇的故事"，它会先自动下载再播放，等于顺手把儿童曲库也帮你建好了。

玩出花样 + 安全须知：自定义口令、多设备与网络歌单 🎛️

自定义语音口令

在配置的user_key_word_dict里，你可以把自己的口头禅映射成任意动作，比如一句"晨间唤醒"自动播放轻快音乐、"睡前安眠"切换到白噪音。甚至能挂钩 HTTP 请求（exec#httpget(...)），让一句话触发家里的其他自动化。

多设备协同

一台服务能管全家音箱：客厅放背景音乐、卧室播儿童故事、书房放专注音乐，各自独立控制，也可以说"播放歌单+目录名"让某台设备整目录播放。

网络歌单

不想下载电台类内容？可以配置 JSON 格式的网络歌单，支持 m3u8 电台和普通歌曲，还能直接填别人分享的歌单地址一键导入，配套工具能把 m3u 电台文件转成网络歌单格式。具体玩法见仓库里的 docs/issues/78.md。

安全须知（重要）

• 如果要把服务暴露到公网，务必开启 Web 页面的密码登录并设置复杂密码，且别在公共 WiFi 环境下操作，防止小米账号泄露。
• 强烈不建议把绑定了摄像头的同一小米账号用于本项目——账号一旦出问题，监控录像可能跟着暴露。
• 建议定期看版本更新，遇到问题先在 Web 设置页底部点【下载日志文件】自查，再去社区提问。

有问有答：小爱音箱免费听歌高频问题 💬

Q1：部署后连不上小爱音箱怎么办？先核对小米账号密码是否输错、网络是否稳定；还不行就去 Web 设置页底部点【下载日志文件】，检查日志里有没有报错（提交问题前先删掉日志中的账号密码信息）。

Q2：音质怎么保证？默认下载 MP3，兼容最好；追求无损可以走 FLAC 格式，但注意 L05B、L05C、LX06、L16A 等型号不支持 FLAC，这时打开【转换为MP3】和【型号兼容模式】两个开关即可。

Q3：这个项目还会持续更新吗？作者已公告停止主动维护，并把用户引荐到社区接力项目 songloft，建议关注社区动态、及时迁移，存量功能可以正常继续使用。

Q4：能下海外平台的歌吗？可以。下载引擎是 yt-dlp，理论上全球主流平台的音频资源都在能力范围内，海外歌曲同样适用。

Q5：某首歌反复下载失败？换个说法再点一次（比如带上歌手名），或检查是否开了合适的搜索前缀；偶发的资源失效属于正常现象，社区 FAQ 里有大量同类问题的解法。

歌在本地，音箱只是扬声器——花十分钟把 Docker 命令跑起来，今晚就能对小爱说第一句"免费"的点歌指令。

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