小爱音箱音乐自由：XiaoMusic开源工具使用指南

你是否厌倦了对小爱音箱说"播放周杰伦的青花瓷"却得到"抱歉，这首歌暂时无法播放"的回复？现在，有了XiaoMusic开源项目，你的小爱音箱将获得前所未有的音乐播放能力。这个工具通过智能语音控制，让你能够随心播放任何歌曲，同时自动构建个人音乐库，彻底告别版权限制的困扰。

快速入门：5分钟完成部署

想要快速体验XiaoMusic的强大功能？Docker部署是最佳选择。以下是完整的配置命令：

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

部署要点解析：

• 端口配置：58090是外部访问端口，8090是容器内部服务端口
• 音乐目录：/xiaomusic_music映射到容器内的/app/music
• 配置存储：/xiaomusic_conf保存个性化设置

完成部署后，在浏览器输入 http://你的服务器IP:58090 即可进入音乐管理界面。

核心功能详解

智能语音控制

掌握这些语音口令，你就能完全掌控音乐播放：

基础播放控制：

• "播放歌曲林俊杰" - 搜索并播放指定歌手的音乐
• "单曲循环" - 开启循环播放模式
• "下一首/上一首" - 切换曲目
• "暂停播放" - 临时停止音乐

高级管理功能：

• "刷新列表" - 更新本地音乐库
• "加入收藏" - 收藏当前播放歌曲
• "播放收藏列表" - 欣赏个人收藏曲目

音乐库自动构建

当你说出"播放歌曲周杰伦"时，系统会执行以下操作：

1. 智能搜索网络音乐资源
2. 自动下载并缓存到本地
3. 立即开始流畅播放

个性化配置方案

界面主题选择

XiaoMusic提供了多种视觉主题，满足不同用户需求：

主题名称	设计风格	适用场景
Pure主题	现代简约	日常使用
Tailwind主题	响应式设计	多设备适配
XPlayer主题	专业播放器	深度用户

配置文件定制

通过简单的JSON配置，你可以实现高度个性化设置：

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

配置技巧分享：

• 开启convert_to_mp3确保格式兼容性
• 根据设备型号调整compatibility_mode设置
• 定期备份配置文件以防意外丢失

实用操作技巧

批量导入音乐方法

想要快速建立个人音乐库？试试这个高效流程：

1. 将现有音乐文件复制到music目录
2. 对小爱音箱说"刷新列表"
3. 立即享受专属音乐收藏

故障排查指南

常见问题解决方案：

• 设备连接失败：检查局域网连通性，确认防火墙设置
• 播放无声音：验证设备兼容性设置，尝试切换播放模式
• 歌曲搜索失败：检查网络连接，确认搜索关键词准确性

安全使用建议

为确保账号安全，请遵循以下原则：

• 使用专用的小米子账号而非主账号
• 设置复杂的访问密码
• 定期查看系统运行日志

技术架构解析

XiaoMusic基于Python技术栈构建，采用模块化设计：

• 后端核心：Python + FastAPI框架
• 音乐下载：集成yt-dlp工具
• 容器化部署：Docker支持一键运行

功能扩展机制

通过插件系统，你可以轻松扩展个性化功能：

"user_key_word_dict": {
    "自定义指令": "exec#code1(\"参数\")",
    "网络操作": "exec#httpget(\"URL地址\")"
}

最佳实践总结

经过大量用户验证，以下配置组合效果最佳：

1. 基础设置：账号绑定 + 设备选择
2. 高级配置：格式转换 + 兼容模式
3. 安全防护：密码保护 + 日志监控

XiaoMusic不仅解决了小爱音箱的音乐播放限制，更带来了智能语音控制的完整音乐体验。从经典老歌到最新热门，从个人收藏到智能推荐，你的音乐世界从此无限扩展。

现在就动手尝试，开启你的智能音乐新篇章！