零基础如何用Xiaomusic打造智能音乐播放系统？5分钟入门指南

Xiaomusic是一款基于Python开发的智能音乐播放系统，通过集成yt-dlp工具实现音乐下载功能，让你可以轻松控制小爱音箱播放任意歌曲。无论是本地音乐还是在线音乐，都能通过简单的小爱语音命令进行控制，彻底解放你的双手。

📋 准备工作：系统安装要求

在开始安装Xiaomusic之前，请确保你的设备满足以下基本要求：

• 拥有一台运行Docker的设备（如NAS、树莓派或普通电脑）
• 稳定的网络连接
• 小爱音箱设备
• 小米账号

🚀 快速部署：Docker一键安装

使用Docker安装是最简单的部署方式，只需一行命令即可完成：

docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

启动成功后，在浏览器访问 http://你的设备IP:58090 就能看到Xiaomusic的控制界面。

界面概览：认识Xiaomusic控制面板

Xiaomusic提供了直观的Web控制界面，让你可以轻松管理音乐播放和设备设置：

界面主要分为几个功能区域：

• 左侧导航栏：设备控制、播放列表、账号设置等
• 中间区域：歌曲搜索和播放列表
• 底部控制栏：播放控制、进度调节和音量控制

🎵 核心功能：Xiaomusic能做什么

语音控制：解放双手的便捷操作

Xiaomusic支持丰富的小爱语音口令，让你彻底告别手动操作：

• "播放歌曲周杰伦晴天" - 直接播放指定歌曲
• "上一首"/"下一首" - 切歌操作
• "单曲循环"/"全部循环" - 播放模式切换
• "刷新列表" - 更新本地歌单
• "加入收藏" - 收藏当前播放歌曲

本地音乐管理：自动识别多种格式

系统会自动扫描本地音乐文件，支持mp3、flac、wav、ape、ogg、m4a等多种音频格式。你可以通过Web界面轻松管理你的音乐库：

播放列表管理：个性化你的音乐体验

Xiaomusic提供了灵活的播放列表管理功能，你可以创建多个播放列表，收藏喜欢的歌曲，以及导入m3u格式的电台文件：

⚙️ 基础配置：快速上手步骤

1. 访问Web界面

启动Docker容器后，在浏览器中输入 http://你的设备IP:58090 访问Xiaomusic控制界面。

2. 账号设置

在左侧导航栏中选择"账号设置"，输入你的小米账号和密码，点击保存。

3. 设备选择

在"小爱设备控制"中，系统会自动识别你的小爱音箱设备。选择你想要使用的设备作为默认播放设备。

4. 开始使用

完成上述设置后，你就可以开始使用语音命令控制音乐播放了。试着对小爱音箱说"播放歌曲"，体验Xiaomusic带来的便捷音乐体验。

💡 场景应用：Xiaomusic的实用场景

家庭聚会音乐播放

通过语音命令轻松控制音乐播放，无需手动操作，让你专注于与家人朋友的互动。

早晨唤醒服务

设置定时播放功能，让你喜欢的音乐在每天早晨准时响起，开启美好的一天。

工作学习背景音乐

通过语音命令轻松切换音乐，打造适合工作学习的音乐环境。

❓ 常见问题：你可能想知道的

Q: 设备无法识别怎么办？

A: 尝试重启Docker容器，或检查小米账号是否正确登录。

Q: 支持哪些音频格式？

A: 支持mp3、flac、wav、ape、ogg、m4a等多种常见音频格式。

Q: 如何更新Xiaomusic？

A: 可以通过Docker命令更新镜像：docker pull hanxi/xiaomusic，然后重启容器。

Q: 可以在多台设备上使用吗？

A: 是的，Xiaomusic支持多设备管理，你可以在Web界面中切换不同的小爱音箱设备。

🛠️ 进阶设置：自定义你的音乐体验

修改默认下载路径

编辑配置文件 config-example.json，修改音乐下载路径。

配置定时任务

通过 crontab.py 文件设置自动播放计划，实现定时播放功能。

安装插件扩展功能

Xiaomusic支持插件扩展，你可以在 plugins/ 目录下找到相关插件，或开发自己的插件。

🎯 为什么选择Xiaomusic？

Xiaomusic相比其他音乐播放方案具有明显优势：

• 完全免费 - 开源项目，无任何费用
• 安装简单 - 5分钟快速部署
• 语音控制 - 彻底解放双手
• 格式丰富 - 支持主流音频格式
• 持续更新 - 活跃的开发者社区

无论你是音乐爱好者还是智能家居玩家，Xiaomusic都能为你带来全新的音乐体验。现在就开始动手，搭建属于你自己的智能音乐系统吧！