# Trivy 曾遭投毒，但仍该赶在客户之前扫镜像

> 一条命令就能赶在客户之前查出已知漏洞和泄露的密钥；3 月的标签劫持事件则改变了在客户 CI 中运行它的方式。

原文: https://fdetimes.net/zh/tools/trivy-scan-container-images-before-handover/

2026 年 3 月，一款安全扫描器里出现了恶意代码。Aqua Security 表示，trivy-action 的 77 个版本标签中有 76 个被强制推送（force-push）到恶意提交，同时还发布了一个恶意的 Trivy v0.69.4 二进制文件。

Trivy 依然值得留在前线部署工程师（FDE）的工具箱里，但这次事件改变了使用它的方式。这个工具的价值很简单：提前让你看到客户安全团队可能发现的问题。

设想一家银行的安全团队扫描你刚交付的镜像，在里面发现了一个 API 密钥。你损失的不只是几天修复时间，还有信誉，而且恰好是在客户决定是否让系统上生产环境的关头。交付前自己先扫一遍，成本要低得多。

## 一条命令回答两个问题

Trivy 是 Aqua Security 维护的开源项目，采用 Apache-2.0 许可证。它的覆盖面很广：漏洞、错误配置、密钥和 SBOM，扫描对象包括容器镜像、文件系统、远程 git 仓库、虚拟机镜像和 Kubernetes。

对容器镜像，默认开启两个扫描器：漏洞（vulnerability）和密钥（secret）。它们对应两个问题：镜像里的软件组件有没有已知漏洞？有没有机密信息暴露在外？

漏洞扫描同时覆盖操作系统软件包和编程语言依赖包。因此，同一份报告既能反映基础镜像的情况，也能反映应用依赖的情况，而这两者往往由不同的人负责。

## FDE 什么时候需要 Trivy？

最典型的时机是交付前夕：镜像已经构建好，但还没离开你手里。第二个时机是客户发来一份问题清单，你需要拿它和正在运行的镜像逐项核对。

第三个时机最早：刚拿到客户代码仓库的时候。密钥扫描同样适用于文件系统和 git 仓库，所以在把仓库打包成任何东西之前，你就能知道里面有什么。

## 交付日之前的一次扫描

举个假设的例子：你即将向客户交付镜像 `acme/api:1.4.2`。第一次运行不需要任何参数，因为需要的两个扫描器已经默认开启。

```bash
trivy image acme/api:1.4.2
```

假设结果显示 180 个漏洞和 1 个密钥。不要先看那 180 个。密钥可以马上处理，也是最不该等别人来发现的问题。如果镜像曾经推送到某个镜像仓库，就要把这个密钥视为已泄露：先吊销并重新签发，再重新构建镜像。

重新构建后再扫一次，去掉尚无补丁的漏洞，因为这些条目无法靠升级版本修复。

```bash
trivy image --ignore-unfixed acme/api:1.4.3
```

假设少了 120 条，剩下 60 条。现在你有了一份可以动手的清单：升级基础镜像，升级依赖，重新扫描。需要单独检查某一类时，用 `--scanners` 只运行对应的扫描器：

```bash
trivy image --scanners secret acme/api:1.4.3
```

## 过滤帮你聚焦，也容易让你自欺

回到那 120 条。`--ignore-unfixed` 只是把它们从屏幕上移走，并没有从镜像里移走。如果你只发过滤后的报告，而客户安全团队跑的是完整扫描，他们会看到 120 条你从未提过的问题。

更稳妥的做法是两份报告都发，并用一句话说明过滤了什么、为什么过滤。交付邮件的目标不该是“零”，而是让客户安全团队看到你清楚自己的风险。

忽略文件也需要同样的纪律。Trivy 支持用 `.trivyignore` 和 `.trivyignore.yaml` 忽略漏洞、错误配置和密钥，所以一行仓促加上的规则就可能藏住一个真实的密钥。一条合理的规则是：每个忽略条目都要经过代码评审，写明原因和负责人。

更大的局限在数据本身。Trivy 文档明确说明，工具只使用其列出的来源中的安全公告，尚未收录进这些来源的漏洞不会出现在报告里。

**要点:** 报告干净只说明扫描器什么都没看到，不说明你的镜像是安全的。

所以，交付邮件里不要写“镜像是安全的”。要写得更精确：用哪个 Trivy 版本、在哪天扫描、结果是什么。

## 在客户的 CI 里，标签不是承诺

Aqua 提供了官方 GitHub Action `aquasecurity/trivy-action`，用于对 Docker 镜像运行 Trivy。被强制推送 77 个标签中 76 个的，正是这个组件。也就是说，指向标签的工作流可能在仓库里没人改动一行代码的情况下，运行了恶意代码。

Aqua 建议把 action 固定到完整的 commit SHA，而不是版本标签，因为 SHA 不可变，标签可变。要查某个标签指向哪个提交，直接问仓库即可，把 `TAG` 换成你打算使用的标签：

```bash
git ls-remote https://github.com/aquasecurity/trivy-action "refs/tags/TAG" "refs/tags/TAG^{}"
```

输出开头是一个 40 位的 SHA。如果有两行，以 `^{}` 结尾的那一行才是要固定的提交。

到这里还不够。这条命令只告诉你标签此刻指向哪里，并不能证明这个提交是干净的。把 SHA 写进工作流之前，先在 GitHub 上打开这个提交，读一遍改动，并与 Aqua 的公告对照。

一个最小化的工作流大致如下，沿用上文的假设镜像：

```yaml
name: scan-image
on: pull_request
permissions:
  contents: read
jobs:
  trivy:
    runs-on: ubuntu-latest
    steps:
      - uses: aquasecurity/trivy-action@FULL_COMMIT_SHA # TAG
        with:
          image-ref: acme/api:1.4.3
```

这个文件只用来演示 SHA 固定，还算不上 CI 里真正的关卡：镜像名是写死的，文件也没有定义任务何时通过、何时失败。

标签名放在注释里，方便评审者知道你想用哪个版本，而实际运行的是 SHA。还要注意，这个任务没有声明任何密钥。如果镜像放在私有仓库，任务就需要凭据，加之前要先权衡清楚。

不要轻视固定这一步，因为 action 被替换的代价很高。Aqua 要求把受影响 runner 能访问的所有密钥都视为已泄露，也就是全部轮换。

在客户的 CI 里，这台 runner 上放的可能是客户的凭据，而不是你的。添加任何 action 之前，先弄清这个任务能接触哪些密钥。然后检查机器和 runner 是否仍在使用 v0.69.4。

如果在某台 runner 上发现这个版本，就把它能访问的所有密钥视为已泄露并轮换，即便你没看到任何被滥用的迹象。

## 先学什么，怎么讲出来

合理的顺序是：先对自己的某个镜像运行 `trivy image`，弄懂报告的每一部分，再练习 `--ignore-unfixed`、`.trivyignore` 和 `--scanners`。熟练之后，再用固定 SHA 的 action 接入工作流。Kubernetes、虚拟机镜像等其他扫描对象可以以后再说。

对职业发展而言，有价值的不是会某条命令。简历上要写成果：交付前扫描镜像、处理密钥、把问题清单压缩到客户安全团队能够审阅的程度、把 CI 固定到 SHA。

看岗位描述时，留意 container security、SBOM 或 customer security review 这类词。如果出现了，就准备好一个你亲手做过的镜像扫描案例，面试时讲清楚你如何决定忽略哪些条目，又是怎么向客户说明的。

下次安全团队问“这个镜像扫过了吗？”，可信的回答不在于一个零，而在于你能说清用什么扫的、过滤了什么，以及为什么这个扫描器值得在他们的系统里运行。

**本周动手试试:**

- 对你最近交付的镜像运行 trivy image，先处理完所有密钥，再看漏洞部分。
- 对比完整报告和 --ignore-unfixed 报告，然后写一页分诊说明，就当要发给客户安全团队。
- 在你管理的工作流里找出所有指向版本标签的 uses: 行，改为完整的 commit SHA，从 trivy-action 开始。

## 信源

- [GitHub - aquasecurity/trivy](https://github.com/aquasecurity/trivy)

- [Container Image - Trivy](https://trivy.dev/latest/docs/target/container_image/)

- [Secret - Trivy](https://trivy.dev/latest/docs/scanner/secret/)

- [Vulnerability Scanning](https://trivy.dev/latest/docs/scanner/vulnerability/)

- [Filtering - Trivy](https://trivy.dev/latest/docs/configuration/filtering/)

- [GitHub - aquasecurity/trivy-action](https://github.com/aquasecurity/trivy-action)

- [Update: Ongoing Investigation and Continued Remediation](https://www.aquasec.com/blog/trivy-supply-chain-attack-what-you-need-to-know)
