|
嗯,用户问的是关于xiaomusic的信息。我需要整理一下从搜索结果中找到的相关内容。首先,根据Webpage 1,xiaomusic是一个基于Python的开源项目,使用yt-dlp下载音乐,通过MiIO API控制小爱音箱。Webpage 2和3提到它支持Docker部署,并且可以配置B站或YouTube作为音乐源。Webpage 4和5详细说明了群晖NAS的部署步骤,包括环境变量的设置,比如MI_USER和MI_PASS。还有Webpage 6到10补充了不同的部署方式和常见问题,比如设备型号的确认和代理配置。用户可能需要知道安装步骤、支持的语音命令、配置选项以及可能遇到的问题。需要综合这些信息,分点回答,确保每个部分都有对应的引用来源。还要注意时间线,因为有些网页是2024年的,但用户的问题是当前2025年的,可能有些更新,不过搜索结果里最新的到2025年3月20日,所以应该没问题。需要提到不同安装方法,如Docker和Python,以及配置时的注意事项,比如设备型号和环境变量。还要涵盖功能亮点,比如多源下载和语音控制,以及常见问题如延迟和设备兼容性。最后,确保引用正确,比如不同网页提到的配置步骤和问题解决。
XiaoMusic 是一款专为小米/红米音箱设计的开源音乐播放解决方案,通过 Python 或 Docker 部署,可绕过音乐平台会员限制,实现本地音乐播放、在线音乐下载及语音控制功能。以下是核心信息整理:
---
一、核心功能与优势
1. 多源音乐支持
- 支持从 Bilibili 或 YouTube 下载音乐(需配置 `XIAOMUSIC_SEARCH` 参数为 `bilisearch:` 或 `ytsearch:`)^6^9。
- 本地音乐库兼容 MP3、FLAC、WAV 等格式,自动同步 NAS 或本地存储^3^5。
2. 语音指令控制
- 支持丰富的语音命令,如“播放歌曲周杰伦晴天”“下一首”“单曲循环”“关机”等^3^5。
- 隐藏功能:如“播放小猪佩奇的故事”可触发儿童故事播放^6^9。
3. 跨平台部署
- Docker 部署(推荐):支持群晖、威联通、极空间等 NAS,通过 Docker Compose 或命令一键运行^2^4^10。
- Python 原生运行:需配置 `config.json` 文件并安装依赖(如 yt-dlp、MiIO API)^1^5。
4. Web 控制面板
- 提供可视化界面管理播放队列、歌单、下载任务及设备配置^5^8。
- 支持自定义端口、代理设置(`XIAOMUSIC_PROXY`)及安全认证^8^10。
---
二、部署步骤(以 Docker 为例)
1. 环境准备
- 确认小爱音箱型号(如 LX06、L07A),记录设备底部的 MI_HARDWARE 值^4^6。
- 获取小米账号(`MI_USER` 和 `MI_PASS`)^3^4。
2. Docker 命令或 Compose 配置
yaml
docker-compose.yml 示例
services:
xiaomusic:
image: hanxi/xiaomusic
ports:
- "8090:8090"
volumes:
- ./music:/app/music 音乐存储目录
- ./conf:/app/conf 配置文件目录
environment:
MI_USER: "小米账号"
MI_PASS: "密码"
MI_HARDWARE: "设备型号" 如 LX06
XIAOMUSIC_SEARCH: "bilisearch:"
XIAOMUSIC_HOSTNAME: "NAS内网IP"
- 启动后访问 `http://NAS_IP:8090` 完成绑定^2^10。
3. 设备绑定与测试
- 在 Web 界面输入账号密码,勾选音箱型号,保存配置^4^6。
- 通过“播放歌曲+歌名”测试功能,首次播放会触发下载^2^5。
---
三、常见问题与优化
1. 播放延迟或中断
- 原因为 XiaoMusic 需拦截小爱音箱的对话记录,存在约 1 秒延迟^2^5。
- 若音箱自动恢复播放,需使用“关机”指令彻底停止^2。
2. 格式兼容性
- 部分型号(如 L05B、L05C)不支持 FLAC 格式,建议优先使用 MP3^5^8。
3. 代理配置
- 使用 YouTube 源时需设置代理(如 `XIAOMUSIC_PROXY="socks5://127.0.0.1:1080"`)^6^9。
4. 更新与维护
- 定期拉取最新镜像(`docker pull hanxi/xiaomusic`)以获取新功能^8^10。
---
四、总结
XiaoMusic 通过开源生态扩展了小爱音箱的音乐播放能力,尤其适合 NAS 用户和极客玩家。其灵活部署方式、多源支持及丰富的语音指令,使其成为破解平台限制的优选方案。建议参考 获取实时更新与社区支持^1^5。
|

|