3步解锁音乐自由：让小爱音箱畅听全网无损音乐

你是否遇到过这样的困扰：对小爱音箱说"播放周杰伦的歌"，却被提示"需要开通会员"？现在，这个问题有了完美解决方案。XiaoMusic开源工具通过智能下载技术，让你的小爱音箱突破音乐平台限制，实现真正的语音控制自由。无需专业知识，只需简单三步，就能打造专属音乐库，让流行金曲、经典老歌随声即来。

零基础部署指南：5分钟让系统跑起来

Docker一键启动方案

如果你是技术新手，Docker部署是最省心的选择，就像使用微波炉加热食物一样简单：

准备工作：确保电脑已安装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：将容器内端口映射到电脑的58090端口
• -v /xiaomusic_music:/app/music：保存下载的音乐到本地
• -v /xiaomusic_conf:/app/conf：保存配置文件

验证方法：等待几分钟后，在浏览器输入http://你的IP地址:58090，出现控制界面即部署成功。

源码安装进阶方案

对于喜欢动手的用户，源码安装让你更深入了解系统运作：

准备工作：安装Python 3.8+和Git工具

执行命令：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
cd xiaomusic
pip install -r requirements.txt && python xiaomusic.py

验证方法：终端显示"Server started on port 8090"后，访问http://localhost:8090进入管理界面。

💡 新手技巧：如果遇到"端口被占用"错误，可修改启动命令中的端口号，如python xiaomusic.py --port 8080指定其他端口。

控制面板实战：3分钟上手核心功能

成功部署后，你将看到功能丰富的控制界面，通过直观的操作面板管理音乐播放。

界面主要分为三个功能区：

• 左侧导航栏：设备控制、播放列表和系统设置
• 中间内容区：歌曲搜索和播放列表管理
• 底部控制栏：播放控制和音量调节

🔍 注意事项：首次使用时，需在"设备控制"中选择你的小爱音箱型号，系统会自动完成配对。

核心功能速览

1. 设备切换：右上角下拉菜单选择需要控制的小爱设备
2. 音乐搜索：顶部搜索框输入歌手或歌曲名，支持模糊查询
3. 播放控制：底部提供播放/暂停、上一曲/下一曲和音量调节
4. 模式切换：支持单曲循环、全部循环和随机播放模式

语音指令实战手册：一句话玩转音乐播放

掌握这些语音指令，让小爱音箱更懂你的音乐需求：

日常播放指令

• "播放周杰伦的歌"：自动搜索并播放指定歌手作品
• "下一首"：切换到下一曲目
• "暂停播放"：暂停当前歌曲
• "声音大一点"：增加音量
• "单曲循环"：重复播放当前歌曲

高级管理指令

• "刷新音乐库"：更新本地歌曲列表
• "收藏这首歌"：将当前播放歌曲加入收藏
• "播放我的收藏"：播放所有已收藏歌曲
• "删除这首歌"：从播放列表移除当前歌曲

💡 效率技巧：创建自定义指令，如对小爱说"早上好"自动播放晨间歌单，需在设置中提前配置。

音乐库管理指南：打造你的专属曲库

XiaoMusic会自动整理音乐文件，让管理变得简单直观。在"全部"标签下可以查看所有歌曲，通过"收藏"和"下载"标签快速筛选内容。

实用管理功能

1. 歌曲分类：系统自动按歌手、专辑分类，支持快速筛选
2. 批量操作：长按歌曲可进行批量删除或添加到播放列表
3. 音质选择：设置中可选择下载音质，支持无损音乐下载
4. 存储空间管理：自动提示清理长期未播放的歌曲

🔍 注意事项：下载网络歌曲需要一定时间，建议在WiFi环境下使用，避免流量消耗。

场景化应用指南：让音乐融入生活

晨间唤醒场景

设置方法：在"定时任务"中添加"每天7:00播放'我的早晨'歌单"，对小爱说"早上好"即可触发。 适用场景：用喜欢的音乐代替刺耳的闹钟，开启活力满满的一天。

家庭聚会场景

设置方法：创建"派对模式"歌单，添加欢快曲目，语音指令"播放派对音乐"启动随机播放。 适用场景：家庭聚会或朋友聚餐时，营造热闹氛围。

睡前助眠场景

设置方法：在"定时任务"中设置"23:00播放'助眠音乐'并在30分钟后停止"。 适用场景：伴着轻柔音乐入睡，系统自动关闭，不影响休息。

个性化界面设置：打造你的专属风格

XiaoMusic提供多种主题风格，满足不同审美需求，切换过程简单直观。

主题选择指南

• Pure主题：简洁清爽的界面设计，适合追求简单高效的用户
• Tailwind主题：响应式设计，在手机和电脑上都有良好表现
• XPlayer主题：专业级音乐播放界面，提供更多音频控制选项

切换方法：点击右上角设置按钮，在"外观设置"中选择喜欢的主题，立即生效无需重启。

常见问题解决指南

音乐下载缓慢怎么办？

• 检查网络连接，建议使用5G WiFi或有线网络
• 在设置中降低同时下载任务数量（默认3个）
• 非高峰时段进行批量下载，速度会更稳定

如何更新音乐库？

当你添加新的音乐文件到存储目录后，有两种更新方式：

• 语音指令："小爱同学，刷新音乐库"
• 手动更新：在控制界面点击"刷新"按钮

支持哪些音频格式？

XiaoMusic支持MP3、FLAC、WAV、APE、OGG和M4A等多种音频格式，无论是无损音乐还是普通音质，都能完美播放。

通过XiaoMusic，你可以彻底摆脱会员限制，让小爱音箱成为真正的音乐助手。简单三步部署，丰富的语音指令，个性化的界面设置，让音乐自由触手可及。现在就开始打造你的专属音乐库，让每个日常瞬间都有动人旋律相伴。