virtualzone/docker-container-stats

Docker Container Stats 镜像文档

镜像概述

Docker Container Stats是一个Web界面工具，用于查看Docker容器的历史和当前统计数据，包括CPU使用率、内存占用、网络I/O和块I/O等关键指标。该工具本身以Docker容器形式运行，便于快速部署和使用。

核心功能与特性

• 实时监控Docker容器的核心性能指标：CPU、内存、网络I/O、块I/O
• 支持查看历史统计数据与当前实时数据
• 提供直观的Web可视化界面，便于数据展示与分析
• 轻量级设计，通过Docker容器化部署，简化安装流程

使用场景与适用范围

适用于需要监控Docker容器运行状态的开发者、运维人员及系统管理员。可用于本地开发环境或服务器生产环境，帮助实时掌握容器性能状况，及时发现并排查性能瓶颈。

使用方法

Docker Run 部署

bash
docker pull virtualzone/docker-container-stats
docker run \
        -d \
        -p 8080:8080 \
        --volume=/var/run/docker.sock:/var/run/docker.sock:ro \
        --volume=/home/docker/storage/stats/db:/opt/docker-stats/db \
        --name stats \
        -e STATS_UPDATE_INTERVAL=10 \
        virtualzone/docker-container-stats

Docker Compose 部署

yaml
version: '3.6'
services:
  stats:
    image: virtualzone/docker-container-stats
    container_name: 'stats'
    ports:
      - '8080:8080'
    environment:
      STATS_UPDATE_INTERVAL: 10
    volumes:
      - '/var/run/docker.sock:/var/run/docker.sock:ro'
      - '/home/docker/storage/stats/db:/opt/docker-stats/db'

访问方式

部署完成后，通过浏览器访问 http://localhost:8080（将localhost替换为Docker主机的实际 hostname 或 IP地址）即可查看容器统计数据。

配置说明

必要卷挂载

• /var/run/docker.sock:/var/run/docker.sock:ro：必须挂载，容器通过此套接字获取Docker统计数据（只读权限）

可选卷挂载

• /opt/docker-stats/db：可选挂载，用于持久化SQLite数据库，保存历史统计数据（若不挂载，数据仅保存在容器内部，容器重启后丢失）

环境变量

• STATS_UPDATE_INTERVAL：统计数据更新间隔（单位：秒），默认值为10秒

安全建议

强烈建议不要将统计数据界面直接暴露到公网。如需访问控制，可通过前端Web服务器/代理（如Apache、Nginx等）配置密码保护。

截图

!https://raw.githubusercontent.com/virtualzone/docker-container-stats/master/img/all-containers-mem.png

!https://raw.githubusercontent.com/virtualzone/docker-container-stats/master/img/all-containers-net.png

!https://raw.githubusercontent.com/virtualzone/docker-container-stats/master/img/selected-container.png