XiaoMusic 小爱音箱音乐播放完整指南Docker 部署、语音口令与本地曲库配置【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个开源的个人音乐服务器用于让小爱音箱播放你自己的音乐支持用 yt-dlp 下载网络歌曲后端基于 Python FastAPI。适合家里有一台 NAS 或闲置电脑、又有一台及以上小爱音箱的用户部署完成后你可以通过语音口令让音箱播放本地曲库和在线搜索到的歌曲摆脱内置曲库的限制。小爱音箱能做什么XiaoMusic 能力清单内置音箱的曲库由平台决定格式和歌单选择也很有限XiaoMusic 把播放源换成你自己的。装好之后你可以用这些能力语音口令控制说「播放歌曲周杰伦晴天」「下一首」「上一首」「随机播放」「加入收藏」等即可操控播放网络歌曲搜索口令里带上歌名会先用 yt-dlp 下载再播放例如「播放歌曲小猪佩奇的故事」本地曲库扫描指定目录支持 mp3、flac、wav、ape、ogg、m4a 六种格式歌单管理按目录生成歌单支持「播放歌单目录名」也支持配置 json 格式的网络歌单电台歌曲Web 后台歌曲分类全部/所有歌曲/收藏/下载、在线搜索、多设备切换、账号与高级设置多型号支持L05B、L05C、L06A、L07A、LX06、Xiaomi Sound、X08C、OH2 等型号均已测试对比项内置音箱接入 XiaoMusic 后音乐来源平台合作曲库本地目录 yt-dlp 在线搜索音频格式以 mp3 为主mp3 / flac / wav / ape / ogg / m4a歌单平台推荐按目录生成 收藏 网络歌单语音口令固定指令播放歌曲 / 播放歌手 / 播放歌单等可扩展口令部署位置云端自建在 NAS 或家用主机Docker 部署步骤从创建目录到访问 Web 后台第 1 步创建音乐与配置目录。mkdir -p /xiaomusic_music /xiaomusic_conf这两个目录分别存放音乐文件和配置建议分开。执行后目录即就绪下一步拉取并启动容器。第 2 步启动 Docker 容器。docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic国内网络拉取镜像困难时可将镜像换成docker.hanxi.cc/hanxi/xiaomusic再执行同一条命令。执行后容器开始启动端口 58090 为宿主机端口8090 是容器端口二者都不要改动。第 3 步打开 Web 后台。浏览器访问http://你的主机IP:58090进入设置页面。启动成功后即可看到 Web 控制台下一步是登录小米账号。第 4 步登录小米账号并绑定音箱。在「账号设置」中填入小米账号和密码并保存随后「小爱设备控制」里就会出现设备列表选择你的音箱即可。保存账号后设备列表才会加载这一步完成后即可进入功能验证。验证功能5 项快速检查清单部署完成后按下面清单逐项验证核心功能是否可用后台设备列表能看到你的音箱并且能选中它对音箱说「播放歌曲周杰伦晴天」音箱先下载后播放说「下一首」「上一首」「随机播放」「单曲循环」播放状态随之切换说「加入收藏」再到后台「收藏」分类下确认歌曲已加入把本地音乐放进/xiaomusic_music确认目录扫描后能在「所有歌曲」中找到常见问题与避坑问保存小米账号后看不到设备列表答一般是登录失败。常见原因是开了代理关闭代理或在米家 App 退出后重新登录、到小米官网重新登录通常能解决NAS 用户可把容器网络从 bridge 改为 host 再试。问网页能播放但语音口令无效答语音口令功能默认关闭需要去设置页面打开「获取对话记录」开关主页上的「语音口令」。另外注意默认口令前缀是「播放歌曲」直接说「播放音乐」是不识别的。问flac 格式无法播放答已知 L05B、L05C、LX06、L16A 等型号不支持 flac。可在后台打开「转换为 MP3」和「型号兼容模式」或提前批量转成 mp3。问docker 镜像拉取失败答国内网络常见可更换镜像源或使用 DaoCloud 公共镜像执行docker pull m.daocloud.io/docker.io/hanxi/xiaomusic:latest后再打标签使用。行动建议按上面的步骤完成 Docker 部署打开 Web 后台登录小米账号说几条语音口令验证播放、切换与收藏功能把你的本地音乐目录挂进去扫描后建好歌单遇到设备型号不被识别或功能异常欢迎在 issues 中反馈你的型号与日志社区的问题集合docs/issues/99.md收录了大量现成解法。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考