Trivy Docker镜像文档

镜像概述

Trivy是由Aqua Security开发的开源漏洞扫描器，专注于检测容器镜像及应用程序依赖中的安全漏洞。本Docker镜像由Oowy team维护，基于轻量级Alpine Linux构建，具备资源占用低、扫描高效的特点，支持多种架构，适用于容器安全检测、应用依赖审计等场景。

支持的标签

基于Alpine Linux 3.20

• latest
• 0.58.1-alpine3.20 0.58.0-alpine3.20

基于Alpine Linux 3.19

• 0.57.1-alpine3.19 0.57.0-alpine3.19 0.56.2-alpine3.19 0.56.1-alpine3.19 0.56.0-alpine3.19 0.55.2-alpine3.19 0.55.1-alpine3.19 0.55.0-alpine3.19 0.54.1-alpine3.19 0.54.0-alpine3.19 0.53.0-alpine3.19 0.52.2-alpine3.19 0.52.1-alpine3.19 0.52.0-alpine3.19 0.51.4-alpine3.19 0.51.2-alpine3.19 0.51.1-alpine3.19 0.51.0-alpine3.19 0.50.4-alpine3.19 0.50.2-alpine3.19 0.50.1-alpine3.19 0.50.0-alpine3.19 0.49.1-alpine3.19 0.49.0-alpine3.19 0.48.3-alpine3.19 0.48.2-alpine3.19 0.48.1-alpine3.19 0.48.0-alpine3.19 0.47.0-alpine3.19 0.46.1-alpine3.19 0.46.0-alpine3.19

基于Alpine Linux 3.18

• 0.54.1-alpine3.18 0.54.0-alpine3.18 0.53.0-alpine3.18 0.52.2-alpine3.18 0.52.1-alpine3.18 0.52.0-alpine3.18 0.51.4-alpine3.18 0.51.2-alpine3.18 0.51.1-alpine3.18 0.51.0-alpine3.18 0.50.4-alpine3.18 0.50.2-alpine3.18 0.50.1-alpine3.18 0.50.0-alpine3.18 0.49.1-alpine3.18 0.49.0-alpine3.18 0.48.3-alpine3.18 0.48.2-alpine3.18 0.48.1-alpine3.18 0.48.0-alpine3.18 0.47.0-alpine3.18 0.46.1-alpine3.18 0.46.0-alpine3.18

支持的架构

• amd64
• arm64v8

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 全面漏洞检测：支持扫描容器镜像、应用依赖（如编程语言库、框架）中的已知安全漏洞
• 版本化管理：提供明确版本标签（如0.58.1-alpine3.20），便于生产环境版本控制与稳定性保障
• 多架构支持：适配amd64和arm64v8架构，满足不同硬件环境需求

使用场景

• CI/CD集成：在持续集成流程中自动扫描构建的容器镜像，提前发现漏洞
• 应用依赖审计：检测项目依赖的第三方库、框架中的安全隐患
• 生产环境安全监控：定期扫描运行中的容器镜像，保障部署环境安全

使用方法

基本运行

通过docker run命令运行Trivy，传递子命令和参数即可执行扫描任务。示例：

bash
docker run -i -t oowy/trivy:latest image your-image-name:tag

（注：image为Trivy子命令，用于扫描容器镜像；your-image-name:tag为目标镜像名称及标签）

生产环境建议

为避免版本变更带来的风险，生产环境中推荐使用具体版本标签，而非latest：

bash
docker run -i -t oowy/trivy:0.58.1-alpine3.20 image your-image-name:tag

配置说明

Trivy需访问配置文件及目标资源以完成扫描，通常需通过以下方式配置容器：

• 挂载配置文件：使用-v参数将本地配置文件挂载至容器内（如Trivy配置文件、凭证文件）：

  bash
  docker run -v /local/path/to/config:/root/.trivy oowy/trivy:0.58.1-alpine3.20 image your-image-name:tag
  

• 设置工作目录：通过-w指定工作目录，使Trivy可访问相对路径的配置或目标文件：

  bash
  docker run -w /app -v /local/app:/app oowy/trivy:0.58.1-alpine3.20 fs /app
  

• 环境变量与凭证：通过-e传递环境变量（如代理设置、API密钥），或挂载凭证文件（如云服务提供商凭证）：

  bash
  docker run -e HTTP_PROXY=[***] -v /local/credentials:/credentials oowy/trivy:0.58.1-alpine3.20 image your-image-name:tag
  

自定义镜像构建

可将本镜像作为基础镜像，预设CLI配置或集成自定义脚本，示例Dockerfile：

dockerfile
FROM oowy/trivy:0.58.1-alpine3.20
# 复制自定义Trivy配置
COPY trivy.yaml /root/.trivy/config.yaml
# 设置默认扫描参数
ENTRYPOINT ["trivy", "--severity", "CRITICAL,HIGH", "image"]

社区支持

• 获取帮助：可通过以下渠道寻求支持：
  • Docker Community Slack
  • Server Fault
  • Unix & Linux
  • Stack Overflow
• 问题反馈：关于Trivy二进制的问题，请在Trivy主仓库提交issue。