XiaoMusic：3个方法让小爱音箱播放本地音乐，打造专属智能音乐中心

你是否曾遇到这样的困扰：NAS里收藏了几百G的无损音乐，却只能在电脑上欣赏，无法通过客厅的小爱音箱播放？XiaoMusic正是为解决这一痛点而生的开源工具，它像一位智能音乐管家，架起本地音乐库与小爱音箱之间的桥梁，让你轻松实现"语音点歌自由"。本文将从准备到实战，全面介绍如何利用XiaoMusic打造专属的智能音乐中心。

准备篇：认识XiaoMusic——你的音乐桥梁工程师

什么是XiaoMusic？

想象你拥有一个装满珍贵CD的音乐收藏室（你的本地音乐库），而小爱音箱是一位只会说特定语言的朋友。XiaoMusic就像一位精通两种语言的桥梁工程师，它在你的本地网络中搭建了一座"音乐翻译桥"，让小爱音箱能够理解并播放你收藏的本地音乐。

它如何工作？

XiaoMusic采用"本地服务+智能代理"的创新架构：

• 本地服务中心：在你的NAS或电脑上运行，负责管理音乐库和处理播放请求
• 智能协议转换：将本地音乐文件格式和访问方式转换为小爱音箱能理解的语言
• 实时通信通道：建立音箱与本地音乐库之间的高速数据传输路径

这种设计无需破解音箱或修改系统，通过标准网络协议实现安全稳定的音乐播放。

XiaoMusic控制面板界面，显示设备控制、播放列表和音乐管理功能区域

实战篇：3种部署方式，5分钟开启音乐自由

📌 方式一：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：端口映射，将容器内服务端口映射到主机
• -v /xiaomusic_music:/app/music：挂载你的本地音乐目录
• -v /xiaomusic_conf:/app/conf：挂载配置文件目录，确保设置不会丢失

📌 方式二：手动安装（适合技术爱好者）

1. 克隆项目仓库：

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

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

cd xiaomusic
./install_dependencies.sh

3. 启动服务：

python xiaomusic.py

📌 方式三：进阶部署（适合NAS用户）

对于NAS用户，推荐使用容器编排工具（如Portainer）进行部署，设置自动启动和资源限制，确保服务稳定运行。具体步骤可参考项目文档中的NAS部署指南。

基础配置三要素

1. 网络设置：在Web控制台中准确填写运行XiaoMusic设备的IP地址（仅填写IP，如"192.168.1.100"）

2. 目录授权：确保XiaoMusic有权访问你的音乐目录：

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

3. 设备配对：在控制台"设备控制"页面点击"搜索设备"，按提示完成小爱音箱配对

使用篇：像操作手机音乐APP一样简单

音乐库管理：指尖上的音乐收藏馆

XiaoMusic提供直观的Web界面管理音乐库，主要功能区包括：

XiaoMusic音乐列表界面，显示按不同分类组织的音乐收藏

• 分类浏览：通过"全部"、"所有歌曲"、"收藏"和"下载"标签快速筛选
• 搜索功能：支持按歌曲名、歌手或专辑搜索
• 批量操作：可批量添加到播放列表或收藏
• 自动识别：自动获取歌曲封面和元数据

语音控制：动动嘴就能播放音乐

掌握这些常用指令，彻底解放双手：

• 播放控制："小爱同学，播放本地音乐"、"下一首"、"暂停"
• 精准点播："小爱同学，播放周杰伦的晴天"
• 模式切换："单曲循环"、"随机播放"
• 库管理："刷新音乐列表"、"收藏这首歌"

播放模式设置：个性化你的聆听体验

在控制面板底部的播放控制区，你可以切换多种播放模式：

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

优化篇：让音乐体验更上一层楼

用户场景案例

场景一：家庭聚会背景音乐

周末家庭聚会时，你只需说"小爱同学，播放派对音乐"，XiaoMusic会自动从你的"派对歌单"中随机播放歌曲，营造欢乐氛围。

场景二：睡前音乐定时关闭

睡前你可以设置"小爱同学，30分钟后关闭音乐"，XiaoMusic会在指定时间后自动停止播放，让你伴着音乐入睡。

场景三：多房间音乐同步

如果你有多个小爱音箱，可以通过XiaoMusic实现多设备同步播放，让整个家里都充满你喜欢的音乐。

进阶技巧

1. 音乐标签优化：使用音乐标签工具整理你的音乐库，确保歌曲信息完整，XiaoMusic能更好地识别和分类

2. 播放质量设置：在"设置-播放设置"中调整音质，平衡播放流畅度和声音质量

3. 快捷键设置：在Web控制台"设置-快捷键"中自定义常用操作的键盘快捷键，提升操作效率

4. 定时任务：利用"定时播放"功能，设置早晨自动播放唤醒音乐，开启美好一天

XiaoMusic设备控制面板，展示设备选择和播放列表管理功能

问答篇：解决你可能遇到的问题

连接与发现问题

Q: 小爱音箱找不到我的音乐库怎么办？ A: 首先检查XiaoMusic服务是否正常运行，然后确认Web控制台中设置的IP地址与运行XiaoMusic的设备IP一致。若使用无线连接，尝试将音箱和服务器靠近路由器。

Q: 播放时断断续续如何解决？ A: 这通常是网络不稳定导致的。建议：1)将NAS/服务器与路由器用网线连接；2)避免在播放音乐时进行大文件下载；3)检查Wi-Fi信号强度，考虑添加中继器。

播放与文件问题

Q: 为什么有些歌曲无法播放？ A: 小爱音箱对MP3格式支持最好。如果遇到播放问题，建议将文件转换为MP3格式。另外，检查文件权限是否设置正确。

Q: 如何更新我的音乐库？ A: 有两种方式：1)使用语音指令"小爱同学，刷新音乐列表"；2)在Web控制台点击"刷新库"按钮。建议在添加新音乐后执行此操作。

服务与性能问题

Q: 如何确保XiaoMusic开机自动启动？ A: Docker部署可在容器设置中勾选"自动重启"；手动部署可通过systemd或crontab设置开机启动脚本。

Q: 运行XiaoMusic会占用很多系统资源吗？ A: 不会，XiaoMusic设计轻量，通常只占用约50-100MB内存和少量CPU资源，对NAS或家庭服务器性能影响很小。

开始你的智能音乐之旅

现在，你已经了解了XiaoMusic的全部核心功能和使用技巧。无论你是音乐收藏爱好者，还是追求智能家居体验的科技达人，XiaoMusic都能帮你打造专属的智能音乐中心。

立即尝试部署XiaoMusic，让你的小爱音箱不再受限于流媒体平台，尽情享受你的本地音乐收藏吧！如有任何问题，欢迎在项目社区交流分享你的使用体验。