小米音乐助手LX06播放问题排查指南

小米音乐助手LX06播放问题排查指南

xiaomusic 使用小爱同学播放音乐，音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic

小米音乐助手项目是一个基于Docker的开源项目，旨在为小米智能音箱提供更丰富的音乐播放功能。本文将针对LX06型号音箱无法播放音乐的问题，提供全面的排查思路和解决方案。

环境配置要点

在部署小米音乐助手时，环境变量的正确配置至关重要。以下是关键配置项的说明：

1. 音箱型号设置：MI_HARDWARE参数需设置为LX06，确保与设备型号匹配
2. 认证信息：MI_USER和MI_PASS需要填写有效的小米账号
3. 设备标识：MI_DID应填写正确的设备ID（如570068003）
4. 搜索源配置：通过XIAOMUSIC_SEARCH指定音乐来源（如ytsearch:或bilisearch:）

常见问题排查

1. 日志分析技巧

当遇到播放问题时，首先需要检查容器日志。关键日志信息包括：

• 搜索请求是否成功（如searchmusic记录）
• 播放命令是否被接收（docmd记录）
• 网络连接状态（如代理设置XIAOMUSIC_PROXY是否生效）

2. 后台配置保存

许多用户容易忽略后台配置界面的保存操作。配置修改后必须：

1. 滚动到页面底部
2. 找到并点击保存按钮
3. 等待配置生效（可能需要重启服务）

3. 网络连接验证

确保以下网络配置正确：

• 宿主机IP（XIAOMUSIC_HOSTNAME）可被音箱访问
• 代理设置（如有）有效且可连接
• 端口映射（如30002）未被防火墙阻挡

解决方案

针对LX06播放无响应的问题，建议按以下步骤处理：

1. 简化配置：先使用最基本的环境变量（账号、设备ID和型号）
2. 逐步添加：确认基础功能正常后，再添加搜索源、代理等高级配置
3. 日志监控：开启详细日志（XIAOMUSIC_VERBOSE: true）观察每个环节
4. 设备重启：有时需要重启音箱设备使配置生效

最佳实践

1. 版本控制：使用明确的镜像版本（如hanxi/xiaomusic:0.3.46）
2. 数据持久化：正确挂载音乐目录（如/mydata/music/:/app/music）
3. 配置分离：将配置文件单独挂载（如./conf/ciwo:/app/conf）
4. 健康检查：定期通过/playingmusic接口验证服务状态

通过以上方法，大多数LX06播放问题都能得到有效解决。如仍遇到困难，建议收集完整日志进一步分析。

xiaomusic 使用小爱同学播放音乐，音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic