Xiaomusic终极部署手册：三分钟快速搭建智能音乐播放系统

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/xiaomusic

Docker 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