让小爱音箱轻松播放本地音乐：XiaoMusic高效使用指南

XiaoMusic是一款专为小爱音箱设计的开源工具，它能让你轻松突破智能音箱的音乐播放限制，将NAS或本地存储的音乐库无缝连接到小爱音箱，实现真正的音乐自由。无论是珍藏的无损音乐还是稀有曲目，都能通过简单设置让小爱音箱轻松播放，打造专属于你的智能音乐中心。

核心功能解析：为何选择XiaoMusic

突破生态限制的音乐自由

传统智能音箱往往局限于特定音乐平台，而XiaoMusic打破了这一壁垒，让你完全掌控自己的音乐资源。通过本地服务架构，无论是NAS中的无损音乐还是电脑里的个人收藏，都能直接通过小爱音箱播放，无需上传云端，保持音乐的原始音质。

零成本构建家庭音乐系统

无需额外购买硬件，XiaoMusic将你的现有设备转变为功能强大的音乐服务中心。通过软件创新，实现低成本高回报的音乐体验升级，让普通家庭也能享受专业级的音乐管理服务。

本地处理保障隐私安全

与云端音乐服务不同，XiaoMusic在本地网络内完成所有音乐处理和传输，既避免了音质压缩损失，又确保个人音乐收藏的隐私安全，无需担心数据泄露或版权问题。

快速部署方案：两种安装方式任你选

Docker容器化部署（推荐新手）

Docker方式提供隔离、便捷的部署体验，只需简单几步即可完成：

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

参数说明：

• -p 58090:8090：端口映射，将容器内8090端口映射到主机58090端口
• -e XIAOMUSIC_PUBLIC_PORT=58090：设置外部访问端口
• -v /xiaomusic_music:/app/music：挂载本地音乐目录到容器内
• -v /xiaomusic_conf:/app/conf：挂载配置文件目录

启动后访问http://localhost:58090即可进入Web控制台完成初始化设置。

手动部署（适合技术爱好者）

如果你喜欢自定义配置，可以选择手动部署：

1. 克隆项目仓库：

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

2. 进入项目目录并安装依赖：

cd xiaomusic
./install_dependencies.sh

3. 复制配置文件模板并修改：

cp config-example.json config.json
nano config.json

4. 启动服务：

python xiaomusic.py

配置要点：确保"music_path"指向你的音乐目录，"server_ip"设置为本地网络可访问的IP地址。

高效使用技巧：打造个性化音乐体验

熟悉Web控制台功能

XiaoMusic提供直观的Web界面，让你轻松管理音乐库和设备。控制台包含设备控制、播放列表管理、账号设置和系统配置等功能，简单点击即可完成复杂操作。

图：XiaoMusic控制面板界面，展示了设备控制、播放列表和音乐管理功能

音乐库智能管理

掌握以下技巧可提升音乐管理效率：

• 多维度分类：通过"全部"、"所有歌曲"、"收藏"和"下载"等标签快速筛选音乐
• 批量操作：支持多选歌曲进行批量添加到播放列表或删除
• 元数据编辑：手动修改歌曲信息，确保语音识别准确性
• 定时更新：定期使用"刷新音乐库"功能保持音乐列表最新

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

实用语音指令大全

彻底解放双手，用语音指令控制音乐播放：

• "小爱同学，打开本地音乐" - 启动XiaoMusic服务
• "小爱同学，播放我喜欢的歌" - 播放收藏列表
• "小爱同学，切换到周杰伦的歌" - 按歌手筛选播放
• "小爱同学，音量调到50%" - 精确控制音量
• "小爱同学，重复这首歌" - 开启单曲循环

进阶技巧：结合小爱音箱的场景模式，设置"睡前音乐"等自动化播放任务，让音乐成为生活的一部分。

常见问题解决：让播放更顺畅

网络连接故障排查

当音箱无法连接到XiaoMusic服务时，按以下步骤诊断：

1. 基础检查：确认设备在同一网络，服务已启动
2. 端口测试：使用telnet [服务器IP] 58090检查端口连通性
3. 防火墙配置：确保58090端口在防火墙中开放
4. IP验证：在Web控制台确认显示的IP与实际服务器IP一致

播放问题解决方案

遇到播放问题时，可按以下流程排查：

1. 确认服务是否正常运行，如未运行则启动服务
2. 检查网络连接是否正常，必要时重启路由器
3. 验证音乐文件是否可访问，检查文件权限设置
4. 确认音乐格式是否支持，FLAC等无损格式可能需要转换为MP3
5. 尝试重启服务和音箱，多数问题可通过此方式解决

性能优化建议

针对不同使用场景，可进行以下优化：

• 索引优化：对于超过1000首歌曲的大型库，定期执行完整索引
• 网络增强：在路由器中为XiaoMusic服务器设置固定IP和QoS优先级
• 缓存设置：适当增大缓存大小，提升频繁播放歌曲的响应速度
• 定期更新：通过git pull获取最新代码，享受功能改进和问题修复

设备兼容性说明

XiaoMusic已测试支持以下小爱音箱型号：

• 小爱音箱Pro (LX06)
• 小米AI音箱 (第二代)
• Xiaomi Sound Pro
• 小爱音箱Play
• 小爱音箱Art
• 小爱音箱HD

部分旧型号音箱可能存在功能限制，建议通过项目issue反馈设备兼容性问题，获取技术支持。

通过XiaoMusic，你可以轻松打造专属的家庭音乐中心，让小爱音箱发挥更大潜力。无论是珍藏的音乐收藏还是日常的音乐享受，XiaoMusic都能为你提供便捷、高效的播放体验，让音乐自由触手可及。随着项目的持续发展，更多功能和设备支持将不断加入，为你的音乐生活带来更多可能性。