如何轻松突破小爱音箱音乐限制，免费畅听全网音乐

XiaoMusic是一款开源工具，它能让你的小爱音箱摆脱会员限制，通过智能下载技术自由播放任何歌曲，打造个人专属音乐库，实现真正的语音控制自由。无需复杂设置，新手也能快速上手，享受无限制的音乐体验。

零基础部署指南：两种简单方案任你选

Docker一键启动，新手也能秒上手 🚀

如果你是技术新手，Docker部署是最省心的选择。只需复制以下命令到终端执行，系统会自动完成下载和配置：

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即可访问管理界面。

源码安装三步曲，灵活掌控程序

对于喜欢动手的用户，源码安装让你更灵活地控制程序：

1. 克隆项目代码库：git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
2. 进入项目目录：cd xiaomusic
3. 安装依赖并启动：pip install -r requirements.txt && python xiaomusic.py

启动成功后，同样通过浏览器访问上述地址进入管理界面。

实用功能详解：小爱音箱控制面板全解析

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

界面主要分为几个功能区：左侧是设备控制和设置菜单，中间是播放列表和搜索区域，底部是播放控制栏。你可以轻松切换设备、搜索歌曲、调整播放模式，甚至设置定时关闭等高级功能。核心功能模块可参考xiaomusic/api/routers/music.py。

本地音乐库管理：轻松打造个人音乐收藏

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

你可以直接点击歌曲名播放，或通过搜索框快速定位想听的音乐。对于不喜欢的歌曲，点击垃圾桶图标即可轻松删除。音乐库管理功能由xiaomusic/music_library.py模块提供支持。

主题切换技巧：打造个性化界面风格

XiaoMusic提供多种主题风格，满足不同审美需求：

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

通过右上角的设置按钮可以随时切换主题，找到最适合你的界面风格。主题切换功能由xiaomusic/static/tailwind/theme.js实现。

语音指令大全：一句话控制音乐播放

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

基础播放控制

• "播放周杰伦的歌"：自动搜索并播放指定歌手作品
• "下一首"：切换到下一曲目
• "暂停"：暂停当前播放
• "单曲循环"：重复播放当前歌曲
• "随机播放"：打乱播放列表顺序

高级功能指令

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

生活场景应用：让音乐融入你的日常

晨间唤醒场景 🌅

设置"早上好"自定义指令，让小爱音箱每天用你喜欢的音乐唤醒你。只需在设置中绑定指定歌单，每天早上对小爱说"早上好"，就能自动播放晨间音乐。

家庭聚会场景 🎉

创建"派对模式"歌单，聚会时说"播放派对音乐"，XiaoMusic会自动按随机顺序播放歌单中的欢快曲目，营造热闹氛围。

睡前助眠场景 😴

设置"晚安"指令，自动播放轻柔的助眠音乐，并在指定时间后自动停止，让你伴着音乐入睡。

常见问题解决：轻松应对使用难题

音乐下载缓慢怎么办？

下载速度受网络环境影响较大，建议在网络状况良好时进行批量下载。也可以在设置中调整同时下载的任务数量，减少网络占用。下载功能由plugins/httpget.py模块处理。

如何更新音乐库？

当你添加新的音乐文件到存储目录后，只需对小爱说"刷新音乐库"，系统就会重新扫描并更新歌曲列表。

支持哪些音频格式？

XiaoMusic支持MP3、FLAC、WAV、APE、OGG和M4A等多种音频格式，确保你能播放各种来源的音乐文件。格式支持由xiaomusic/utils/music_utils.py模块提供。

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