Docker Desktop VM Stats Server 镜像文档

镜像概述和主要用途

该镜像提供一个轻量级服务器，专门用于收集、处理和展示Docker Desktop运行时的虚拟机（VM）统计信息。它能够实时监控Docker Desktop底层VM的性能指标，帮助用户了解VM的资源使用情况，是Docker Desktop性能监控和问题排查的辅助工具。

核心功能和特性

• 实时性能监控：收集并展示VM的CPU使用率、内存占用、磁盘I/O、网络吞吐量等关键性能指标。
• 数据持久化：支持将统计数据本地存储（如文件或轻量级数据库），便于历史数据查询和分析。
• API接口：提供简单的HTTP API接口，支持通过HTTP请求获取实时或历史统计数据。
• 轻量级设计：镜像体积小，资源占用低，不会对Docker Desktop及VM本身的性能造成显著影响。
• 可配置性：支持通过环境变量自定义监控参数（如数据收集间隔、端口等）。

使用场景和适用范围

• Docker Desktop性能调试：开发者在使用Docker Desktop过程中遇到性能问题（如卡顿、资源占用过高）时，用于定位VM层面的瓶颈。
• 日常运行监控：系统管理员或Docker Desktop用户需长期监控VM资源使用趋势时使用。
• 数据收集与分析：需要收集VM资源使用数据，用于生成性能报告或进行资源优化分析的场景。

使用方法和配置说明

前提条件

• 已安装Docker Desktop（支持Windows和macOS版本）。
• Docker引擎版本≥19.03。

镜像拉取

docker pull [镜像仓库地址]/vm-stats-server:latest

（注：请将[镜像仓库地址]替换为实际的镜像仓库地址，如Docker Hub或私有仓库）

基本运行示例

通过以下命令启动容器，默认配置下将在本地8080端口提供服务：

docker run -d \
  --name docker-desktop-vm-stats \
  -p 8080:8080 \
  [镜像仓库地址]/vm-stats-server:latest

自定义配置

可通过环境变量调整服务参数，常用环境变量说明如下：

自定义配置示例

docker run -d \
  --name docker-desktop-vm-stats \
  -p 9090:9090 \
  -e PORT=9090 \
  -e COLLECTION_INTERVAL=10 \
  -e LOG_LEVEL=debug \
  -v /host/path/to/data:/data \  # 挂载本地目录持久化数据
  [镜像仓库地址]/vm-stats-server:latest

访问统计数据

服务启动后，可通过以下方式获取统计数据：

• 实时数据API：访问 http://localhost:[PORT]/api/stats 获取当前VM实时统计数据（JSON格式）。
• 历史数据API：访问 http://localhost:[PORT]/api/history?start=[开始时间戳]&end=[结束时间戳] 获取指定时间段的历史数据（需启用数据持久化）。

注意事项

• 该镜像仅支持Docker Desktop环境，不支持Linux原生Docker（因Linux Docker无需底层VM）。
• 数据持久化需通过挂载卷实现，否则容器重启后统计数据将丢失。
• 部分VM统计指标可能因Docker Desktop版本或操作系统差异略有不同。