knqyf263/trivy

Trivy：简单全面的容器漏洞扫描工具

镜像概述和主要用途

Trivy（"tri"发音如"trigger"，"vy"发音如"envy"）是一款简单且全面的容器漏洞扫描工具。它能够检测操作系统包（如Alpine、Red Hat Universal Base Image、RHEL、CentOS、Debian、Ubuntu等）和应用依赖（如Bundler、Composer、Pipenv、Poetry、npm、yarn、Cargo等）的漏洞。Trivy易于使用，仅需安装二进制文件即可开始扫描，扫描时只需指定容器镜像名称。

Trivy特别适合在持续集成（CI）流程中使用，可在推送容器镜像至仓库前轻松扫描本地镜像，帮助开发和运维团队在早期发现并修复漏洞。

核心功能和特性

全面的漏洞检测

• 操作系统包：支持Alpine、Red Hat Universal Base Image、RHEL、CentOS、Debian、Ubuntu等
• 应用依赖：支持Bundler、Composer、Pipenv、Poetry、npm、yarn、Cargo等

简单易用

• 仅需指定镜像名称即可完成扫描
• 无需复杂配置，开箱即用

安装便捷

• 无需预先安装数据库或额外依赖库
• 支持多种安装方式（RPM、DEB、Homebrew、二进制包、源码编译等）

高精度检测

• 尤其对Alpine Linux和RHEL/CentOS系统的漏洞检测准确率高
• 其他操作系统的检测精度同样出色

适合DevSecOps流程

• 无缝集成主流CI平台（Travis CI、CircleCI、Jenkins等）
• 支持多种输出格式和自定义退出码，便于流程控制

使用场景和适用范围

适用场景

• CI/CD流程集成：在镜像构建完成后、推送至仓库前执行漏洞扫描，阻止漏洞镜像进入部署流程
• 本地开发环境：开发人员在本地构建镜像后快速检测漏洞，提前修复
• 容器仓库审计：定期扫描仓库中的镜像，发现潜在安全风险
• 生产环境检查：对运行中的容器镜像进行漏洞评估

适用人群

• 开发人员：在开发过程中确保镜像安全性
• 运维人员：监控和管理容器镜像的安全状态
• DevSecOps工程师：构建安全的CI/CD流水线

安装方法

RHEL/CentOS

1. 添加仓库配置至/etc/yum.repos.d/trivy.repo：

   ini
   [trivy]
   name=Trivy repository
   baseurl=https://knqyf263.github.io/trivy-repo/rpm/releases/$releasever/$basearch/
   gpgcheck=0
   enabled=1
   

2. 安装：

   bash
   sudo yum -y update
   sudo yum -y install trivy
   

   或直接安装RPM包：

   bash
   rpm -ivh https://github.com/knqyf263/trivy/releases/download/v0.0.15/trivy_0.0.15_Linux-64bit.rpm
   

Debian/Ubuntu

1. 替换[CODE_NAME]为系统代号（可通过lsb_release -c获取，如wheezy、jessie、stretch、buster、trusty、xenial、bionic）：

   bash
   sudo apt-get install apt-transport-https gnupg
   wget -qO - https://knqyf263.github.io/trivy-repo/deb/public.key | sudo apt-key add -
   echo "deb https://knqyf263.github.io/trivy-repo/deb [CODE_NAME] main" | sudo tee -a /etc/apt/sources.list.d/trivy.list
   sudo apt-get update
   sudo apt-get install trivy
   

   或直接安装DEB包：

   bash
   sudo apt-get install rpm
   wget https://github.com/knqyf263/trivy/releases/download/v0.0.15/trivy_0.0.15_Linux-64bit.deb
   sudo dpkg -i trivy_0.0.15_Linux-64bit.deb
   

Arch Linux

通过AUR安装：

bash
pikaur -Sy trivy-bin
# 或
yay -Sy trivy-bin

Mac OS X / Homebrew

bash
brew install knqyf263/trivy/trivy

二进制包（含Windows）

从https://github.com/knqyf263/trivy/releases/latest%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F/%E6%9E%B6%E6%9E%84%E7%9A%84%E5%BD%92%E6%A1%A3%E6%96%87%E4%BB%B6%EF%BC%8C%E8%A7%A3%E5%8E%8B%E5%90%8E%E5%B0%86%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E6%94%BE%E5%85%A5%60$PATH%60%E7%9B%AE%E5%BD%95%EF%BC%88%E5%A6%82Unix%E7%B3%BB%E7%BB%9F%E7%9A%84%60/usr/local/bin%60%EF%BC%89%EF%BC%8C%E5%B9%B6%E7%A1%AE%E4%BF%9D%E5%85%B7%E6%9C%89%E6%89%A7%E8%A1%8C%E6%9D%83%E9%99%90%E3%80%82

扫描RHEL/CentOS镜像需安装rpm命令。

源码编译

bash
mkdir -p $GOPATH/src/github.com/knqyf263
cd $GOPATH/src/github.com/knqyf263
git clone https://github.com/knqyf263/trivy
cd trivy/cmd/trivy/
export GO111MODULE=on
go install

快速开始

基本使用

指定镜像名称即可扫描：

bash
trivy python:3.4-alpine

Docker方式运行

