Skip to content

Go

Features

Trivy supports two types of Go scanning, Go Modules and binaries built by Go.

The following scanners are supported.

Artifact SBOM Vulnerability License
Modules ✓ ✓ ✓2
Binaries ✓ ✓ -

The table below provides an outline of the features Trivy offers.

Artifact Offline1 Dev dependencies Dependency graph
Modules ✅ Include ✅2
Binaries ✅ Exclude -

Note

Trivy scans only dependencies of the Go project. Let's say you scan the Docker binary, Trivy doesn't detect vulnerabilities of Docker itself. Also, when you scan go.mod in Kubernetes, the Kubernetes vulnerabilities will not be found.

Go Modules

Depending on Go versions, the required files are different.

Version Required files Offline
>=1.17 go.mod ✅
<1.17 go.mod, go.sum ✅

In Go 1.17+ projects, Trivy uses go.mod for direct/indirect dependencies. On the other hand, it uses go.mod for direct dependencies and go.sum for indirect dependencies in Go 1.16 or less.

Go 1.17+ holds actually needed indirect dependencies in go.mod, and it reduces false detection. go.sum in Go 1.16 or less contains all indirect dependencies that are even not needed for compiling. If you want to have better detection, please consider updating the Go version in your project.

Note

The Go version doesn't mean your CLI version, but the Go version in your go.mod.

module github.com/aquasecurity/trivy

go 1.18

require (
        github.com/CycloneDX/cyclonedx-go v0.5.0
        ...
)

To update the Go version in your project, you need to run the following command.

$ go mod tidy -go=1.18

To identify licenses and dependency relationships, you need to download modules to local cache beforehand, such as go mod download, go mod tidy, etc. Trivy traverses $GOPATH/pkg/mod and collects those extra information.

Go binaries

Trivy scans binaries built by Go. If there is a Go binary in your container image, Trivy automatically finds and scans it.

Also, you can scan your local binaries.

$ trivy rootfs ./your_binary

Note

It doesn't work with UPX-compressed binaries.

Empty versions

There are times when Go uses the (devel) version for modules/dependencies and Trivy can't resolve them:

  • Only Go binaries installed using the go install command contain correct (semver) version for the main module. In other cases, Go uses the (devel) version3.
  • Dependencies replaced with local ones use the (devel) versions.

In these cases, the version of such packages is empty.

  1. It doesn't require the Internet access. ↩

  2. Need to download modules to local cache beforehand ↩↩

  3. See https://github.com/aquasecurity/trivy/issues/1837#issuecomment-1832523477 ↩