解放智能音箱：3步搭建自定义音乐系统

智能音箱只能听指定平台音乐？当你对着小爱音箱说出"播放周杰伦的歌"却得到"版权受限"的回复时，是否想过打破这种限制？Xiaomusic开源项目正是为解决这一痛点而生——它让你的智能音箱突破平台壁垒，变身支持本地音乐管理、在线资源解析、语音全控制的个性化音乐中心。本文将带你通过"准备-部署-配置"三步，打造专属的智能音箱自定义音乐系统。

🔍 核心价值：重新定义智能音箱的音乐能力

传统智能音箱受限于平台版权，而Xiaomusic通过技术整合实现了三大突破：

跨平台音乐自由

系统内置yt-dlp工具（在线媒体解析下载器），能自动获取并下载网络音乐资源，配合本地文件扫描功能，实现"想听就听"的音乐自由。支持mp3、flac、wav等12种音频格式，远超主流智能音箱的原生支持范围。

播放方案	支持格式	音乐来源	语音控制	本地存储
原厂系统	3-5种	单一平台	基础指令	不支持
Xiaomusic	12种	全网+本地	20+指令	完全支持

全场景语音交互

针对用户日常使用习惯设计20+语音指令，覆盖从播放控制到收藏管理的全流程操作：

• "播放我收藏的歌" - 调用个人收藏列表
• "下载周杰伦晴天" - 自动解析并保存歌曲
• "音量调至50%" - 精细化音量控制
• "明天8点播放轻音乐" - 定时播放任务

Xiaomusic操作界面指南

🛠️ 实施路径：3步完成系统搭建

准备阶段：环境与工具就绪

硬件要求：

• 运行Docker的设备（NAS/树莓派/PC均可）
• 小爱音箱系列设备（任意型号）
• 至少1GB空闲存储空间

网络准备： 确保设备处于同一局域网，开放58090端口用于Web访问。

部署阶段：容器化快速启动

采用[Docker容器技术]实现一键部署，隔离环境依赖，保持系统清洁：

docker run -p 58090:8090 \
  -e XIAOMUSIC_PUBLIC_PORT=58090 \
  -v /xiaomusic_music:/app/music \
  -v /xiaomusic_conf:/app/conf \
  hanxi/xiaomusic

操作目的：创建并启动Xiaomusic容器
执行命令：上述Docker命令
预期结果：终端显示"服务启动成功"，容器自动在后台运行

配置阶段：3分钟完成初始化

1. 访问控制界面
   在浏览器输入http://设备IP:58090，首次打开将进入配置向导

2. 账号与设备绑定

   • 输入小米账号密码（用于设备认证）
   • 选择要控制的小爱音箱设备

3. 个性化设置

   • 设置音乐存储路径（默认已映射宿主机目录）
   • 开启自动扫描功能（每小时更新本地歌单）

Xiaomusic本地歌曲播放列表

🎯 场景拓展：不止于"播放音乐"

多设备协同播放

系统支持多台小爱音箱组建家庭音响网络，通过简单设置实现：

• 同步播放：所有设备同时播放同一首歌
• 分区控制：客厅/卧室独立播放不同内容
• 接力播放：从客厅移动到卧室时自动切换播放设备

个性化音效调节

进阶用户可通过Web界面的"音效实验室"模块：

• 预设古典/流行/摇滚等6种EQ模式
• 自定义均衡器参数（10段频率调节）
• 应用环境音效（浴室/客厅等场景模式）

graph TD
    A[用户语音指令] -->|小爱音箱| B(Xiaomusic服务)
    B --> C{指令类型}
    C -->|播放请求| D[本地音乐库]
    C -->|下载请求| E[yt-dlp解析器]
    D --> F[音频处理引擎]
    E --> F
    F --> G[音效处理模块]
    G -->|无线传输| H[小爱音箱播放]

❓ 常见问题解答

Q1: 部署后找不到我的小爱音箱怎么办？
A1: 确保小米账号已在音箱上登录，尝试在Web设置中点击"刷新设备列表"，如仍未显示可重启Docker容器。

Q2: 支持无损音乐格式播放吗？
A2: 完全支持flac、ape等无损格式，系统会自动根据音箱性能选择最佳解码方式。

Q3: 下载的音乐文件保存在哪里？
A3: 保存在宿主机的/xiaomusic_music目录，可通过文件管理器直接访问和管理。

Q4: 如何设置定时播放功能？
A4: 在Web界面"定时任务"模块，设置触发时间、播放内容和目标设备即可。

Q5: 会影响音箱原有的语音助手功能吗？
A5: 不会，Xiaomusic仅接管音乐播放相关指令，其他功能（如查询天气）保持不变。

通过这套系统，你的智能音箱将彻底摆脱平台束缚，成为真正个性化的音乐中心。无论是珍藏的本地无损音乐，还是网络上的稀有资源，都能通过简单的语音指令轻松播放。现在就动手搭建，让每一首喜欢的歌都能自由流淌。