homecentr/cadvisor

HomeCentr - cAdvisor

镜像概述和主要用途

该Docker镜像是对原始https://github.com/google/cadvisor%E7%9A%84%E9%87%8D%E6%96%B0%E6%89%93%E5%8C%85%EF%BC%8C%E7%AC%A6%E5%90%88HomeCenter Docker镜像标准（包含S6 overlay、权限降低等特性）。主要用于监控Docker容器及主机系统资源使用情况，并以Prometheus格式提供指标数据。

核心功能和特性

• 基于官方cAdvisor构建，保留其容器监控核心功能
• 集成S6 overlay进程管理系统
• 支持权限降低：容器启动时以root权限完成初始设置，随后切换至指定UID/GID运行cAdvisor进程
• 提供Prometheus格式的监控指标输出
• 定期进行漏洞扫描和更新，确保安全性

使用场景和适用范围

适用于需要监控Docker容器资源使用情况的场景，如：

• 个人或小型服务器的容器监控
• 开发环境中的容器性能分析
• 与Prometheus+Grafana组合构建监控系统

使用方法和配置说明

Docker Compose配置示例

yaml
version: "3.7"
services:
  cadvisor:
    image: homecentr/cadvisor
    restart: unless-stopped
    ports:
      - 8080:8080
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /etc/machine-id:/etc/machine-id:ro

环境变量

暴露端口

卷挂载

必须挂载以下卷：

• /var/run/docker.sock:/var/run/docker.sock:ro：只读挂载Docker socket，用于获取容器信息
• /etc/machine-id:/etc/machine-id:ro：只读挂载机器ID文件，用于唯一标识主机

安全说明

• 容器定期进行漏洞扫描和更新，详细信息可查看https://github.com/homecentr/docker-cadvisor/security
• 容器支持权限降低：虽然容器以root权限启动，但仅用于初始设置，cAdvisor进程实际以PUID和PGID指定的非特权用户运行

⚠️ 警告：不要通过Docker Compose的user属性或--user参数直接更改容器用户，这会破坏权限降低逻辑。

💡 提示：要授予用户读取Docker socket的权限，可将其添加到Docker安装时自动创建的docker用户组。