superbrilliant/clair

superbrilliant/clair 镜像说明

镜像概述

Clair是一款开源的容器镜像漏洞静态分析工具，本镜像为Clair的修改版本，在保留原生漏洞扫描能力的基础上，新增了为当前使用镜像的用户自动分配用户名的功能，便于多用户场景下的身份识别与任务管理。

核心功能

• 容器镜像漏洞扫描：支持对Docker镜像进行静态分析，检测已知的安全漏洞（如CVE）；
• 自动用户身份分配：为当前运行镜像的用户生成或分配唯一用户名，方便区分不同用户的扫描任务；
• 兼容原生Clair特性：保留原Clair的所有核心功能，包括漏洞数据库更新、API接口等。

使用场景

1. CI/CD流程集成：在持续集成/部署 pipeline 中加入本镜像，自动扫描构建后的容器镜像，确保镜像安全；
2. 团队协作分析：团队成员使用本镜像进行镜像扫描时，通过用户名区分不同成员的扫描结果，便于协作管理；
3. 本地镜像安全检查：开发者在本地环境使用本镜像，快速评估自己构建的镜像是否存在安全漏洞。

配置说明

1. 数据库配置：Clair依赖PostgreSQL数据库存储漏洞数据，需通过环境变量 DB_URL 指定数据库连接地址（格式：postgres://username:password@host:port/database）；
2. 端口映射：Clair默认使用6060端口提供API服务，需将容器内6060端口映射到主机端口；
3. 用户名分配：本镜像的用户名分配功能无需额外配置，运行时自动为当前用户生成用户名。

部署示例

Docker Run 命令

bash
docker run -d \
  --name clair-instance \
  -p 6060:6060 \
  -e DB_URL=postgres://clair:password@postgres-host:5432/clair \
  superbrilliant/clair

Docker Compose 示例

yaml
version: '3'
services:
  clair:
    image: superbrilliant/clair
    ports:
      - "6060:6060"
    environment:
      - DB_URL=postgres://clair:password@postgres:5432/clair
    depends_on:
      - postgres
  postgres:
    image: postgres:14
    environment:
      - POSTGRES_USER=clair
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=clair
    volumes:
      - postgres-data:/var/lib/postgresql/data
volumes:
  postgres-data: