3种方案零基础上手：小爱音箱智能音乐系统安装教程

3种方案零基础上手：小爱音箱智能音乐系统安装教程

【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

Xiaomusic是专为小爱音箱设计的开源音乐播放系统，通过智能下载和播放管理技术，让普通音箱升级为家庭音乐中心。支持本地音乐管理、网络音乐下载和语音控制，无需编程基础即可5分钟完成部署。

如何解决智能音箱音乐播放局限？

传统智能音箱受限于平台版权和功能限制，无法自由播放本地音乐或自定义歌单。Xiaomusic通过以下核心优势突破限制：

• 全格式支持：兼容MP3、FLAC、WAV等主流音频格式
• 跨平台部署：支持Windows、macOS和Linux系统
• 语音交互优化：深度适配小爱同学语音指令
• 插件扩展系统：可通过插件实现功能定制

3种安装方案对比选择指南

小贴士

推荐新手优先选择容器化方案，无需担心环境配置问题；有技术背景的用户可尝试环境原生方案获得更好性能。

如何通过容器化方案快速部署？

容器化方案使用Docker技术，将所有依赖打包在独立环境中，避免系统冲突。

⚠️重要：部署前需先安装Docker Desktop（Windows/macOS用户）或Docker Engine（Linux用户）

Windows/macOS平台

# 创建数据目录 mkdir -p ~/xiaomusic/{music,conf} # 启动容器 docker run -p 58090:8090 \ -e XIAOMUSIC_PUBLIC_PORT=58090 \ -v ~/xiaomusic/music:/app/music \ -v ~/xiaomusic/conf:/app/conf \ hanxi/xiaomusic

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 # 配置文件目录

验证部署是否成功

1. 打开浏览器访问 http://localhost:58090
2. 看到登录界面即表示部署成功
3. 首次使用需完成小米账号绑定

如何通过环境原生方案安装？

环境原生方案直接在系统中安装Python环境和依赖，适合熟悉命令行操作的用户。

1. 安装Python环境

• Windows：从Python官网下载3.7+版本并安装，勾选"Add Python to PATH"
• macOS：使用Homebrew安装brew install python@3.9

2. 安装Xiaomusic

# 安装最新版本 pip install -U xiaomusic # 启动服务 xiaomusic

3. 验证安装结果

执行xiaomusic --version命令，显示版本号即安装成功。默认服务端口为8090，访问 http://localhost:8090 进入控制界面。

智能家居音频方案：基础配置指南

1. 获取项目代码（仅源码部署需要）

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic

2. 配置文件设置

# 复制配置模板 cp config-example.json config.json

使用文本编辑器打开config.json，设置以下关键参数：

• "mi_account"：小米账号
• "mi_password"：小米密码
• "music_dir"：音乐存储路径
• "port"：Web服务端口

3. 设备连接与验证

1. 在Web界面点击"设备管理"
2. 系统会自动扫描局域网内的小爱设备
3. 选择要绑定的设备并点击"连接"
4. 听到音箱提示"已连接"即完成绑定

小爱音箱语音命令速查表

常见问题解决指南

问题1：端口被占用

解决方案：修改启动命令中的端口映射

# 容器化方案修改端口 docker run -p 8080:8090 -e XIAOMUSIC_PUBLIC_PORT=8080 ...

问题2：设备搜索不到

检查项：

• 确保音箱与服务器在同一网络
• 小米账号已开通音箱控制权限
• 防火墙未阻止设备发现端口

问题3：音乐下载失败

解决方案：

1. 检查网络连接
2. 确认yt-dlp已正确安装
3. 尝试更换下载源

小爱音箱音乐系统使用技巧

1. 歌单管理：在Web界面创建自定义歌单，支持拖拽排序
2. 音质设置：在"设置-音频"中调整输出音质，平衡音质与带宽
3. 定时播放：设置起床铃声或睡眠模式，自动播放指定歌单
4. 插件扩展：在plugins目录添加扩展插件，实现歌词显示等功能

通过以上步骤，你已成功将小爱音箱升级为智能音乐中心。无论是本地音乐管理还是网络音乐播放，Xiaomusic都能为你提供便捷的智能家居音频体验。

【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic