nicolargo/glances

Glances - 系统监控利器

镜像概述和主要用途

Glances是一款开源软件，旨在监控容器运行所在的主机以及所有其他容器。用户可通过控制台或基于Web的用户界面进行操作，并能将统计数据导出至CSV/JSON文件或时序数据库。

核心功能和特性

• 监控主机系统和所有容器的运行状态
• 支持两种用户界面：控制台模式和Web UI模式
• 可将统计数据导出至CSV/JSON文件或时序数据库
• 提供多种镜像版本，满足不同依赖需求
• 支持Nvidia GPU监控（需额外配置）

快速开始

拉取镜像

拉取"完整开发版"（ubuntu-dev或alpine-dev标签）：

bash
docker pull nicolargo/glances:ubuntu-dev

运行控制台模式

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host --network host -it nicolargo/glances:ubuntu-dev

运行Web UI模式

bash
docker run -d --restart="always" -p 61208-61209:61208-61209 -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host nicolargo/glances:ubuntu-dev

可用版本

拉取镜像

bash
docker pull nicolargo/glances:<version>

可用标签

• latest-full: 完整的Alpine Glances镜像（最新版本），包含所有依赖项
• ubuntu-latest-full: 完整的Ubuntu Glances镜像（最新版本），包含所有依赖项
• ubuntu-latest: 基础的Ubuntu Glances（最新版本），包含最小依赖项（FastAPI和Docker）
• latest: 基础的Alpine Glances（最新版本），包含最小依赖项（FastAPI和Docker）
• dev: 基础的Alpine Glances镜像（基于开发分支和最新网络安全更新），包含所有依赖项（注意：可能不稳定）
• ubuntu-dev: 基础的Ubuntu Glances镜像（基于开发分支和最新网络安全更新），包含所有依赖项（注意：可能不稳定）

也可指定具体版本（例如：4.3.1）。

示例：拉取并运行最新完整版本

拉取镜像：

bash
docker pull nicolargo/glances:ubuntu-latest-full

运行控制台模式：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host --network host -it nicolargo/glances:ubuntu-latest-full

运行Web服务器模式（注意使用环境变量GLANCES_OPT设置Glances启动参数）：

bash
docker run -d --restart="always" -p 61208-61209:61208-61209 -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host nicolargo/glances:ubuntu-latest-full

使用自定义配置文件

可通过挂载本地配置文件运行：

bash
docker run -v `pwd`/glances.conf:/glances/conf/glances.conf -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host -it nicolargo/glances:ubuntu-latest-full

其中pwd/glances.conf是包含您自定义glances.conf文件的本地目录。

构建自定义容器

如需使用自定义glances.conf文件，可创建自己的Dockerfile：

dockerfile
FROM nicolargo/glances:ubuntu-latest-full
COPY glances.conf /glances/conf/glances.conf
CMD python -m glances -C /glances/conf/glances.conf $GLANCES_OPT

使用GPU插件（仅支持Nvidia GPU）

需先完成Docker文档中提到的步骤，使Docker引擎能够访问GPU。

使用docker run

在docker run命令中包含--gpus标志（注意：--gpus必须放在镜像名称之前，否则无效）：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --gpus --pid host --network host -it docker.io/nicolargo/glances:ubuntu-latest-full

使用docker-compose

在compose文件的服务定义中包含deploy部分：

yaml
version: '3'

services:
  monitoring:
    image: nicolargo/glances:ubuntu-latest-full
    pid: host
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock
    environment:
      - "GLANCES_OPT=-w"
    # 针对Nvidia GPU
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]