部署准备与环境检查
系统要求确认
开始部署前,请仔细核对以下环境配置:
- Docker 运行环境(版本 20.10+)
- 至少 512MB 可用内存空间
- 稳定的网络连接环境
快速部署方案
标准部署命令:
docker run -d --name xiaomusic \
-p 58090:8090 \
-v /xiaomusic_data:/app/data \
-v /xiaomusic_config:/app/config \
hanxi/xiaomusic:latest
国内网络优化版:
docker run -d --name xiaomusic \
-p 58090:8090 \
-v /xiaomusic_data:/app/data \
-v /xiaomusic_config:/app/config \
registry.cn-hangzhou.aliyuncs.com/hanxi/xiaomusic
服务访问与初始化
部署完成后,在浏览器地址栏输入:http://您的服务器地址:58090
首次使用配置流程:
- 登录小米账号验证设备权限
- 扫描发现可用音箱设备
- 配置音乐存储目录路径
核心功能深度解析
语音交互配置:智能控制的完美实现
小爱音乐 Docker 最吸引人的功能就是完整的语音控制集成,您可以通过简单的语音指令操作:
常用语音控制命令:
- "播放音乐" - 启动本地音乐播放
- "播放林俊杰的歌" - 按歌手筛选播放
- "暂停播放/继续播放" - 播放状态控制
- "循环播放/顺序播放" - 播放模式切换
多设备统一管理
支持多种小爱音箱型号,构建完整的家庭音乐网络:
| 设备型号 | 功能支持 | 适用场景 |
|---|---|---|
| L06A 系列 | 全面兼容 | 客厅主控 |
| 触屏设备 | 界面适配 | 卧室使用 |
| 迷你音箱 | 基础播放 | 书房配用 |
音频格式全面支持
系统具备广泛的音频格式兼容能力:
- ✅ MP3、FLAC、WAV(标准格式)
- ✅ AAC、OGG、M4A(扩展格式)
- ✅ 网络音频流(在线资源)
系统运维与管理
容器运行状态监控
关键监控指令:
# 检查容器运行状态
docker container ls --filter name=xiaomusic
# 监控系统资源消耗
docker stats xiaomusic
# 查看实时运行日志
docker logs --tail 50 xiaomusic

