如何5分钟搭建个人音乐中心：小爱音箱终极玩法指南
【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
还在为音乐会员烦恼？想不想让小爱音箱变成你的专属音乐播放器？xiaomusic项目让你轻松实现这个梦想！这是一个基于Docker的开源项目，能够将小爱音箱变成功能强大的个人音乐中心，支持语音控制播放本地音乐和在线下载歌曲。
🎯 为什么选择xiaomusic？
告别音乐会员限制：通过yt-dlp技术，你可以下载任意平台的音乐到本地，再也不用担心会员到期无法听歌的问题。
解放小爱音箱潜能：你的小爱音箱不仅能播放在线音乐，还能播放本地存储的歌曲，真正实现音乐自由。
简单易用的部署方式：无论你是技术小白还是资深玩家，都能快速上手。
📦 快速部署指南
Docker一键部署
最简单的部署方式就是使用Docker，只需要一条命令就能启动：
docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic重要配置说明：
58090:8090：将容器端口映射到本地端口/xiaomusic_music：音乐文件存放目录/xiaomusic_conf：配置文件存放目录
配置步骤详解
创建必要目录：
mkdir -p /xiaomusic_{music,conf}访问管理界面： 打开浏览器，输入
http://你的IP地址:58090就能看到管理界面绑定小米账号： 首次使用需要在设置页面输入小米账号和密码，系统会自动获取你的小爱音箱设备列表
🎵 核心功能展示
语音控制播放
xiaomusic支持丰富的语音指令，让你的音乐体验更加智能：
- 播放歌曲：播放本地所有歌曲
- 播放歌曲+歌名：如"播放歌曲周杰伦晴天"
- 上一首/下一首：切换歌曲
- 单曲循环/全部循环/随机播放：多种播放模式
- 加入收藏/取消收藏：个性化歌单管理
动态菜单交互
通过动态菜单，你可以轻松：
- 展开/收起设备控制面板
- 切换不同的小爱音箱设备
- 管理下载歌曲列表
🔧 高级配置技巧
多设备支持
xiaomusic已经测试支持多种小爱音箱型号，包括：
- 小爱音箱Play系列
- 小米AI音箱系列
- 触屏版音箱
- Sound Pro高端型号
音乐格式兼容
支持主流的音频格式：
- MP3、FLAC、WAV
- APE、OGG、M4A
贴心提醒：部分型号可能不支持FLAC格式，遇到这种情况可以开启"转换为MP3"选项。
🚀 实用功能扩展
网络歌单功能
你可以配置JSON格式的网络歌单，支持电台和歌曲播放。项目还提供了m3u文件格式转换工具，方便导入各种歌单。
开发环境搭建
如果你想参与项目开发，可以使用以下方式：
# 使用PDM管理开发环境 pdm run xiaomusic.py💡 新手常见问题
部署失败怎么办？
- 检查端口是否被占用
- 确认目录权限是否正确
- 查看Docker日志排查问题
语音指令不生效？
- 确保小爱音箱和部署设备在同一网络
- 检查小米账号绑定是否成功
- 确认音乐文件是否已放入指定目录
📊 项目特色亮点
开源免费：完全免费使用，代码公开透明持续更新：项目活跃，功能不断丰富社区支持：遇到问题可以在官方交流群寻求帮助
🎉 开始你的音乐之旅
现在就开始搭建属于你的个人音乐中心吧！只需要5分钟，你就能享受到：
- 无限量的音乐资源
- 智能的语音控制体验
- 个性化的歌单管理
记住，音乐应该是自由的，而不是被会员制度束缚。xiaomusic让你重新掌握音乐的控制权！
温馨提示：请遵守相关法律法规，合理使用音乐资源。
【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
