XiaoMusic：让小爱音箱播放本地音乐的3个实用方法

XiaoMusic：让小爱音箱播放本地音乐的3个实用方法

【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

XiaoMusic是一款专为小爱音箱系列设备设计的开源工具，核心解决NAS存储的本地音乐无法被小爱音箱识别播放的问题，特别适合拥有大量本地音乐库且希望通过智能音箱便捷播放的用户。通过智能下载和本地管理功能，它架起了本地音乐与智能音箱之间的桥梁，让你摆脱音乐播放的限制。

如何理解XiaoMusic的工作原理

音乐传输的"翻译官"角色

想象你有一个装满CD的音乐收藏室（NAS存储），而小爱音箱是一位只懂特定语言的朋友。XiaoMusic就像一位翻译官，它能将NAS中的音乐文件"翻译"成小爱音箱能理解的格式和协议，让音箱能够准确找到并播放你想要的音乐。

本地与云端的智能协作

XiaoMusic采用"本地存储+智能代理"的工作模式。它在本地网络中建立一个小型服务中心，当你通过语音指令让小爱音箱播放音乐时，音箱会先与这个服务中心通信，由服务中心从NAS中调取音乐文件并以合适的方式传输给音箱。这种方式既保证了音乐播放的稳定性，又不占用额外的云端存储空间。

[!TIP] XiaoMusic的核心优势在于它不需要修改音箱固件或破解设备，通过标准网络协议实现音乐传输，安全性和稳定性都有保障。

如何快速部署XiaoMusic服务

Docker一键部署方法

使用Docker是部署XiaoMusic最简单的方式，只需一行命令即可完成：

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：挂载配置文件目录

手动安装步骤

如果不使用Docker，也可以通过以下步骤手动安装：

1. 克隆项目仓库：

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

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

cd xiaomusic ./install_dependencies.sh

3. 启动服务：

python xiaomusic.py

基础配置要点

🔍IP地址设置：在Web控制台的设置页面中，确保"NAS IP地址"字段只填写纯IP地址，如"192.168.1.100"，不要包含端口号。

🔍目录权限检查：确保XiaoMusic有权限访问你的音乐目录，可以通过以下命令设置权限：

chmod -R 755 /path/to/your/music/directory

如何高效使用XiaoMusic管理音乐

音乐库管理技巧

XiaoMusic提供了直观的Web界面来管理你的音乐库。在控制面板中，你可以通过"全部"、"所有歌曲"、"收藏"和"下载"等分类标签快速筛选音乐。

语音控制指令大全

XiaoMusic支持丰富的语音指令，让你彻底解放双手：

• "小爱同学，播放本地音乐" - 开始播放本地歌曲
• "小爱同学，播放周杰伦的晴天" - 播放指定歌曲
• "小爱同学，下一首" - 切换到下一首歌曲
• "小爱同学，单曲循环" - 开启单曲循环模式
• "小爱同学，刷新音乐列表" - 更新音乐库

播放模式设置

在控制面板中，你可以切换不同的播放模式：

• 单曲循环：反复播放当前歌曲
• 全部循环：播放完整列表后从头开始
• 随机播放：随机顺序播放歌曲
• 顺序播放：按列表顺序播放歌曲

如何解决XiaoMusic使用中的常见问题

网络连接问题排查

如果音箱无法连接到XiaoMusic服务，可以按照以下步骤排查：

1. 检查设备是否在同一网络：确保小爱音箱和运行XiaoMusic的设备连接到同一个路由器
2. 验证IP地址和端口：确认配置的IP地址正确且端口未被防火墙阻止
3. 测试网络连通性：从音箱所在网络ping XiaoMusic服务器IP

播放失败的解决方法

⚠️文件格式不支持：XiaoMusic对MP3格式支持最好，如果遇到播放失败，尝试将音乐文件转换为MP3格式。

⚠️权限问题：确保音乐文件有正确的读取权限，特别是在Linux系统中，可以使用chmod命令修改权限。

⚠️服务未启动：检查XiaoMusic服务是否正常运行，可以通过以下命令重启服务：

# Docker方式 docker restart 容器ID # 手动启动方式 pkill -f xiaomusic.py python xiaomusic.py &

故障排除决策树

当遇到问题时，可以按照以下决策流程排查：

1. 服务是否运行？→ 否→启动服务
2. 网络是否连通？→ 否→检查网络配置
3. 音乐文件是否可访问？→ 否→检查文件权限
4. 播放格式是否支持？→ 否→转换文件格式
5. 尝试重启服务和音箱→问题是否解决？

适用设备清单

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

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

常见问题速查表

问题	解决方案
音箱无法发现音乐库	检查IP配置，确保与Web控制台地址一致
播放时断断续续	检查网络稳定性，避免NAS与音箱之间距离过远
部分歌曲无法播放	确认文件格式是否支持，建议使用MP3格式
语音指令无响应	检查XiaoMusic服务是否正常运行
音乐列表不更新	使用"刷新列表"语音指令或在Web界面手动刷新

通过以上方法，你可以充分发挥XiaoMusic的功能，让小爱音箱成为你本地音乐库的完美伴侣。无论是在客厅、卧室还是书房，都能轻松享受你的音乐收藏。

【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic