小爱音箱终极音乐自由指南：3步实现免费无限听歌体验

小爱音箱终极音乐自由指南：3步实现免费无限听歌体验

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

还在为小爱音箱的版权限制而烦恼吗？每次想听喜欢的歌曲却被告知"暂无版权"？今天我要介绍一个开源神器——XiaoMusic，它能彻底解决小爱音箱的音乐播放限制问题。这个项目让你通过简单的配置就能让小爱音箱播放任何你想听的歌曲，无需开通任何音乐会员，完全免费享受无限音乐资源。

🎵 为什么你需要XiaoMusic？

传统的小爱音箱在使用过程中存在诸多限制，这些问题让音乐爱好者倍感困扰：

传统小爱音箱的三大痛点：

• 🚫版权壁垒：热门歌曲经常显示"暂无版权"，想听的歌总是听不了
• 💰会员收费：很多歌曲需要单独购买或开通VIP才能播放
• 📱功能单一：只能在线播放，无法建立个人音乐库，缺少个性化体验

XiaoMusic带来的四大突破：

• ✅无限曲库：智能下载工具自动获取网络音乐资源，打破版权限制
• ✅永久收藏：建立本地音乐库，喜欢的歌曲随时播放，不受网络影响
• ✅语音控制：支持丰富的语音指令，完全保留小爱音箱的智能体验
• ✅多端管理：提供Web控制界面，电脑、手机都能轻松管理音乐

🚀 快速安装：3种方式任你选择

方案一：Docker一键部署（推荐给新手）

这是最简单快捷的安装方式，无需任何技术背景：

services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

安装步骤：

1. 将上面的配置保存为docker-compose.yml文件
2. 在终端中运行docker-compose up -d
3. 打开浏览器访问http://你的设备IP:58090
4. 按照页面提示完成基础配置

方案二：Python直接安装（适合开发者）

如果你熟悉Python环境，可以选择这种更灵活的方式：

# 安装XiaoMusic pip install -U xiaomusic # 启动服务 xiaomusic --config config.json

配置要点：

• 参考项目中的config-example.json文件创建配置文件
• 需要填写小米账号和密码用于设备连接
• 可以自定义音乐存储路径和端口设置

方案三：源码部署（完全自定义）

想要深入了解项目或进行二次开发？源码部署是最佳选择：

# 克隆项目 git clone https://gitcode.com/Github_Trending/x1a/xiaomusic # 进入项目目录 cd xiaomusic # 安装依赖 ./install_d-ependencies.sh # 启动服务 pdm run xiaomusic.py

🎨 界面体验：简洁美观的控制中心

安装完成后，通过浏览器访问XiaoMusic的Web界面，你会看到一个功能完善、界面美观的音乐管理平台。

核心功能区域详解：

1. 设备控制面板

• 左侧菜单栏提供完整的设备管理功能
• 可以设置小爱音箱的定时关机时间
• 支持多设备切换，统一管理所有音箱

2. 播放控制中心

• 播放/暂停、上一曲/下一曲控制
• 随机播放、单曲循环、顺序播放模式切换
• 实时显示播放进度，支持拖动跳转
• 音量调节和全屏歌词查看功能

3. 音乐库管理

• 支持本地音乐文件的分类浏览
• 可以按"全部"、"收藏"、"下载"等标签筛选
• 双击歌曲即可快速播放，操作十分便捷

🎤 语音控制：小爱音箱的智能升级

XiaoMusic最大的亮点是保留了小爱音箱的语音控制功能，并进行了大幅增强：

基础播放指令

• "播放歌曲周杰伦"- 自动搜索并播放周杰伦的歌曲
• "播放歌曲晴天"- 直接播放指定歌曲
• "下一首" / "上一首"- 切换歌曲
• "关机" / "停止播放"- 停止音乐播放

播放模式控制

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

歌单和收藏功能

• "播放歌单收藏"- 播放收藏列表中的歌曲
• "加入收藏"- 将当前歌曲加入收藏
• "取消收藏"- 从收藏列表中移除歌曲
• "播放歌单其他"- 播放指定目录的歌单

隐藏彩蛋功能

对小爱同学说"播放歌曲小猪佩奇的故事"，系统会自动下载小猪佩奇的故事音频并播放，这个功能特别适合有孩子的家庭。

💾 本地音乐库：打造专属音乐空间

XiaoMusic支持建立本地音乐库，让你拥有完全属于自己的音乐收藏：

支持的音频格式：

• MP3 - 最通用的音频格式
• FLAC - 无损音频格式（部分设备需开启格式转换）
• WAV - 无损音频格式
• APE - 无损压缩格式
• OGG - 开源音频格式
• M4A - AAC编码格式

音乐库管理技巧：

1. 自动扫描：系统会自动扫描指定目录下的所有音乐文件
2. 智能分类：按歌手、专辑、类型自动分类
3. 快速搜索：支持中文歌曲名和歌手名搜索
4. 批量操作：可以批量添加、删除、移动歌曲

🔧 高级配置：个性化你的音乐体验

设备兼容性设置

XiaoMusic支持几乎所有型号的小爱音箱，包括：

• 小爱音箱 Play (L05B/L05C)
• 小爱音箱 Pro (LX06)
• 小米AI音箱 (S12/S12A)
• Xiaomi Sound (L16A)
• 以及各种触屏版音箱

如果你的设备不支持某些音频格式，可以开启"型号兼容模式"和"转换为MP3"选项，系统会自动将音频转换为兼容格式。

网络歌单功能

XiaoMusic支持导入网络歌单，让你轻松获取丰富的音乐资源：

{ "music_list_url": "你的歌单链接", "custom_play_list_json": "自定义歌单配置" }

歌单来源：

• 支持标准的JSON格式歌单
• 可以导入M3U格式的电台列表
• 支持在线音乐平台的歌单分享链接

插件系统扩展

项目提供了强大的插件系统，可以通过插件扩展更多功能：

# 自定义语音指令 "测试自定义口令": "exec#code1(\"hello\")", "测试链接": "exec#httpget(\"https://example.com\")"

插件目录位于plugins/，你可以根据需要编写自定义插件，实现更复杂的自动化功能。

🛡️ 安全使用指南

账号安全建议

1. 专用账号：建议使用专门的小米账号，不要使用绑定重要设备的主账号
2. 复杂密码：设置强密码保护Web管理界面
3. 内网访问：尽量在内网环境下使用，避免公网暴露
4. 定期检查：定期检查登录记录和设备状态

隐私保护措施

• 配置文件中的敏感信息会自动脱敏处理
• 日志文件中不会记录完整的账号密码信息
• 支持HTTPS加密传输（需自行配置证书）

📱 多主题选择：找到最适合你的界面

XiaoMusic提供了多种界面主题，满足不同用户的审美需求：

Pure主题- 简洁现代的界面设计，适合追求简洁的用户Tailwind主题- 响应式设计，在不同设备上都有良好显示效果XPlayer主题- 专业播放器界面，功能布局更加合理

你可以通过Web设置页面轻松切换主题，每个主题都经过精心设计，提供了优秀的用户体验。

🔄 自动化功能：让音乐播放更智能

定时任务

通过Crontab配置，你可以实现自动化播放：

"crontab_json": { "tasks": [ { "time": "0 8 * * *", "command": "播放歌曲晨间音乐", "description": "每天早上8点播放晨间音乐" } ] }

文件监控

开启文件监控功能后，系统会自动检测音乐目录的变化：

"enable_file_watch": true, "file_watch_debounce": 10

当你在音乐目录中添加或删除文件时，XiaoMusic会自动更新音乐库，无需手动刷新。

智能下载

系统内置了yt-dlp下载工具，支持从多个平台下载音乐：

• 自动识别歌曲信息
• 支持批量下载
• 智能选择最佳音质

🎯 实用技巧：提升使用体验

技巧一：快速建立音乐库

1. 将现有的音乐文件复制到music目录
2. 对小爱音箱说"刷新列表"
3. 系统会自动扫描并建立索引
4. 现在就可以通过语音播放所有音乐了

技巧二：多设备协同

如果你有多个小爱音箱，可以：

1. 在Web界面添加所有设备
2. 为不同房间设置不同的播放列表
3. 通过语音指令指定播放设备
4. 实现全屋音乐同步播放

技巧三：儿童友好模式

• 创建专门的儿童歌单
• 设置定时播放儿童故事
• 使用语音指令"播放歌曲小猪佩奇的故事"
• 限制播放内容，保护儿童听力

技巧四：离线播放优化

1. 在有网络时批量下载常用歌曲
2. 将重要音乐标记为收藏
3. 开启本地缓存功能
4. 即使断网也能正常播放

🛠️ 故障排除：常见问题解决

问题一：设备连接失败

解决方法：

1. 检查小米账号密码是否正确
2. 确认设备在同一局域网内
3. 查看设备是否支持（参考支持设备列表）
4. 尝试重启小爱音箱和XiaoMusic服务

问题二：音乐无法播放

解决方法：

1. 检查音频格式是否支持
2. 尝试开启"转换为MP3"选项
3. 查看音乐文件是否损坏
4. 确认存储路径权限正确

问题三：语音指令无效

解决方法：

1. 检查关键词配置是否正确
2. 确认小爱音箱已连接到XiaoMusic
3. 尝试重新训练语音识别
4. 查看日志文件排查问题

🌟 项目优势与未来展望

技术优势

• 高性能架构：基于Python + FastAPI，响应迅速
• 容器化部署：支持Docker，部署简单
• 模块化设计：易于扩展和维护
• 社区活跃：持续更新，问题响应及时

用户体验优势

• 零学习成本：保留小爱音箱原有操作习惯
• 界面友好：提供多种主题选择
• 功能完善：覆盖日常使用的所有场景
• 稳定可靠：经过大量用户验证

未来发展

项目虽然已停止维护，但社区版项目 songloft-org/songloft 将继续发展，为用户提供更好的音乐播放体验。

📚 学习资源与社区支持

官方文档

• 项目配置文件：config-example.json
• 常见问题解答：docs/issues/99.md
• 详细使用指南：docs/issues/211.md

社区资源

• GitHub Issues：问题反馈和功能建议
• QQ交流群：实时交流使用心得
• 第三方主题：丰富的界面定制选择
• 配套应用：手机端管理工具

贡献指南

如果你对项目感兴趣，可以通过以下方式参与：

1. 提交Bug报告和改进建议
2. 完善文档和教程
3. 开发新的界面主题
4. 编写插件扩展功能

🎉 开始你的音乐自由之旅

通过XiaoMusic，你不仅解放了小爱音箱的音乐播放能力，更重要的是获得了完全自由的音乐体验。不再受版权限制，不再为会员付费，所有你喜欢的音乐都能通过简单的一句话播放出来。

立即行动：

1. 选择适合你的安装方式
2. 完成基础配置
3. 导入你的音乐收藏
4. 开始享受无限音乐

记住，音乐应该是自由的，技术应该是服务于人的。XiaoMusic正是这样一个工具，它用开源的力量，让每个人都能享受到真正自由的音乐体验。现在就开始，让你的小爱音箱焕发新生！

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