mtruneck/cadvisor

cadvisor镜像文档

镜像概述

该镜像为cadvisor（容器监控工具）的镜像，主要用于解决在Hetzner等被Google屏蔽IP的服务器环境中，无法直接从官方源获取cadvisor的问题。通过提供镜像，确保在IP受限环境中仍能正常使用cadvisor进行容器资源监控。

核心功能和特性

• 与官方cadvisor功能一致：提供容器资源使用数据（CPU、内存、磁盘I/O、网络等）的收集、聚合与导出功能
• IP限制解决方案：针对Google屏蔽Hetzner等服务商IP的情况，提供可访问的cadvisor镜像
• 兼容性：完全兼容官方cadvisor的配置方式和数据输出格式，可无缝替换官方版本

使用场景和适用范围

• Hetzner服务器环境：部署在Hetzner云服务器或独立服务器中，解决因IP被屏蔽导致无法获取官方cadvisor的问题
• IP受限网络环境：其他存在Google IP访问限制，导致无法直接拉取官方cadvisor镜像的场景
• 容器监控需求：需要对Docker容器进行资源监控和性能分析的场景

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name=cadvisor \
  --restart=always \
  -p 8080:8080 \
  -v /:/rootfs:ro \
  -v /var/run:/var/run:ro \
  -v /sys:/sys:ro \
  -v /var/lib/docker/:/var/lib/docker:ro \
  [镜像名称]

关键参数说明

• -p 8080:8080：映射cadvisor默认Web管理端口
• 挂载目录说明：
  • /:/rootfs:ro：只读挂载根文件系统，用于收集系统级信息
  • /var/run:/var/run:ro：只读挂载Docker运行时目录，用于获取容器运行状态
  • /sys:/sys:ro：只读挂载sysfs，用于收集系统硬件信息
  • /var/lib/docker/:/var/lib/docker:ro：只读挂载Docker数据目录，用于获取容器元数据

docker-compose配置示例

yaml
version: '3'
services:
  cadvisor:
    image: [镜像名称]
    container_name: cadvisor
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
      - /sys:/sys:ro
      - /var/lib/docker/:/var/lib/docker:ro

访问与验证

部署完成后，通过 http://<服务器IP>:8080 访问cadvisor Web界面，可查看容器资源使用情况、系统信息等监控数据。

注意事项

• 确保宿主机Docker服务正常运行
• 挂载目录需保持只读权限（:ro），避免对宿主机文件系统造成意外修改
• 若需自定义监控配置，可参考官方cadvisor文档添加额外命令行参数或配置文件