部署准备与环境检查
系统要求确认
开始部署前,请仔细核对以下环境配置:
- 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 运行环境(版本 20.10+) 至少 512MB 可用内存空间 稳定的网络连接环境 快速部署方案 **标准部署命令**: **国内网络优化版**: 服务访问与初始化 部署完成后,在浏览器地址栏输入:http://您的服务器地址:58090 **首次使用配置流程**: 登录小米账号验证设备权限 扫描发现可用音箱设备…
开始部署前,请仔细核对以下环境配置:
标准部署命令:
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 系列 | 全面兼容 | 客厅主控 |
| 触屏设备 | 界面适配 | 卧室使用 |
| 迷你音箱 | 基础播放 | 书房配用 |
系统具备广泛的音频格式兼容能力:
关键监控指令:
# 检查容器运行状态
docker container ls --filter name=xiaomusic
# 监控系统资源消耗
docker stats xiaomusic
# 查看实时运行日志
docker logs --tail 50 xiaomusic
配置信息备份:
tar -czf xiaomusic_backup_$(date +%Y%m%d).tar.gz /xiaomusic_config
音乐文件同步:
rsync -av --progress /xiaomusic_data/ /backup/music_library/
资源限制设置:
resources:
limits:
memory: 512M
cpus: '1.0'
网络连通性验证:
curl -I https://docker.io
端口冲突检查:
ss -tulpn | grep 58090
自动恢复机制:
restart_policy:
condition: on-failure
max_attempts: 3
日志分析要点:
在外部网络环境使用时,强烈建议启用访问密码:
docker run -d --name xiaomusic \
-p 58090:8090 \
-e ACCESS_PASSWORD=自定义密码 \
hanxi/xiaomusic
利用系统功能创建专属音乐空间:
{
"playlist_name": "个人收藏",
"songs": [
{
"title": "歌曲名称",
"source": "下载地址"
}
]
}
项目提供丰富的界面主题选项:
本手册指导您掌握小爱音乐 Docker 系统的完整部署与运维技能。请牢记以下关键原则:

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online