告别会员枷锁：XiaoMusic让你实现小爱音箱音乐自由

核心价值：解锁小爱音箱的无限音乐潜力

你是否曾遇到这样的困扰：对着小爱音箱说"播放周杰伦的歌"，却被告知需要开通会员？现在，XiaoMusic开源工具彻底解决了这个问题。这款智能音乐解决方案通过创新的下载技术，让你的小爱音箱摆脱平台限制，自由播放全网音乐资源。无需复杂设置，即使是技术新手也能在几分钟内完成部署，从此告别昂贵的音乐会员订阅，打造真正属于你的个人音乐库。

零基础部署：3种方案任你选

Docker一键启动：最省心的选择

当你希望快速体验XiaoMusic而不想处理复杂配置时，Docker部署是理想选择。这种方式将所有依赖打包在容器中，确保环境一致性，只需一条命令即可完成安装。

目标：5分钟内启动XiaoMusic服务
步骤：

# 复制以下命令到终端执行，系统会自动下载并启动服务
docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 \
  -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf \
  hanxi/xiaomusic

验证：等待几分钟后，在浏览器输入http://你的IP地址:58090，能看到管理界面即表示部署成功。

源码安装：自定义程度更高

如果你是喜欢动手的用户，或者需要对程序进行个性化修改，源码安装让你拥有更多控制权。

目标：从源码构建并运行XiaoMusic
步骤：

# 1. 克隆项目代码库
git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic

# 2. 进入项目目录
cd xiaomusic

# 3. 安装依赖并启动
pip install -r requirements.txt && python xiaomusic.py

验证：启动成功后，在浏览器访问http://localhost:8090即可进入管理界面。

控制面板详解：轻松驾驭音乐播放

成功部署后，你将看到功能丰富的控制界面，通过直观的操作面板管理音乐播放。界面主要分为三个功能区：左侧的设备控制和设置菜单，中间的播放列表和搜索区域，以及底部的播放控制栏。

你可以轻松完成以下操作：

• 切换不同小爱设备
• 搜索并播放本地或网络歌曲
• 调整播放模式（单曲循环、随机播放等）
• 设置定时关闭等高级功能
• 查看歌曲进度并自由拖动

语音指令全掌握：一句话玩转音乐

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

音乐发现指令

• "找一首适合工作的轻音乐"：自动推荐合适的背景音乐
• "播放80年代经典老歌"：按年代筛选音乐
• "我想听周杰伦的青花瓷"：精准定位特定歌曲

播放控制指令

• "暂停播放"：暂停当前歌曲
• "继续播放"：恢复播放
• "下一首"：切换到下一曲目
• "音量调到50%"：精确调整音量

音乐库管理指令

• "添加到收藏"：收藏当前播放歌曲
• "删除这首歌"：从库中移除当前歌曲
• "刷新音乐库"：更新本地歌曲列表

本地音乐库：打造你的专属曲库

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

你可以：

• 直接点击歌曲名播放
• 通过搜索框快速定位想听的音乐
• 按歌手、专辑或风格分类浏览
• 一键删除不喜欢的歌曲

三大生活场景：让音乐融入日常

家庭早餐场景

每天早上，只需对小爱说"早安音乐"，XiaoMusic会自动播放你预设的晨间歌单，让轻快的音乐伴随你准备早餐、唤醒家人，开启活力满满的一天。

远程控制场景

当你在厨房做饭时，无需洗手去操作手机，直接说"小爱同学，播放周杰伦的歌"，XiaoMusic会立即响应你的需求，让烹饪时光更添乐趣。

睡前放松场景

睡前对小爱说"助眠音乐"，系统会播放轻柔的音乐，并在你设定的时间后自动停止，让你伴着音乐轻松入睡，无需担心彻夜播放。

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

XiaoMusic提供多种主题风格，满足不同审美需求。通过右上角的设置按钮可以随时切换主题，找到最适合你的界面风格。

目前支持的主题包括：

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

常见问题解决：让使用更顺畅

下载速度慢怎么办？

如果遇到音乐下载缓慢的情况，建议：

• 在网络状况良好时进行批量下载
• 在设置中调整同时下载的任务数量（建议设置为2-3个）
• 避开网络高峰期下载热门歌曲

如何更新到最新版本？

• Docker用户：只需执行docker pull hanxi/xiaomusic获取最新镜像，然后重新启动容器
• 源码用户：进入项目目录，执行git pull拉取最新代码，然后重启服务

支持哪些音频格式？

XiaoMusic支持MP3、FLAC、WAV、APE、OGG和M4A等多种音频格式，确保你能播放各种来源的音乐文件，无需担心格式不兼容问题。

通过XiaoMusic，你可以彻底摆脱会员限制，让小爱音箱成为你真正的音乐助手。无论是流行金曲、经典老歌，还是有声读物，都能通过简单的语音指令轻松播放，真正实现音乐自由。现在就开始部署，体验无限制的音乐享受吧！