keramss/docker-exporter 监听 HTTP /metrics，周期性调用 Docker Engine API 汇总容器与镜像统计。运行必须挂载 /var/run/docker.sock，等价于 root 级宿主机访问，禁止在无 socket 挂载的 Kubernetes Deployment 中使用。正确做法是在 Docker 宿主机上以 --restart 运行，或 K8s 侧改用 cAdvisor/kubelet metrics 而非本镜像。

快速启动

docker run -d --name docker-exporter \
  -p 9417:9417 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  docker.io/keramss/docker-exporter:latest

推荐实践

docker run -d --name docker-exporter \
  --restart unless-stopped \
  -p 9417:9417 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -e DOCKER_HOST=unix:///var/run/docker.sock \
  -e SCRAPE_INTERVAL=15s \
  docker.io/keramss/docker-exporter:1.0.0

核心参数说明

• -v /var/run/docker.sock:...:ro — 读取 Docker 引擎 API
• -p 9417:9417 — Prometheus metrics 端口
• -e SCRAPE_INTERVAL — 采集周期
• -e DOCKER_HOST — 明确 socket 路径
• --restart unless-stopped — 监控代理持续运行
• 警告 — docker.sock 挂载等同宿主机 root 权限