企业官网建设流程全解析

小爱音箱终极音乐解锁：5分钟实现Windows语音控制本地音乐播放

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

想要通过小爱音箱播放自己收藏的本地音乐吗？XiaoMusic项目为你提供了完美的解决方案！这个开源工具让你能够通过简单的语音指令控制小爱音箱播放本地和在线音乐，彻底解放你的音乐播放体验。无论你是Windows用户还是Linux爱好者，只需几分钟就能搭建属于自己的智能音乐系统。

为什么选择XiaoMusic？

在智能音箱时代，我们常常受限于平台音乐服务的限制。XiaoMusic打破了这一局限，让你能够：

• 🎵 播放本地音乐：直接播放电脑或NAS上的音乐文件
• 🌐 在线搜索下载：通过yt-dlp自动下载网络音乐
• 🗣️ 语音控制：使用小爱音箱原生语音指令
• 📱 多设备支持：兼容数十款小米智能音箱
• ⚡ 一键部署：Docker容器化安装，无需复杂配置

Windows平台快速部署指南

准备工作：环境检查

在开始部署前，请确保你的Windows系统满足以下要求：

1. Windows 10/11专业版或企业版（支持WSL2）
2. Docker Desktop已安装并运行
3. 至少4GB可用内存
4. 稳定网络连接

提示：Windows家庭版用户需要先启用WSL2功能才能使用Docker。

第一步：获取项目代码

打开命令提示符或PowerShell，执行以下命令：

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

第二步：创建Docker配置文件

在项目目录中创建docker-compose.yml文件，这是Windows部署的核心：

version: '3.8' services: xiaomusic: image: docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: unless-stopped ports: - "58090:8090" volumes: - D:/xiaomusic/music:/app/music - D:/xiaomusic/conf:/app/conf

Windows路径配置要点：

• 使用正斜杠/而不是反斜杠\
• 盘符后使用冒号，如D:/xiaomusic/conf
• 避免使用中文路径

第三步：启动音乐服务

在PowerShell中执行以下命令：

# 创建必要的目录 mkdir D:\xiaomusic\conf mkdir D:\xiaomusic\music # 启动XiaoMusic服务 docker-compose up -d

第四步：访问Web管理界面

服务启动后，在浏览器中访问：

http://localhost:58090

你将看到简洁的Web管理界面，开始配置你的音乐系统：

第五步：配置小米账号和设备

这是连接小爱音箱的关键步骤：

1. 登录小米账号：在设置页面输入你的小米账号和密码
2. 自动获取IP：系统会自动检测本地网络IP
3. 保存配置：点击页面底部的保存按钮
4. 选择设备：刷新页面后勾选你的小爱音箱
5. 完成绑定：再次保存配置

核心功能体验

语音控制指令大全

XiaoMusic支持丰富的语音指令，让你的音乐播放更加智能：

基础播放控制

• "播放歌曲" - 播放本地音乐
• "播放歌曲周杰伦晴天" - 搜索并播放指定歌曲
• "下一首/上一首" - 切换歌曲
• "停止播放" - 暂停播放

播放模式设置

• "单曲循环" - 重复播放当前歌曲
• "全部循环" - 循环所有歌曲
• "随机播放" - 随机顺序播放

歌单管理功能

• "播放歌单经典" - 播放指定歌单
• "加入收藏" - 收藏当前歌曲
• "取消收藏" - 移除收藏

支持的设备型号

XiaoMusic已测试支持数十款小米智能音箱：

提示：如果你的设备不在列表中，仍然可以尝试使用，大多数小米音箱都能兼容。

音乐格式支持

XiaoMusic支持多种音频格式，满足不同音质需求：

• MP3- 最常用的音频格式
• FLAC- 无损音频格式（部分设备需转换）
• WAV- 标准无损格式
• APE- Monkey's Audio无损格式
• OGG- 开源音频格式
• M4A- AAC编码格式

高级配置技巧

自定义音乐目录

你可以将现有的音乐库映射到XiaoMusic中：

volumes: - D:/MyMusic:/app/music # 映射Windows音乐目录 - E:/NAS/Music:/app/music # 映射网络存储

网络歌单功能

XiaoMusic支持JSON格式的网络歌单，轻松创建个性化播放列表：

{ "name": "我的最爱歌单", "songs": [ {"name": "晴天", "artist": "周杰伦"}, {"name": "七里香", "artist": "周杰伦"}, {"name": "告白气球", "artist": "周杰伦"} ] }

插件系统扩展

项目提供了丰富的插件系统，位于plugins/目录：

• HTTP请求插件：自定义网络请求
• 代码执行插件：扩展功能逻辑
• 第三方集成：连接其他音乐服务

Windows平台常见问题解决

问题一：Docker容器启动失败

如果容器无法启动，检查以下配置：

# 查看容器日志 docker logs xiaomusic # 检查端口占用 netstat -ano | findstr :58090

问题二：小爱音箱无法连接

确保网络环境正确：

1. 确认小爱音箱和电脑在同一局域网
2. 检查Windows防火墙设置
3. 验证小米账号密码正确性

问题三：音乐播放异常

如果遇到播放问题：

# 检查FFmpeg是否正常工作 docker exec -it xiaomusic ffmpeg -version # 查看音乐文件权限 docker exec -it xiaomusic ls -la /app/music

性能优化建议

为了让XiaoMusic在Windows上运行更流畅：

1. 资源分配：在Docker Desktop中分配至少2GB内存
2. 存储优化：将音乐文件放在SSD上提升加载速度
3. 网络配置：确保稳定的局域网连接
4. 定期更新：使用最新版本的Docker镜像

安全注意事项

使用XiaoMusic时请注意：

1. 局域网使用：建议仅在家庭网络内使用
2. 账号安全：不要在公共WiFi环境下使用
3. 定期备份：备份D:/xiaomusic/conf目录的配置文件
4. 及时更新：关注项目更新，获取安全修复

扩展应用场景

成功部署XiaoMusic后，你还可以尝试：

1. 多房间音乐同步：控制多个小爱音箱同时播放
2. 定时播放功能：设置起床闹钟音乐
3. 儿童模式：为孩子创建专属歌单
4. 派对模式：创建不同场景的音乐列表

故障排除快速指南

遇到问题时，按以下步骤排查：

第一步：检查服务状态

docker ps | findstr xiaomusic

第二步：查看详细日志在Web界面底部点击"下载日志文件"按钮

第三步：重启服务

docker-compose down docker-compose up -d

第四步：重置配置删除D:/xiaomusic/conf目录后重新配置

总结

通过XiaoMusic，你可以轻松将Windows电脑变成强大的音乐服务器，让小爱音箱发挥更大的价值。无论是本地音乐库还是在线资源，都能通过简单的语音指令实现智能播放。

项目的核心优势在于开源性和易用性，Docker部署方式让Windows用户也能享受与Linux平台相同的功能体验。现在就开始你的智能音乐之旅吧！

官方文档：docs/index.md插件系统：plugins/配置文件示例：config-example.json

记住，音乐的力量在于分享。将你的XiaoMusic配置经验分享给更多朋友，让智能音乐走进更多家庭！

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