Xiaomusic终极部署手册：三分钟快速搭建智能音乐播放系统
【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
Xiaomusic是一款专为小爱音箱设计的开源音乐播放工具，通过yt-dlp技术实现海量音乐资源下载，让你彻底释放智能音箱的音频播放潜力。本指南将提供最简洁高效的安装方案，即使是零基础用户也能快速上手。
🎯 核心功能亮点
- 智能音乐下载：基于yt-dlp自动获取高质量音频
- 多设备协同：支持多种小爱音箱型号同时控制
- 语音指令操控：支持播放、暂停、收藏等丰富语音命令
- 跨平台支持：Windows、Linux、macOS全面兼容
🐳 Docker一键部署方案
基础环境配置
首先创建必要的目录结构：
mkdir -p /xiaomusic_music /xiaomusic_conf标准Docker启动命令
docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusicDocker Compose生产级配置
创建docker-compose.yml文件：
services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - 58090:8090 environment: XIAOMUSIC_PUBLIC_PORT: 58090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf启动服务：
docker compose up -d容器部署要点解析
- conf目录：存储配置文件，包括账号信息和设备设置
- music目录：存放下载和本地音乐文件
- 端口映射：58090为外部访问端口，8090为容器内部端口
🐍 Python原生安装方式
pip快速安装
pip install -U xiaomusic xiaomusic --config config.json源码编译安装
git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic pip install -r requirements.txt python xiaomusic.py⚙️ 系统初始化配置
配置文件准备
复制配置文件模板：
cp config-example.json config.json关键参数设置
编辑config.json文件，重点配置以下参数：
- 小米账号密码：用于获取设备列表和播放控制
- 设备型号选择：根据你的小爱音箱型号进行匹配
- 下载路径确认：确保music目录有足够存储空间
🎮 控制面板快速上手
部署完成后，在浏览器中访问http://你的服务器IP:58090即可进入控制界面。
界面功能分区详解
- 左侧菜单：设备控制、播放列表、账号设置等核心功能
- 顶部导航：分类筛选和设备切换控制
- 播放控制区：进度条、循环模式、音量调节等操作
🗣️ 语音指令大全
基础播放控制
- "播放歌曲" - 播放本地歌曲
- "播放歌曲+歌名" - 如"播放歌曲周杰伦晴天"
- "上一首" / "下一首" - 切换曲目
- "单曲循环" / "全部循环" / "随机播放" - 切换播放模式
列表管理指令
- "播放列表+列表名" - 如"播放列表其他"
- "加入收藏" / "取消收藏" - 管理个人收藏
- "刷新列表" - 更新本地歌曲库
🔧 故障排除指南
常见问题解决方案
端口冲突处理：
docker run -p 8080:8090 -e XIAOMUSIC_PUBLIC_PORT=8080 ...网络连接异常：
- 确认小爱音箱与部署设备在同一局域网
- 检查防火墙设置是否阻止端口访问
📋 设备兼容性列表
已测试支持型号
- L06A 小爱音箱
- L07A Redmi小爱音箱 Play
- LX05 小爱音箱Play（2019款）
- L16A Xiaomi Sound
- 各类触屏版本设备
🎵 音频格式支持
系统原生支持MP3、FLAC、WAV、APE、OGG、M4A等主流音频格式，确保你的音乐文件能够正常播放。
🛡️ 安全使用须知
- 公网部署时务必开启密码登录
- 避免在公共WiFi环境下使用
- 不建议将播放账号与摄像头设备绑定
通过本指南，你已掌握Xiaomusic的核心部署技能。无论是选择Docker的便捷部署还是Python的灵活安装，都能让你快速享受到智能音箱带来的音乐盛宴。
【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
