|
马上注册，自学更多教程，下载更多资源。
您需要 登录 才可以下载或查看，没有账号？立即注册
x
XiaoMusic 项目全解析：让小爱音箱实现 “音乐自由” 的开源工具
一、项目概述
XiaoMusic 是一款专为小米小爱音箱设计的 开源音乐扩展工具 ，核心目标是突破小爱音箱默认音乐库的会员限制与资源壁垒，通过技术手段让音箱能播放全网音乐，本质是为小爱音箱打造 “无限音乐库” 的辅助系统。该项目基于 MIT 许可证开源，代码托管于 GitHub（ hanxi/xiaomusic ），并提供详细官方文档（ xdocs.hanxi.cc ），支持普通用户与技术爱好者通过简单部署实现 “白嫖” 全网音乐，目前已收获大量用户认可。
二、核心功能
XiaoMusic 围绕 “解放小爱音箱音乐播放能力” 设计，功能覆盖 “资源获取 - 部署管理 - 使用控制 - 个性化扩展” 全流程，具体如下：
1. 无限音乐来源：突破平台限制
[] 多平台音频抓取 ：借助 yt-dlp（全网音频 / 视频下载工具），自动从 YouTube、B 站、抖音等平台抓取音频资源，解决小爱音箱默认库 “无版权、需会员” 的痛点；
[] 自动格式转换 ：通过 ffmpeg 将抓取的音频转为小爱音箱支持的格式（默认 MP3），即使原资源格式不兼容（如 FLAC），也能通过配置 “格式转换” 功能适配；- 本地音乐管理 ：支持读取 NAS 本地音乐文件（覆盖 MP3、FLAC、WAV、APE、OGG、M4A 等格式），本地文件优先播放，无本地资源时自动触发在线下载并缓存至 NAS。
2. 灵活部署：适配多设备与场景
项目主打 “低门槛部署”，支持多种方式，尤其适配 NAS 设备（群晖、QNAP、极空间等主流型号），具体包括：
[] Docker 一键部署（推荐新手）：提供国内外镜像（国内镜像 docker.hanxi.cc/hanxi/xiaomusic 解决拉取慢问题），只需复制命令即可启动，支持目录挂载（音乐目录 /xiaomusic_music、配置目录 /xiaomusic_conf），确保数据持久化；
[] Docker Compose 配置 ：支持多容器管理，可自定义端口（默认本地端口 58090，容器端口 8090 不可改），适合需要整合其他服务的用户；
[] pip 安装 ：适合熟悉 Python 的用户，通过 pip install -U xiaomusic 快速安装，支持通过配置文件（参考 config-example.json）自定义参数；
[] 开发环境运行 ：提供 install_dependencies.sh 依赖脚本与 PDM 环境管理，支持开发者二次开发（如自定义前端界面）。
3. 便捷管理：Web 界面与语音控制
部署成功后通过 http://NAS_IP:58090 访问，支持可视化配置（必填项含小米账号密码，用于绑定音箱；其他项如 “型号兼容模式”“格式转换” 按需开启），可查看设备列表、音乐库、下载日志；
覆盖日常播放场景，无需手动操作音箱，部分口令如下：
[] 基础控制：“播放歌曲 + 歌名”（如 “播放歌曲周杰伦晴天”，本地无则自动下载）、“上一首 / 下一首”、“单曲循环 / 全部循环”、“停止播放”；
[] 进阶功能：“刷新列表”（添加本地歌曲后更新歌单）、“播放列表 + 列表名”（如 “播放列表收藏”）、“搜索播放 + 关键词”（如 “搜索播放林俊杰”）、“本地搜索播放 + 关键词”（仅查本地资源）；- 隐藏玩法：“播放歌曲小猪佩奇的故事”，可自动下载并播放有声内容。
4. 个性化与扩展能力
[] 网络歌单支持 ：可配置 JSON 格式歌单（支持电台、歌曲），也能通过工具将 M3U 电台文件转为 JSON 格式，支持直接使用他人分享的歌单链接；
[] 自定义口令 ：通过配置文件或插件扩展语音指令（如自定义 “播放睡前音乐” 触发特定歌单）；
[] 定时任务 ：支持设置定时播放（如晨间闹钟、睡前助眠曲），可区分工作日与休息日；
[] 多设备控制 ：支持绑定多个小爱音箱，可分组管理（如 “客厅音箱”“卧室音箱”），实现多设备同步播放。
三、支持设备与格式适配
1. 已验证支持的小爱音箱型号
项目覆盖小米系绝大多数智能音箱，包括普通款、Pro 款、触屏款，部分主流型号如下：
| 型号 | 音箱名称 | 特殊说明 | | L06A | 小爱音箱 | 基础款，无特殊配置 | | LX06 | 小爱音箱 Pro | 不支持 FLAC 格式，需开启格式转换 | | L16A | Xiaomi Sound | 不支持 FLAC 格式 | | L17A | Xiaomi Sound Pro | 需确认 “型号兼容模式” 是否开启 | | M01/XMYX01JY | 小米小爱音箱 HD | 需设置 “特殊型号获取对话记录” 为 true | | LX04/X10A | 小爱触屏音箱 | 无需额外配置 |
2. 音乐格式适配说明
[] 下载的音频默认保存为 MP3 格式 （兼容性最强）；
[] 本地支持格式：MP3、FLAC、WAV、APE、OGG、M4A 等；- 特殊说明：已知 L05B、L05C、LX06、L16A 不支持 FLAC 格式，可通过 Web 后台开启 “转换为 MP3” 功能适配。
四、技术原理 XiaoMusic 实现 “欺骗小爱音箱播放非官方音乐” 的核心逻辑分三步：
资源抓取与转换：通过 yt-dlp 抓取第三方平台音频，ffmpeg 转为音箱兼容格式；
账号关联与指令下发：通过 MiService 登录小米账号，获取音箱列表并模拟官方指令；
本地资源调用：音箱接收指令后，从 NAS 的 XiaoMusic 目录拉取音频，绕开官方会员校验。
五、安全提醒与注意事项
[] 公网访问安全 ：若配置公网访问（如内网穿透），必须开启密码登录并设置复杂密码，避免小米账号密码泄露；
[] 账号绑定风险 ：强烈不建议将绑定了摄像头的小米账号用于本项目，以防监控录像泄露；
[] 问题排查 ：遇到故障时，可在 Web 后台下载日志文件（删除敏感信息后），到 GitHub Issues 反馈；
[] 合规性提示 ：抓取的音频需用于个人非商业用途，遵守平台版权规则，避免侵权。
六、社区与支持
[] 官方交流渠道 ：
[] QQ 群：xiaomusic 官方交流群 3（群号 1072151477 ）；
[] 新手帮助 ：若部署困难，作者提供远程安装服务（需支付 50 元辛苦费，仅周末及晚上可约）；- 周边工具 ：配套工具 epub2mp3（有声书转换）、tiny-nav（NAS 导航），可搭配使用。
七、总结
XiaoMusic 是一款 “精准解决用户痛点” 的开源工具 —— 它以低成本（无需额外硬件，仅需 NAS 或服务器）、低门槛（Docker 一键部署、Web 可视化配置）的方式，彻底释放了小爱音箱的音乐播放潜力，让用户摆脱会员束缚，实现 “想听就听” 的音乐自由。无论是技术小白还是爱好者，都能通过该项目让普通小爱音箱升级为 “全网音乐播放终端”，是智能家居场景中极具实用价值的开源方案。
| 
发表于 2025-11-28 13:03:31
