如果你家里有一台小爱音箱，但总觉得它“歌单太少”“只能听 QQ 音乐/网易云已购内容”，那今天要介绍的这个开源项目，可能会让你大呼“早该装了”！
它叫 XiaoMusic —— 一个能让小爱音箱突破平台限制、自动搜索并播放任意网络歌曲的神器。更厉害的是：你说“播放周杰伦的七里香”，即使你没买过这首歌，它也能自动下载并播放！
没错，你的小爱音箱，从此变成真正的“全网音乐播放器”。
它到底能干什么？
一句话概括：
用语音控制小爱音箱播放任何你想听的歌——本地没有？它就去网上找、下、播！
具体来说，XiaoMusic 实现了以下功能：
- 🎵 语音点歌自由：对小爱说 “播放林俊杰新歌”、“随机播放周深”、“播放歌单 XXX”，音箱立刻响应；
- 🌐 自动补全曲库：当本地没有指定歌曲时，自动通过 Bilibili、YouTube 等源搜索并下载（基于
yt-dlp）； - 📁 支持多种格式：mp3、flac、wav、ogg、m4a 全都兼容；
- 🖥️ Web 管理界面：无需语音，也能在浏览器里搜索、下载、管理音乐；
- 🧩 Docker 一键部署：配置简单，一个
music目录 + 一个conf目录即可运行； - 📱 兼容多款小爱设备：从经典的小米 AI 音箱到 Xiaomi Sound Pro、小爱触屏版等数十款型号均支持。
背后的原理：巧妙“借力”
XiaoMusic 并非破解小爱音箱固件，而是利用了一个聪明的“中间人”策略：
- 你向小爱音箱发出语音指令（如“播放告白气球”）；
- 小爱将指令上传至小米云端；
- XiaoMusic 通过你提供的小米账号，监听小爱的历史对话记录；
- 一旦识别到“播放 XXX”类指令，立即在本地/网络中查找对应歌曲；
- 找到后，通过小爱音箱的DLNA/蓝牙/音频推送接口，把音乐“塞”给音箱播放。
整个过程对用户完全透明——你只管说话，剩下的交给 XiaoMusic。
⚠️ 安全提示：由于需要提供小米账号密码，务必在私有网络环境（如家庭 NAS）中部署，并开启 Web 界面密码保护。切勿将服务暴露在公网，也不要用绑定了摄像头或门锁的小米账号！
不只是音箱伴侣，还是个全能音乐工具箱
即使你没有小爱音箱，XiaoMusic 依然值得尝试！它的 Web 界面自带多个实用工具：
- 🔍 歌曲下载器：粘贴 Bilibili、YouTube 视频链接，自动提取音频并转为 MP3；
- 📋 M3U 歌单转换：导入/导出标准播放列表；
- 🔄 歌单合并工具：整合多个来源的音乐列表；
- 🎧 本地音乐播放器：直接在浏览器试听已下载的歌曲。
青小蛙（小众软件作者）实测发现：“随手下载几个视频转 MP3，还挺方便的。”（不过部分平台如网易云可能仅能获取试听片段。）
谁适合用？
- ✅ 有小爱音箱，但受困于音乐平台版权限制的用户；
- ✅ 想用语音控制打造“全网音乐库”的极客；
- ✅ 拥有 NAS 或 Docker 环境，喜欢自建服务的技术爱好者；
- ✅ 需要批量下载网络音频的创作者或收藏者。
💡 前提条件：你需要一台可长期运行的设备（如树莓派、NAS、旧电脑），并具备基础 Docker 使用能力。
如何开始？
- 准备环境：确保有 Docker 运行环境；
- 获取项目：GitHub 地址 → https://github.com/hanxi/xiaomusic；
- 配置账号：在
conf目录中填入小米账号密码（建议注册小号）； - 启动容器：按文档运行
docker-compose up -d； - 访问 Web 界面：浏览器打开
http://你的IP:10880，完成初始化设置； - 对小爱说：“播放 Beyond 海阔天空” —— 坐等奇迹发生！
官方文档非常详尽：https://xdocs.hanxi.cc/
结语：开源的力量，让智能音箱真正“智能”
XiaoMusic 的出现，再次证明了开源社区的创造力——它没有等待厂商开放 API，而是用巧妙的方式绕过限制，把选择权交还给用户。
当然，它并非完美：依赖第三方音源、存在账号风险、部分设备需特殊设置……但瑕不掩瑜。对于愿意动手的人来说，这无疑是目前解锁小爱音箱音乐潜能的最佳方案。
🎶 从此，天下歌曲，皆可“小爱同学，播放……”
