Надпись all modules verified в терминале действует на многих разработчиков как успокоительное: кажется, что тулчейн только что просканировал зависимости на уязвимости, сверил каждую строчку с манифестом go.sum и выдал проекту индульгенцию перед релизом. На практике эта команда вообще не ищет дыры в чужом коде и даже не заглядывает в go.sum для проверки содержимого пакетов.
Я разобрал свежий эксперимент из канала «Библиотека Go-разработчика» и сверил его со спецификацией Go Modules Reference. Давай посмотрим, какую задачу решает go mod verify на диске, почему зеленый статус не спасет от вредоносной библиотеки и как собрать вокруг проекта надежный защитный контур.
Почему проверку кэша принимают за аудит безопасности
Путаница начинается с названия команды. В соседних экосистемах команды со словами audit или verify проверяют пакеты по базам уязвимостей или подтверждают подпись релиза. Из-за этого в CI-пайплайны часто ставят go mod verify с уверенностью, что сборка защищена от атак на цепочку поставок (supply-chain attacks).
Представь доставку продуктов на кухню. Когда курьер привозит запечатанный ящик, ты у двери сверяешь накладную и пломбу — в Go за этот входной контроль при скачивании отвечают файл go.sum и глобальная база sum.golang.org. Если пломба цела, ты убираешь банки в домашний шкаф — локальный кэш модулей (module cache) в $GOPATH/pkg/mod.
Команда go mod verify — это ревизия уже внутри твоего шкафа. Она не знает, не подмешал ли автор библиотеки бэкдор до релиза. Ее единственная задача — пройтись по полкам локального диска и убедиться, что после скачивания никто на компьютере или сборочном сервере не изменил архив и не подменил файлы в распакованной папке. Если злоумышленник официально выпустил пакет с закладкой, go mod verify спокойно напишет all modules verified — ведь на диске байты лежат ровно в том виде, в каком приехали из сети.
Как устроен кэш модулей и где в нем прячутся слепые зоны
Ты резонно спросишь: если команда не сверяет код пакетов с go.sum, то с чем она сравнивает файлы? Я заглянул в устройство директории $GOPATH/pkg/mod (путь переопределяется переменной GOMODCACHE), и там работает двухслойная схема хранения.
Когда Go скачивает зависимость через прокси (GOPROXY, по умолчанию https://proxy.golang.org,direct) или из репозитория, внутри $GOPATH/pkg/mod данные делятся на две зоны:
- Склад оригиналов (
cache/download/$module/@v/) — здесь лежат метаданные версии (.info), манифест (.mod), архив исходников (.zip) и файл.ziphash, куда при первичной загрузке записывается эталонный отпечаток архива. - Рабочая витрина (
$module@$version/) — распакованное содержимое.zip-архива, откуда компилятор читает.go-файлы при сборке всех проектов на машине.
Отпечаток в .ziphash начинается с префикса h1: и строки Base64. Это детерминированный алгоритм dirhash (golang.org/x/mod/sumdb/dirhash на базе SHA-256). Чтобы результат не зависел от сжатия или метаданных .zip, Go сортирует пути к файлам по алфавиту, считает SHA-256 от каждого файла и берет общий SHA-256 от полученного списка.
При вызове go mod verify тулчейн проходит по всем модулям сборки (build list из go list -m all), заново считает h1:-хеш для архива .zip и для распакованной папки $module@$version/, а затем сверяет оба значения с .ziphash. К файлу go.sum команда обращается лишь косвенно: если при расчете минимального выбора версий (MVS) в кэше не хватило промежуточного go.mod, она докачает его и проверит хеш манифеста по go.sum.
Здесь разработчики часто попадают в две ловушки:
- Игнорирование папки
vendor/. Если зависимости скопированы в проект командойgo mod vendor, вызовgo mod verifyвообще не смотрит в./vendor. Он проверит системный кэш$GOPATH/pkg/mod, выдаст зеленый статус, а измененный вручную файл изvendor/попадет в бинарник. - Флаг
-modcacherw. По умолчанию Go ставит на файлы кэша права только для чтения (0444, а на папки —0555), чтобы IDE или тесты случайно не испортили библиотеку. Чтобы удалять кэш обычнымrm -rfвместоgo clean -modcache, некоторые задаютgo env -w GOFLAGS=-modcacherw— и сами снимают защиту от записи для любых локальных скриптов.
Ломаем байт в кэше: эксперимент на Go 1.27.3
В стендовом тесте на Go 1.27.3 авторы разбора создали тестовый модуль example.com/cachetoy версии v1.0.0, раздали его через локальный file://-прокси и скачали в изолированный кэш. Воспроизведем этот сценарий: проверим чистый кэш, а затем снимем защиту 0444 с файла toy.go в распакованной копии и изменим в нем константу.
# 1. Загружаем зависимости и проверяем эталонное состояние кэша
go mod download
go mod verify
# Вывод: all modules verified (код возврата 0)
# 2. Находим путь к распакованному модулю и снимаем защиту read-only
MODULE_PATH=$(go list -m -f '{{.Dir}}' example.com/cachetoy)
chmod +w "$MODULE_PATH/toy.go"
echo "// modified in local cache" >> "$MODULE_PATH/toy.go"
# 3. Запускаем проверку повторно
go mod verify
# Вывод: example.com/cachetoy v1.0.0: dir has been modified (/home/user/go/pkg/mod/example.com/cachetoy@v1.0.0)
# Код возврата: 1
На первом шаге хеш распакованного каталога совпал с cache/download/example.com/cachetoy/@v/v1.0.0.ziphash, и команда завершилась с кодом 0. Но после chmod +w и правки toy.go пересчет dirhash по рабочей папке разошелся с .ziphash: go mod verify мгновенно выдал ошибку dir has been modified и вернул код 1. Чтобы вернуть окружение в норму, достаточно сбросить кэш через go clean -modcache и заново выполнить go mod download.
Как собрать полноценный защитный контур для Go-проекта
Безопасность цепочки поставок в Go строится из нескольких уровней. Даже пакет с валидным хешем может таить угрозу при запуске тестов — ранее мы разбирали, почему функции init() в зависимостях Go ставят под удар CI-секреты при вызове go test, и смотрели, как анализатор stdversion в Go 1.27 страхует go.mod от вызовов слишком свежих функций.
Чтобы не путать задачи встроенных механизмов, сведем их в общую таблицу:
| Инструмент | Что сверяет | От чего защищает | Слепая зона |
|---|---|---|---|
go.sum | Хеши go.mod и .zip при загрузке | Подмена архива прокси или перезапись тега | Правка распакованных .go-файлов на диске |
sum.golang.org (GOSUMDB) | Глобальное дерево Меркла релизов | Таргетированная подмена при первой загрузке | Приватные модули (GOPRIVATE) и локальный диск |
go mod verify | Архивы .zip и папки кэша с .ziphash | Сбои диска, правки в IDE, порча кэша CI | CVE в коде, бэкдоры автора и папка vendor/ |
go mod vendor | Копии в vendor/ и vendor/modules.txt | Сбои сети и (с git diff) правки в vendor/ | Уязвимости внутри самих библиотек |
govulncheck | Граф вызовов кода по базе CVE | Вызов уязвимых функций в зависимостях | Локальная подмена байтов в кэше сборки |
Если в твоем пайплайне общий том $GOPATH/pkg/mod монтируется между сборками ради скорости, запускай go mod verify до компиляции. Обычный go build сверяет с go.sum уже готовый файл .ziphash, чтобы не пересчитывать тяжелые архивы, и не заметит, если соседняя джоба изменила распакованный .go-файл в кэше.
Объединим проверку кэша, контроль папки vendor/ и поиск известных уязвимостей через официальный сканер govulncheck в единый блок для CI-пайплайна:
# 1. Проверяем неизменность архивов и распакованных папок в $GOPATH/pkg/mod
go mod verify
# 2. При использовании vendoring проверяем отсутствие ручных правок в vendor/
go mod vendor
git diff --exit-code vendor/
# 3. Сканируем граф вызовов проекта на известные CVE
go install golang.org/x/vuln/cmd/govulncheck@latest
govulncheck ./...
В такой связке go mod verify подтверждает целостность файлов на диске сборочного агента, git diff --exit-code vendor/ останавливает пайплайн при любых расхождениях в закоммиченном каталоге vendor/, а govulncheck ./... проверяет, не вызывает ли твой код функции с опубликованными уязвимостями.
Прямо сейчас открой терминал на рабочей машине и выполни простую двухходовку: проверь через go env GOFLAGS, не включен ли у тебя флаг -modcacherw, и запусти go mod verify в текущем проекте — за пару секунд ты убедишься, что ни IDE, ни старые тесты не оставили случайных правок в твоем локальном кэше.



