3步解锁小爱音箱全功能：给音乐爱好者的XiaoMusic工具使用指南

清晨唤醒你的不应是刺耳的闹钟，而应是舒缓的轻音乐；周末午后陪伴你的不该是版权受限的提示音，而是你最爱的专辑。但现实是，当你对着小爱音箱说"播放周杰伦的歌"，得到的往往是"抱歉，该歌曲暂无版权"。XiaoMusic的出现，正是为了打破这种限制，让你的智能音箱真正智能起来。

问题引入：当智能音箱不再智能

李女士的经历或许你也感同身受：双十一刚入手的小爱音箱，本想让它成为家庭背景音乐中心，却发现想听的歌十首有八首提示"版权受限"。"我已经是某音乐平台会员了，为什么还不能在自己的音箱上听？"这是她在社区论坛上的无奈提问。

张先生则遇到了另一种困扰：作为古典音乐爱好者，他收藏的大量FLAC无损音乐无法通过小爱音箱播放，"只能把手机连音箱蓝牙，失去了语音控制的便利性，那我买智能音箱的意义何在？"

这些问题的根源在于商业音乐服务的版权壁垒与硬件厂商的生态限制。而XiaoMusic通过本地音乐库管理与智能语音控制的结合，为这些问题提供了全新的解决方案。

核心价值：为什么选择XiaoMusic

与传统音乐播放方式相比，XiaoMusic带来了三个革命性的改变：

1. 打破版权枷锁
不再受限于单一音乐平台的版权库，通过自建本地音乐库，想听什么就听什么，告别"暂未收录"的尴尬。

2. 全格式兼容播放
支持MP3、FLAC、WAV等多种音乐格式，无论是收藏的无损音乐还是下载的现场录音，都能流畅播放。

3. 保留智能交互体验
在实现自由播放的同时，完整保留小爱音箱的语音控制功能，真正做到"解放双手，随心聆听"。

图：XiaoMusic操作界面展示，包含设备控制、播放列表和音乐管理功能区

实施路径：三步完成安装部署

准备工作

在开始部署前，请确保你已准备好：

• 一台可以运行Docker的设备（电脑、NAS或树莓派均可）
• 稳定的网络环境
• 至少10GB的存储空间（用于存储音乐文件）
• 小米账号及小爱音箱

第一步：获取项目代码

打开终端，执行以下命令克隆项目仓库：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
cd xiaomusic

第二步：配置环境

复制并修改配置文件：

cp config-example.json config.json

用文本编辑器打开config.json，填入你的小米账号信息：

{
  "account": "你的小米账号",
  "password": "你的小米密码",
  "music_path": "music",
  "convert_to_mp3": false
}

💡 技巧提示：如果你的网络环境不佳，建议将"convert_to_mp3"设为true，可以减少音乐文件体积，加快加载速度。

第三步：启动服务

使用Docker Compose快速启动：

docker-compose up -d

服务启动后，在浏览器中访问http://你的设备IP:58090即可打开XiaoMusic管理界面。

⚠️ 注意事项：首次启动需要等待几分钟，系统会自动下载必要的依赖组件。如果访问失败，请检查防火墙设置是否允许58090端口通过。

场景应用：从基础到进阶的使用指南

基础操作：打造你的个人音乐库

1. 添加音乐
   通过管理界面的"上传"功能添加本地音乐，或使用"在线搜索"功能查找并下载网络音乐。

2. 语音控制
   直接对小爱音箱说：

   • "小爱同学，播放王菲的歌"
   • "小爱同学，下一首"
   • "小爱同学，音量调到50%"

3. 设备管理
   在管理界面左侧"小爱设备控制"中，可以切换控制不同的小爱音箱设备。

图：XiaoMusic音乐库管理界面，展示歌曲列表和分类标签

实用技巧：提升使用体验

• 创建播放列表：将不同场合的音乐分类，如"晨跑音乐"、"工作专注"、"睡前放松"
• 收藏喜爱歌曲：听到喜欢的歌曲，说"小爱同学，收藏这首歌"，方便以后快速找到
• 定时关闭：设置睡眠定时器，让音乐在你入睡后自动关闭

创意玩法：拓展应用场景

• 起床闹钟：设置"早上好"自定义指令，自动播放晨间新闻和活力音乐
• 派对模式：通过语音指令切换到派对模式，自动播放预设的动感歌单
• 亲子互动：创建儿童歌曲列表，通过语音控制播放儿歌和故事

图：XiaoMusic控制面板交互演示，展示设备切换和播放控制功能

进阶优化：故障排除与个性化配置

常见问题解决

症状	可能原因	解决方案
无法连接小爱音箱	网络环境变化	重启路由器和音箱，检查账号登录状态
音乐播放卡顿	网络带宽不足	开启MP3转换功能，降低文件质量
语音指令无响应	设备未正确绑定	在管理界面重新扫描并绑定设备

个性化配置

通过修改config.json文件，你可以进一步定制XiaoMusic：

• 自定义语音指令：

"user_key_word_dict": {
  "开始工作": "exec#code1(\"播放工作歌单\")",
  "电影时间": "exec#code1(\"播放电影原声\")"
}

• 设置默认播放设备：

"default_device": "客厅的小爱音箱"

💡 高级技巧：定期执行update-holiday.sh脚本，可以获取最新的节假日信息，让XiaoMusic在特殊节日自动播放应景音乐。

实用场景组合建议

• 晨间唤醒组合：定时播放+新闻播报+天气提醒
• 工作学习组合：专注音乐+番茄钟+定时休息提醒
• 家庭聚会组合：语音点歌+随机播放+音量自动调节

通过这些组合，XiaoMusic不仅是一个音乐播放器，更能成为你生活中的智能助手。

无论是音乐爱好者、智能家庭用户还是技术探索者，XiaoMusic都能为你带来全新的音乐体验。它不仅解决了当下智能音箱的音乐播放限制，更开创了个性化音乐管理的新方式。现在就开始你的无限制音乐之旅吧！记住，最好的音乐体验，应该是自由且智能的。