如何用Xiaomusic打造智能音箱自定义播放系统？5个步骤开启本地音乐自由

当你对着智能音箱说出"播放周杰伦的歌"却只得到"版权受限"的回应时；当你精心收藏的无损音乐无法通过语音控制播放时；当家庭聚会想让音乐无缝衔接却需要手动操作手机时——这些尴尬场景是否让你对智能音箱的"智能"产生怀疑？Xiaomusic作为一款开源音乐解决方案，正是为解决这些痛点而生。这个基于Python开发的智能音乐系统，通过集成yt-dlp工具实现音乐下载功能，让零基础用户也能在5分钟内搭建专属的本地音乐中心，彻底释放智能音箱的播放潜力。

家庭音乐中心搭建：从设备到系统的进化之路

传统音乐播放方式正面临三重困境：智能音箱受限于平台版权库，手机蓝牙连接音质损耗严重，本地音乐库缺乏统一管理。Xiaomusic通过"本地存储+语音控制"的创新模式，构建了更自由的音乐体验。想象一下，周末早晨无需唤醒手机，只需对小爱音箱说"播放昨天收藏的轻音乐"，系统就会自动从你的本地音乐库调取文件——这正是Xiaomusic带来的生活变革。

图：Xiaomusic控制界面标注图，红色框为播放控制区，绿色箭头指示设备切换按钮，黄色区域为小爱音箱控制面板

零基础部署：像烹饪一样简单的安装流程

准备工作：食材就绪

在开始部署前，请确认你的"厨房"已备好这些"食材"：

• 运行Docker的设备（如NAS、树莓派或普通电脑）
• 至少5GB可用存储空间（音乐文件会占用较多空间）
• 稳定的网络连接（用于拉取镜像和音乐下载）
• 小米账号及小爱音箱设备

执行部署：按步骤烹饪

打开终端，输入以下命令启动Docker容器，就像按照食谱步骤添加原料：

docker run -p 58090:8090 \  # 端口映射，格式为"主机端口:容器端口"
  -e XIAOMUSIC_PUBLIC_PORT=58090 \  # 公开访问端口，需与主机端口保持一致
  -v /xiaomusic_music:/app/music \  # 音乐文件存储目录，冒号前替换为你的本地路径
  -v /xiaomusic_conf:/app/conf \  # 配置文件目录，冒号前替换为你的本地路径
  hanxi/xiaomusic  # Docker镜像名称

⚠️ 注意：两个-v参数后的本地路径需要替换为你设备上的实际目录，例如Windows系统可能是C:/xiaomusic/music，Linux系统可能是/home/user/xiaomusic/music。

验证结果：品尝成果

容器启动后，打开浏览器访问http://你的设备IP:58090，看到登录界面即表示部署成功。首次访问可能需要等待30秒左右，系统正在初始化配置文件。

语音控制设置指南：让音箱听懂你的指令

基础配置三要素

1. 账号绑定：在设置页面输入小米账号密码，这是系统控制小爱音箱的关键钥匙
2. 设备选择：从自动扫描出的设备列表中选择你的小爱音箱，支持同时绑定多个设备
3. 权限授权：根据提示完成米家APP的授权操作，确保系统能获取设备控制权

场景化语音指令示例

周末家庭聚会场景：

• "小爱同学，播放周杰伦的晴天" — 系统自动搜索并播放歌曲
• "小爱同学，下一首" — 切换到歌单中的下一首
• "小爱同学，音量调大到50%" — 精确控制播放音量

晚间休息场景：

• "小爱同学，播放收藏的轻音乐" — 调取收藏列表中的特定分类
• "小爱同学，15分钟后停止播放" — 设置睡眠定时关闭
• "小爱同学，单曲循环这首" — 重复播放当前歌曲

图：Xiaomusic本地音乐管理界面，显示已扫描的音乐文件列表，支持按全部/收藏/下载等分类筛选

常见场景配置：让音乐系统更懂生活

儿童模式设置

家里有小朋友？通过"设置-播放限制"开启儿童模式，系统会自动过滤不适宜内容，并限制单次播放时长。配合语音命令"小爱同学，开启儿童模式"，让孩子安全听音乐。

定时播放计划

在"系统-定时任务"中设置晨间唤醒曲：每天7:00自动播放轻音乐，音量从低到高渐变，让你在舒缓中自然醒来。还支持节假日特殊安排，周末自动推迟播放时间。

歌单自动化管理

通过"工具-歌单同步"功能，将网易云音乐、QQ音乐的歌单链接导入系统，自动下载缺失歌曲。设置每周日晚8点自动更新歌单，保持音乐库新鲜感。

进阶技巧：释放系统全部潜力

音乐格式转换

系统默认支持mp3、flac、wav等主流格式，若遇到特殊格式文件，可在"设置-媒体处理"中开启自动转码功能，系统会在后台将非常规格式转换为mp3，确保所有音乐都能正常播放。

多设备协同播放

通过"设备组管理"功能，将多个小爱音箱组成立体声系统。在客厅、卧室各放置一个音箱，实现全屋音乐覆盖，营造沉浸式听觉体验。

数据备份与迁移

定期备份/xiaomusic_conf目录下的配置文件，包含账号信息、播放记录和自定义设置。更换设备时，只需将备份文件复制到新部署的系统中，即可无缝迁移所有配置。

从受限于平台版权的被动听歌，到掌控音乐库的主动享受，Xiaomusic为智能音箱用户打开了一扇新大门。这个开源项目不仅提供了技术解决方案，更重新定义了人与音乐的交互方式。无论是音乐爱好者、智能家居玩家还是普通家庭用户，都能通过这套系统找到属于自己的音乐自由。现在就动手部署，让你的小爱音箱成为真正懂你的音乐管家。