扫描远程镜像

bash
docker run --rm -v [本地缓存目录]:/root/.cache/ knqyf263/trivy [镜像名称]

macOS示例：

bash
docker run --rm -v $HOME/Library/Caches:/root/.cache/ knqyf263/trivy python:3.4-alpine

扫描本地镜像

需挂载Docker socket：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  -v $HOME/Library/Caches:/root/.cache/ knqyf263/trivy python:3.4-alpine

若运行出错，请拉取最新版本镜像：docker pull knqyf263/trivy

使用指南

命令行参数说明

扫描示例

扫描镜像

bash
trivy knqyf263/test-image:1.2.3

扫描镜像文件

bash
trivy image --input path/to/image.tar

保存结果为JSON格式

bash
trivy --format json --output result.json python:3.4-alpine

按严重级别过滤漏洞

仅显示HIGH和CRITICAL级别漏洞：

bash
trivy --severity HIGH,CRITICAL python:3.4-alpine

按漏洞类型过滤

仅扫描应用依赖漏洞：

bash
trivy --vuln-type app python:3.4-alpine

跳过漏洞数据库更新

bash
trivy --no-update python:3.4-alpine

忽略未修复的漏洞

bash
trivy --ignore-unfixed python:3.4-alpine

指定退出码

发现CRITICAL漏洞时退出码设为2：

bash
trivy --exit-code 2 --severity CRITICAL python:3.4-alpine

忽略指定漏洞

创建.trivyignore文件：

# 忽略CVE-2019-1543
CVE-2019-1543
# 忽略rails-html-sanitizer的所有漏洞
rails-html-sanitizer

执行扫描：

bash
trivy --ignore-policy .trivyignore python:3.4-alpine

清除镜像缓存

bash
trivy --clear-cache

重置所有缓存和数据库

bash
trivy --reset

持续集成（CI）集成

Travis CI

在.travis.yml中添加：

yaml
language: bash
services:
  - docker
before_script:
  - docker pull python:3.4-alpine
  - curl -sfL https://raw.githubusercontent.com/knqyf263/trivy/master/contrib/install.sh | sh -s -- -b /usr/local/bin
script:
  - trivy --exit-code 1 --severity HIGH,CRITICAL python:3.4-alpine

CircleCI

在.circleci/config.yml中添加：

yaml
version: 2.1
jobs:
  scan:
    docker:
      - image: circleci/golang:1.14
    steps:
      - checkout
      - run:
          name: Install Trivy
          command: |
            curl -sfL https://raw.githubusercontent.com/knqyf263/trivy/master/contrib/install.sh | sh -s -- -b /usr/local/bin
      - run:
          name: Scan image
          command: trivy --exit-code 1 --severity HIGH,CRITICAL python:3.4-alpine
workflows:
  scan_workflow:
    jobs:
      - scan

私有Docker仓库授权

如需扫描私有仓库镜像，需先登录仓库：

bash
# Docker CLI登录
docker login private.registry.com
# 或设置环境变量
export TRIVY_USERNAME=username
export TRIVY_PASSWORD=password
trivy private.registry.com/image:tag

漏洞检测范围

操作系统包

Trivy通过解析操作系统的包管理数据库（如Alpine的apk、Debian的dpkg、RHEL的rpm）检测已安装包的漏洞，并与官方CVE数据库比对。

应用依赖

Trivy扫描应用依赖文件（如Gemfile.lock、package-lock.json、Cargo.lock、composer.lock等），提取依赖版本信息，与对应语言的安全数据库（如RubySec、npm audit、RustSec等）比对，发现应用层漏洞。

常见问题（Q&A）

Homebrew安装问题

• Q：Homebrew安装后提示"command not found"？
  A：确保Homebrew的bin目录（通常是/usr/local/bin或/opt/homebrew/bin）在$PATH中。

其他问题

• Q：扫描速度慢？
  A：首次扫描需下载漏洞数据库，后续扫描会使用缓存；可添加--no-update跳过数据库更新（适用于频繁扫描场景）。

• Q：如何更新Trivy？
  A：根据安装方式选择：RPM/DEB使用包管理器更新，Homebrew执行brew upgrade trivy，二进制包需手动下载新版本。

• Q：支持Windows系统吗？
  A：支持，可从GitHub Releases下载Windows二进制包。

与其他扫描工具的比较

概述

Trivy相比其他扫描工具（如Clair、Anchore Engine等）具有以下优势：

• 易用性：无需部署服务，单机二进制即可运行
• 速度：扫描速度快，适合CI流程集成
• 全面性：同时支持OS包和应用依赖漏洞检测
• 轻量级：资源占用低，无需额外数据库

与Clair比较

• Clair需要部署服务和数据库，Trivy为单机工具
• Trivy支持更多应用依赖类型的漏洞检测
• Trivy扫描速度通常更快

与Anchore Engine比较

• Anchore Engine功能更全面（如策略检查、合规性），但配置复杂
• Trivy专注于漏洞扫描，简单轻量，更适合快速集成到CI流程

与Quay、Docker Hub、GCR比较

• 这些平台的内置扫描通常仅支持基础镜像，Trivy可扫描本地构建的镜像
• Trivy提供更详细的漏洞信息和自定义过滤能力