3步解锁小爱音箱播放限制：XiaoMusic全方位突破音乐版权壁垒指南

核心价值：让小爱音箱重获音乐自由

想象这样的场景：周末午后，你对着小爱音箱说"播放周杰伦的歌"，得到的却是冰冷的"版权受限"提示；孩子想听睡前故事，却被告知需要开通会员才能完整收听。这些令人沮丧的体验，正是 millions of 小爱音箱用户共同的痛点。

XiaoMusic的出现彻底改变了这一局面。这款开源工具通过创新技术方案，让你的小爱音箱突破官方音乐库限制，实现真正的"想听就听"。无论是经典老歌还是最新热曲，无论是华语流行还是欧美摇滚，都能通过简单的语音指令轻松播放。

零基础部署指南：3种方案覆盖所有用户

方案一：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	配置文件目录	独立目录便于备份和管理
-e XIAOMUSIC_PUBLIC_PORT=58090	公开访问端口	需与端口映射的第一个数值保持一致

方案二：Docker Compose管理（推荐进阶用户）

对于需要长期运行和管理的场景，Docker Compose提供了更优雅的解决方案：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090
    environment:
      XIAOMUSIC_PUBLIC_PORT: 58090
    volumes:
      - /xiaomusic_music:/app/music
      - /xiaomusic_conf:/app/conf

创建docker-compose.yml文件后，使用docker-compose up -d命令启动服务。

方案三：源码部署（开发者首选）

如果你想深入了解项目或进行二次开发，可以选择源码部署：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
cd xiaomusic
chmod +x install_dependencies.sh
./install_dependencies.sh
python xiaomusic.py

部署完成后，在浏览器访问http://你的IP地址:58090即可进入管理界面。

语音指令实战手册：解放双手的音乐控制

XiaoMusic让语音控制变得前所未有的强大和直观。以下是日常生活中最常用的语音指令场景：

基础播放控制

语音指令	功能说明	适用场景
"播放周杰伦的晴天"	精准搜索并播放指定歌曲	想听特定歌曲时
"下一首"	切换到下一首	当前歌曲不喜欢
"暂停" / "继续播放"	控制播放状态	需要临时暂停时
"音量调到50%"	调整音量	环境噪音变化时

高级功能指令

• "添加到收藏" - 将当前播放歌曲加入收藏列表
• "播放我喜欢的音乐" - 播放所有收藏歌曲
• "单曲循环" - 重复播放当前歌曲
• "随机播放" - 随机顺序播放歌曲列表
• "刷新音乐库" - 更新本地音乐库内容

图：XiaoMusic操控面板界面，显示了主要功能区域和操作指引

个性化配置指南：打造专属音乐体验

基础配置文件设置

首先复制示例配置文件进行个性化设置：

cp config-example.json config.json

关键配置项说明：

{
  "account": "你的小米账号",
  "password": "你的小米密码",
  "music_path": "music",
  "convert_to_mp3": false,
  "download_quality": "high",
  "auto_download": true
}

自定义语音指令

通过配置文件可以扩展个性化语音指令：

"user_key_word_dict": {
    "早上好": "exec#code1(\"播放早安音乐\")",
    "晚安": "exec#code1(\"播放轻音乐\")",
    "工作模式": "exec#code1(\"播放专注音乐\")"
}

主题切换

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

• 默认主题：功能全面，适合日常使用
• Pure主题：极简设计，专注音乐内容
• Tailwind主题：响应式布局，多设备适配
• XPlayer主题：专业播放界面，适合音乐发烧友

图：XiaoMusic音乐列表界面，展示了歌曲分类和播放控制

常见问题速解：让音乐播放畅通无阻

部署问题排查

问题	解决方案
端口冲突	更换映射端口，如58091:8090
目录权限错误	执行chmod -R 775 /xiaomusic_music赋予权限
容器启动失败	检查日志：docker logs xiaomusic

使用问题处理

• 歌曲无法播放：尝试开启配置文件中的convert_to_mp3: true
• 语音无响应：检查小米账号是否正常登录
• 下载速度慢：在设置中降低音质选项
• 设备连接失败：重启小爱音箱和XiaoMusic服务

图：XiaoMusic设备控制面板，展示了设备选择和播放列表管理

安全与兼容性说明

安全使用建议

• 若需公网访问，务必在设置中开启密码保护
• 定期备份配置文件，避免重要数据丢失
• 不要在公共网络环境下输入账号密码
• 定期更新软件版本获取安全补丁

支持设备与格式

兼容设备：

• 小爱音箱Play系列
• 小米AI音箱系列
• Redmi小爱音箱系列
• 小米电视内置小爱同学

支持音乐格式：

• MP3、FLAC、WAV、APE、OGG、M4A等主流音频格式

使用建议与未来展望

最佳使用实践

• 初次使用时建议先添加喜欢的歌手或歌单，让系统自动构建音乐库
• 定期执行"刷新音乐库"指令，确保本地音乐与在线内容同步
• 利用"收藏"功能构建个人专属歌单，提升语音控制体验
• 对于网络状况不佳的环境，可预先下载常用歌曲

未来功能展望

XiaoMusic开发团队正致力于添加更多实用功能：

• 多房间音响同步播放
• AI智能推荐个性化歌单
• 语音控制音效调节
• 歌词显示与卡拉OK功能

通过XiaoMusic，你的小爱音箱不再受限于官方音乐库的版权枷锁，真正实现"我的音乐我做主"。无论是清晨的唤醒音乐，午后的工作背景乐，还是夜晚的助眠旋律，XiaoMusic都能让小爱音箱成为你最贴心的音乐伴侣。立即尝试，开启你的无限制音乐之旅吧！