docker/scout-cli

Docker Scout CLI 镜像文档

镜像概述和主要用途

Docker Scout CLI 镜像是一个预打包了 Docker Scout 命令行工具（CLI）的容器镜像。Docker Scout CLI 是 Docker 官方提供的容器镜像安全分析工具，主要用于对容器镜像进行漏洞检测、依赖项分析、合规性检查及安全风险评估，帮助开发者和运维团队在软件开发生命周期中保障容器镜像的安全性。

核心功能和特性

• 漏洞扫描：检测容器镜像中的操作系统漏洞、应用依赖漏洞及配置缺陷。
• 依赖项分析：识别镜像中的软件包依赖关系，包括直接依赖和间接依赖。
• 安全风险评估：提供漏洞严重级别（如高危、中危、低危）及修复建议。
• Docker Hub 集成：与 Docker Hub 无缝对接，支持对仓库中镜像的批量分析。
• 轻量级设计：基于精简基础镜像构建，体积小、启动快，适合集成到 CI/CD 流程。

使用场景和适用范围

• 开发阶段：本地开发时对构建的镜像进行安全检查，提前发现潜在风险。
• CI/CD 流程：集成到 Jenkins、GitHub Actions 等持续集成工具中，自动化镜像安全扫描。
• 容器审计：对生产环境中的存量镜像进行定期安全审计，确保合规性。
• 团队协作：统一团队的镜像安全检测标准，降低人工操作成本。

详细使用方法和配置说明

前提条件

• 已安装 Docker 引擎（20.10+ 版本）。
• 拥有 Docker Hub 账号及个人访问令牌（PAT），PAT 需具备 repo:read 权限（用于拉取镜像）和 scout 权限（用于执行分析）。

认证配置

使用镜像时需通过环境变量传递 Docker Hub 认证凭据，支持以下参数：

基本使用（docker run 命令）

通过 docker run 命令直接运行镜像，执行 Docker Scout CLI 子命令。基本格式如下：

bash
docker run -it \
  -e DOCKER_SCOUT_HUB_USER=<your-docker-hub-username> \
  -e DOCKER_SCOUT_HUB_PASSWORD=<your-docker-hub-pat> \
  docker.xuanyuan.run/docker/scout-cli <sub-command> [options] <image-reference>

示例：扫描指定镜像的漏洞

分析 nginx:latest 镜像的漏洞情况：

bash
docker run -it \
  -e DOCKER_SCOUT_HUB_USER=myuser \
  -e DOCKER_SCOUT_HUB_PASSWORD=mypat \
  docker.xuanyuan.run/docker/scout-cli cves nginx:latest

常用子命令说明

Docker Scout CLI 支持多种子命令，核心功能如下：

Docker Compose 配置示例

如需通过 Docker Compose 集成，可创建 docker-compose.yml 文件如下：

yaml
version: '3.8'
services:
  scout:
    image: docker.xuanyuan.run/docker/scout-cli
    environment:
      - DOCKER_SCOUT_HUB_USER=myuser
      - DOCKER_SCOUT_HUB_PASSWORD=mypat
    command: cves nginx:latest  # 执行漏洞扫描子命令

运行命令：

bash
docker-compose up

注意事项

• PAT 安全管理：避免将个人访问令牌硬编码到配置文件中，建议通过 CI/CD 密钥管理工具（如 GitHub Secrets）动态注入。
• 镜像版本：建议指定具体版本标签（如 docker/scout-cli:1.2.0）而非 latest，确保环境一致性。
• 网络要求：镜像运行时需访问 Docker Hub 及漏洞数据库（如 CVE 数据库），确保网络通畅。

参考文档

更多关于 Docker Scout CLI 的详细用法，请参见官方文档：https://docs.docker.com/engine/reference/commandline/scout/