Deep Dive: Trivy – escanear todas as imagens em execução toda noite e ler 241 achados sem pânico
Como o Trivy encontra vulnerabilidades conhecidas em imagens de contêiner, por que ele roda aqui como timer noturno em vez de um operator, o que o primeiro scan do blog encontrou – e como separar 241 achados "corrigíveis" nos poucos que exigem ação.

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Deep Dive da série em torno do Ansible Tour. O tour explica os roles, os deep dives explicam a tecnologia por baixo: como funciona, por que é usada assim aqui e o que deu errado pelo caminho.
Toda imagem neste setup está fixada em uma versão exata. Isso é bom para a reprodutibilidade e ruim para a segurança de um jeito bem específico: uma imagem fixada não melhora sozinha. Os pacotes Debian ou Alpine dentro dela envelhecem, o runtime Go com que um binário foi compilado envelhece, e todo dia são publicadas novas vulnerabilidades para software que não mudou nada. O host recebe suas atualizações de segurança toda noite pelo dnf-automatic; as imagens não recebiam nada – até alguém olhar. Agora o Trivy olha toda noite. Este post explica como ele encontra vulnerabilidades, como roda no blog desde 19 de outubro de 2026, o que o primeiro scan encontrou – 241 achados corrigíveis – e por que esse número é bem menos alarmante do que parece depois que você o organiza.
Índice
🧭 Como o Trivy funciona
Primeiro o inventário, depois a consulta ao banco de dados
O Trivy não executa nem ataca nada. Ele lê uma imagem camada por camada e monta um inventário: qual sistema operacional e release (Debian 13, Alpine 3.21, Ubuntu 22.04 …), quais pacotes em quais versões exatas segundo o banco de dados do gerenciador de pacotes, e quais dependências de linguagem estão compiladas nos binários ou listadas em lock files – módulos Go lidos das informações de build que todo binário Go carrega, npm, pip, Composer, Java e assim por diante. Depois ele compara esse inventário com seu banco de dados de vulnerabilidades.
O banco de dados é montado pelo projeto Trivy a partir de várias fontes – os security trackers das distribuições, o GitHub Advisory Database, o banco de vulnerabilidades do Go e outros – e baixado como um único arquivo de algumas centenas de megabytes. Para cada pacote ele sabe quais versões são afetadas por qual CVE e, se existir, em qual versão o problema foi corrigido.
Severidade e “fixed version” – os dois campos que importam
- Severidade (CRITICAL, HIGH, MEDIUM, LOW, UNKNOWN) vem da fonte – muitas vezes a classificação da própria distribuição, senão um score CVSS. Ela descreve a vulnerabilidade em geral, não o risco dela nesta imagem. Um bug CRITICAL em uma biblioteca que a imagem nunca chama continua listado como CRITICAL.
- Fixed version diz se existe uma correção. Sem ela, não há o que fazer além de aceitar o achado ou substituir o software. Com ela, a pergunta passa a ser: quem precisa entregá-la – a distribuição (já feito), o mantenedor da imagem (precisa de rebuild) ou o projeto upstream (precisa de novo release)?
Essa distinção é a chave para tudo o que vem abaixo. O Trivy relata o que é conhecido; ele não tem como saber se o trecho de código vulnerável é alcançável. Ler os resultados é, portanto, sempre um segundo passo feito por um humano.
De onde vem a imagem
O Trivy consegue ler uma imagem de um registry (remote), de um daemon Docker ou Podman local, de um arquivo tar – ou direto do containerd, o runtime que o K3s usa. Esta última opção significa: nenhum download extra, o scan vê exatamente a imagem que os pods executam. Neste setup ele precisa do socket e do namespace do K3s:
CONTAINERD_ADDRESS=/run/k3s/containerd/containerd.sock \
CONTAINERD_NAMESPACE=k8s.io \
trivy image --image-src containerd docker.io/library/mariadb:10.11.19
🛡️ Por que ele está aqui
- Imagens fixadas envelhecem em silêncio. O image refresh nos playbooks de update puxa imagens reconstruídas sob a mesma tag – mas nada nos dizia quando um rebuild valia a pena, ou quando uma imagem nunca ganharia um.
- O host estava coberto, os contêineres não. O dnf-automatic aplica patches no host toda noite; as 14 imagens que compõem o cluster estavam fora desse ciclo.
- Decisões precisam de dados. “Devemos trocar este exporter?” ou “Um update do K3s é urgente?” ficam mais fáceis com uma lista do que cada imagem realmente carrega.
🔧 O que este repositório faz
Um timer no host, não um operator no cluster
O jeito usual de rodar o Trivy no Kubernetes é o Trivy Operator: ele observa o cluster, inicia um scan job por workload e guarda os resultados como custom resources. Em um único nó pequeno isso significaria CRDs, um controller, scan pods – e para cada um deles exceções na image policy e nas NetworkPolicies que este setup aplica. O role common_trivy faz o mesmo trabalho com um binário e um script: um timer do systemd inicia trivy_scan.py toda noite às 05:15, depois das atualizações de segurança (01:00–02:00), da janela de reboot (03:30) e dos outros jobs noturnos.
O binário: fixado e com checksum
O Trivy é instalado a partir do arquivo de release do GitHub, com a versão e seu SHA-256 fixados em versions.yml. Esse segundo pin tem um motivo concreto: em março de 2026 o próprio pipeline de release do Trivy foi comprometido e distribuiu brevemente um build malicioso (advisory GHSA-69fq-xp46-6x23). Um scanner de segurança roda como root e lê tudo – exatamente a ferramenta da qual você quer ter certeza. A regra nas notas: atualizar só para um release com pelo menos duas semanas, e copiar o checksum do arquivo de checksums desse release. O get_url do Ansible recusa um arquivo cujo hash não bate.
Duas pequenas coisas em que a instalação esbarrou, ambas propositais em outro lugar: /tmp é montado com noexec pelo hardening CIS, então o arquivo é descompactado a partir de /root; e depois de descompactar, restorecon dá ao binário o label SELinux correto – arquivos escritos por um caminho temporário ficam, do contrário, com o label desse caminho, a mesma lição do binário do k3s.
O script
- Atualizar o banco de vulnerabilidades uma vez (
--download-db-only); todos os scans de imagem rodam depois com--skip-db-update. - Listar as imagens de todos os pods em execução. Pods finalizados de Jobs e CronJobs ficam de fora – a primeira versão os incluía, e um helm-install job que rodou uma vez na inicialização do cluster contribuiu com 32 achados para uma imagem que não roda.
- Escanear cada imagem a partir do containerd. Se falhar, tentar de novo a partir do registry (veja abaixo). Escrever um relatório JSON por imagem em
/var/lib/trivy/reports. - Escrever métricas para o textfile collector do node_exporter:
trivy_image_vulnerabilities{image, severity, fixable},trivy_image_scan_ok,trivy_db_update_ok,trivy_last_run_timestamp_seconds. O arquivo é escrito com um nome temporário e renomeado, então o node_exporter nunca lê só metade dele. - Comparar os achados CRITICAL e HIGH corrigíveis com a noite anterior e mandar e-mail só dos novos.
Por que um e-mail para achados novos e não um alerta
O design óbvio seria um alerta no Grafana “vulnerabilidade crítica com correção disponível”. O primeiro scan mostrou por que isso seria errado: a imagem do MariaDB contém gosu, um helper minúsculo escrito em Go, compilado com uma versão antiga do Go que tem uma vulnerabilidade CRITICAL na biblioteca padrão. Corrigir isso cabe aos mantenedores da imagem do MariaDB. Um alerta dispararia, se repetiria a cada quatro horas e continuaria assim por dias ou semanas – até ser ignorado, e junto com ele todos os outros alertas. O e-mail fala uma vez. Um achado que continua não gera e-mail de novo; um que desaparece é contado como “gone”. O Grafana só alerta quando o próprio scan está quebrado: falhou a atualização do banco ou o scan de uma imagem, ou a última execução bem-sucedida tem mais de 36 horas.
A lição: Um alerta combina com estados que você pode corrigir na hora. Para achados que muitas vezes ninguém consegue corrigir na hora, um e-mail sobre o que é novo funciona melhor do que um alerta que fica vermelho e, por isso, não interessa mais a ninguém.
Aceitar um achado
Alguns achados serão aceitos de propósito. Eles vão para a variável trivy_ignore, cada um com um motivo obrigatório, e acabam em um arquivo .trivyignore que o scan usa. A lista está vazia de propósito: cada entrada é uma decisão, não um padrão.
SELinux e o textfile collector
O node_exporter roda em seu próprio domínio SELinux desde o mesmo dia (depois de uma fase de aprendizado permissive, enforcing desde 20/21 de outubro). Seu diretório de textfile /var/lib/node_exporter/textfile ganhou um tipo próprio, homelab_node_exporter_textfile_t, com exatamente duas regras: o exporter pode listar o diretório e ler os arquivos. O scan, rodando como root, os escreve; arquivos novos herdam o tipo do diretório.
🔍 O que as primeiras execuções encontraram – sobre a própria ferramenta
Camadas que o containerd já tinha jogado fora
Duas de 15 imagens falharam na primeira execução: metrics-server e kube-state-metrics, com “content digest … not found”. O containerd descompacta as camadas da imagem em snapshots e pode descartar depois os blobs compactados das camadas; a imagem roda normalmente, mas não pode mais ser exportada por inteiro. O Trivy oferece --image-src containerd,remote como lista de fallback – o que não ajudou, porque ele só recorre ao fallback quando a imagem falta na primeira fonte, não quando falta uma camada. O script agora tenta de novo explicitamente com remote exatamente para essas imagens.
A lição: Quem lê dados do runtime esbarra em lacunas que o runtime deixa de propósito. Um segundo caminho – a imagem do registry – deixa o scan robusto.
Um AVC, encontrado pelos alertas de log do mesmo dia
A primeira versão da unit de scan tinha NoNewPrivileges=yes. O script chama k3s kubectl para listar os pods, e o binário do k3s faz a transição para o domínio SELinux container_runtime_t. Sob NoNewPrivileges, o SELinux recusa essa transição a menos que a policy a permita explicitamente, e registra avc: denied { nnp_transition }. O novo alerta do Loki para negações reais do SELinux disparou em minutos. A configuração saiu; a unit mantém as outras restrições do systemd (/usr e /etc somente leitura, sem diretórios home, /tmp privado, prioridade mínima de CPU e I/O, limite de 2 GB de memória).
A lição: Toda unit nova com NoNewPrivileges que inicia um programa com domínio SELinux próprio tem seu audit log verificado depois da primeira execução.
📊 Lendo 241 achados
Depois das correções, o scan relatou 209 achados CRITICAL/HIGH corrigíveis em 14 imagens em execução. Organizados por quem pode corrigi-los, o quadro muda completamente:
| Grupo | Achados | Quem pode corrigir | Ação |
|---|---|---|---|
| php-fpm_exporter 2.2.0 | 72 (5 dos 6 CRITICAL) | Ninguém: último release em 2022, ainda com OpenSSL 1.1 | Substituir, reconstruir ou remover – uma decisão, veja abaixo |
| MariaDB 10.11.19 | 26 | Mantenedores da imagem: um rebuild sob a mesma tag já foi publicado (libssl3) | Image refresh no playbook de update; gosu fica até o upstream reconstruí-lo |
| WordPress 7.1.3 (php8.4-fpm) | 32 | O Debian corrigiu curl, ghostscript, expat; a imagem oficial não foi reconstruída desde então | Esperar – o image refresh pega o próximo rebuild automaticamente |
| nginx, Redis (Alpine) | 4 | Mesma coisa: correções no Alpine, imagem ainda não reconstruída | Esperar |
| Binários Go: CoreDNS, metrics-server, cert-manager, kube-state-metrics, mysqld_exporter | 75 | Projetos upstream: novos releases com Go mais novo e módulos mais novos | Já nos releases mais novos; os que vêm com o K3s chegam com o próximo K3s |
Três lições dessa tabela:
- A maioria dos achados não exige ação nossa. Eles estão corrigidos em algum lugar upstream e vão chegar com o próximo rebuild ou release, que os playbooks de update já pegam.
- Uma imagem é um problema real. Um exporter que não tem release há quatro anos e ainda vem com OpenSSL 1.1 responde por quase um terço de todos os achados e por quase todos os CRITICAL. A exposição prática é pequena – ele só fala FastCGI com o PHP-FPM dentro do pod e serve métricas dentro do cluster, atrás de NetworkPolicies – mas “exposição pequena” não é motivo para manter software abandonado para sempre.
- “Corrigido” não significa “relevante”. A imagem do WordPress lista
linux-libc-dev, os headers do kernel – um contêiner usa o kernel do host, os headers só estão lá para compilar. Um candidato paratrivy_ignore, exatamente com esse motivo.
Uma pergunta surgiu na hora: existe uma imagem mais nova do WordPress que corrija seus 32 achados? Não. O WordPress 7.1.3 é o release atual, e a imagem 7.1.3-php8.4-fpm no blog tem o mesmo digest que a do registry. O Debian publicou os pacotes corrigidos, mas a imagem oficial não foi reconstruída desde então. Construir nossa própria imagem com um apt-get upgrade extra resolveria hoje – ao preço de manter um build de imagem para sempre. Esperar alguns dias pelo rebuild oficial é a troca melhor.
O que fazer com um e-mail
- A imagem foi reconstruída upstream sob a mesma tag? Então a próxima execução de update (image refresh) resolve – ou rode o playbook de update agora.
- Existe um release mais novo? Então suba o pin em
versions.yml, de preferência um que já tenha alguns dias. - Nenhum dos dois? Então é um achado a aceitar (com um motivo em
trivy_ignore) ou um motivo para substituir o software.
Custo
O banco de vulnerabilidades e o cache de camadas ocupam cerca de 1,6 GB em /var/cache/trivy. Uma execução noturna completa, incluindo o download do banco, leva menos de meio minuto de CPU no blog; execuções posteriores reaproveitam a análise de camadas em cache e levam poucos segundos. O scan roda com a prioridade mínima de CPU e I/O e um limite de 2 GB de memória, então não tem como deixar os sites lentos.
🆘 Cheat sheet: sintoma → comando
A versão curta deste artigo para o momento em que algo está errado. Rode no host como root; <…> são placeholders.
| Sintoma | Comando |
|---|---|
| O scan rodou? | systemctl list-timers trivy-scan.timerjournalctl -u trivy-scan -n 20 | grep "images scanned" |
| Rodar agora | systemctl start trivy-scan.service |
| O que está aberto agora? | python3 -c 'import json; [print(v["severity"], v["id"], v["pkg"], v["image"]) for v in json.load(open("/var/lib/trivy/last-findings.json")).values()]' | sort |
| Uma imagem em detalhe | trivy image --image-src containerd --skip-db-update <image>:<tag> |
| Um e-mail sobre um achado CRITICAL | # 1. rebuilt upstream under the same tag? -> next update run# 2. newer release? -> raise the pin in versions.yml# 3. neither -> trivy_ignore with a reason |
| Resultados do scan antigos demais | (time() - trivy_last_run_timestamp_seconds) / 3600 |
| Espaço em disco usado pelo cache | du -sh /var/cache/trivy |
🔭 O que vem a seguir
- Uma decisão sobre o exporter do PHP-FPM até 20 de janeiro de 2027, quando a aceitação dele expira: dois forks de uma pessoa só estão ativos (um com atualizações automáticas de dependências); senão, prorrogar a aceitação.
- Scan de configuração – testado uma vez em outubro de 2026 contra os manifests em produção do blog: 21 tipos de achados, quase todos decisões deliberadas (ingress na rede do host, volumes hostPath, imagens que rodam como root). Como job de CI ele precisaria de templates renderizados e de uma longa lista de ignore; não vale a pena por enquanto.
- Scan de segredos já está no CI: o gitleaks verifica todo o histórico do git a cada push, ao lado do hook de pre-commit.
- Um pequeno dashboard com a tendência de achados abertos por imagem.
🎯 As lições
- Imagens fixadas envelhecem em silêncio. O scan tem que verificar as imagens em execução, não a lista no repositório.
- Organize os achados por quem pode corrigi-los, não pela quantidade.
- “Corrigido em” importa mais para a decisão do que a severidade.
- Achados aceitos ganham um motivo e uma data de expiração.
- O próprio scanner também precisa de um pin com checksum – o pipeline de release dele foi comprometido em 2026.
⚖️ Alternativas – e por que o Trivy
| Opção | Ponto forte | Por que não aqui |
|---|---|---|
| Trivy Operator | Contínuo, resultados como recursos do Kubernetes | Controller, CRDs e scan pods em um único nó pequeno; exceções na image policy e nas NetworkPolicies. |
| Grype (Anchore) | Rápido, boa integração de SBOM com o Syft | Comparável; o Trivy lê o containerd diretamente e cobre mais ecossistemas em um único binário. |
| Scan no registry (Harbor/Clair, Docker Scout, GitHub) | Escaneia no momento do push | Não há registry próprio aqui – as imagens vêm do Docker Hub, Quay e registry.k8s.io como publicadas. |
| dnf updateinfo / OpenSCAP | Exato para o host | Cobre só os pacotes do host, não o que está dentro das imagens. |
| Trivy, como timer noturno no host | Um binário, lê as imagens em execução do containerd, métricas + e-mail | Escolhido. |
O sentido da ferramenta não é o número que ela relata, mas a organização que ela permite. 241 achados soavam como uma emergência. Organizados por quem pode corrigi-los, viraram uma decisão real, um image refresh – e muita espera pelo upstream, que a rotina de update existente já resolve.
