3个步骤让小爱音箱秒变本地音乐播放器：XiaoMusic完全攻略

3个步骤让小爱音箱秒变本地音乐播放器：XiaoMusic完全攻略

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

为什么你的小爱音箱只能播放网络音乐？

你是否遇到过这样的尴尬：家里NAS存储着几百GB的音乐收藏，而小爱音箱却只能播放在线音乐平台的歌曲？这就像拥有一个装满珍贵书籍的图书馆，却只能在图书馆门口读宣传册。XiaoMusic正是解决这一痛点的开源工具，它能让小爱音箱突破限制，直接播放你本地存储的音乐文件，无需复杂设置，也不必担心版权问题。

核心原理：本地音乐与智能音箱的"桥梁"技术

突破限制的"中间人"机制

想象你的音乐库是一个私人博物馆（NAS存储），而小爱音箱是一位只能参观特定展览的游客。XiaoMusic就像一位专业的讲解员，它能识别博物馆的展品（音乐文件），并以小爱音箱能理解的方式（标准网络协议）进行介绍。这种设计无需破解音箱或修改固件，既安全又稳定。

本地优先的智能播放策略

XiaoMusic采用"本地优先"原则：当你发出语音指令时，系统会先在本地音乐库中搜索匹配内容，只有在本地没有找到时才会转向网络资源。这种方式既保证了音乐播放的流畅性，又节省了网络带宽，同时保护了你的隐私。

图：XiaoMusic控制面板，显示了设备控制、播放列表和歌曲管理功能区域

3步实现本地音乐自由

第1步：部署XiaoMusic服务

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：端口映射设置
• -e XIAOMUSIC_PUBLIC_PORT=58090：外部访问端口配置
• 两个-v参数：分别挂载本地音乐目录和配置文件目录

手动部署方式：

1. 克隆项目仓库：

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

2. 安装依赖：

cd xiaomusic && ./install_dependencies.sh

3. 启动服务：

python xiaomusic.py

第2步：基础配置要点

✅网络设置：在Web控制台中，确保"NAS IP地址"仅填写纯IP（如"192.168.1.100"），不包含端口号

✅权限检查：为音乐目录设置正确权限：

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

✅设备配对：通过Web界面的"设备控制"选项卡完成小爱音箱配对

第3步：开始使用本地音乐服务

图：XiaoMusic音乐库管理界面，显示按不同分类组织的音乐列表

提升使用体验的5个专业技巧

高效音乐管理指南

• 智能分类：利用"全部"、"所有歌曲"、"收藏"和"下载"标签快速筛选音乐
• 批量操作：长按歌曲可进行批量添加到播放列表或删除操作
• 关键词搜索：使用右上角搜索框快速定位特定歌曲或艺术家

实用语音指令集

• "小爱同学，播放我的本地音乐" - 启动本地音乐播放
• "小爱同学，播放周杰伦的歌" - 播放指定艺术家的所有本地歌曲
• "小爱同学，切换播放模式" - 循环切换播放模式
• "小爱同学，更新音乐库" - 刷新本地音乐列表

播放模式全解析

XiaoMusic提供四种播放模式满足不同场景需求：

1. 顺序播放：按列表顺序播放，适合欣赏专辑
2. 单曲循环：反复播放当前歌曲，适合学习音乐或特别喜爱的曲目
3. 全部循环：播放完整列表后自动从头开始
4. 随机播放：随机顺序播放，适合派对或背景音乐

常见问题的系统化解决方案

连接问题排查流程

1. 网络检查：确认所有设备在同一局域网内
2. 服务状态：检查XiaoMusic服务是否正常运行
3. 防火墙设置：确保58090端口未被阻止
4. IP配置：验证Web控制台中设置的IP地址是否正确

播放异常解决方案

服务重启命令参考

Docker方式：

docker restart 容器ID

手动启动方式：

pkill -f xiaomusic.py && python xiaomusic.py &

支持设备与系统要求

兼容的小爱音箱型号

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

最低系统要求

• CPU：双核处理器
• 内存：至少2GB RAM
• 存储：至少100MB可用空间（不包括音乐文件）
• 网络：稳定的局域网环境

通过XiaoMusic，你可以让小爱音箱充分发挥潜力，成为连接数字音乐收藏与日常生活的桥梁。无论是工作、学习还是休闲时刻，都能轻松享受你喜爱的音乐，让智能家居体验更上一层楼。

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