Проверка npm-зависимости перед установкой: скрипты, версии, аудит
- Какие скрипты npm запускает при установке и в каком порядке
- Где npm ожидает компиляцию, а где — произвольные действия
- Что показывают отчёты аудита и оповещения Dependabot
- Какие проверки сделать до добавления зависимости и чего автоматика не ловит
Вы добавляете пакет одной командой, а через неделю выясняется, что он делал что-то ещё. Неприятный сценарий известен: вредоносная библиотека в npm может выполнять код ещё до запуска приложения. Вопрос не в том, чтобы перестать ставить зависимости, а в том, чтобы понимать, что именно происходит при установке и что можно проверить заранее.
Ниже — порядок проверки: какие скрипты запускает npm, где ожидается компиляция, что показывают отчёты аудита и оповещения о зависимостях и какие границы у этих проверок. Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему стеку и рискам. Смежная тема — хешировать или шифровать: как хранить пароли и секреты, а варианты работ с сайтами собраны на странице контента и сайтов.
Что происходит при установке: какие скрипты запускает npm
В package.json есть поле scripts, и часть этих скриптов npm запускает в ходе установки. Документация npm перечисляет порядок для npm install: preinstall, install, postinstall, prepublish, preprepare, prepare и postprepare. То есть до того, как ваш код вообще начнёт выполняться, у пакета есть несколько точек, где может отработать чужой скрипт.
Отдельно стоит помнить про prepare: при npm install без аргументов он выполняется. Это не экзотика — так устроен жизненный цикл, и именно поэтому стоит смотреть не только на код библиотеки, но и на её скрипты.
Скрипты выполняются через передачу строки как аргумента скрипта в sh. Проще говоря, это обычная команда оболочки, а не изолированный вызов внутри Node.js. Скрипты из зависимостей тоже можно запускать вручную — командой npm explore <pkg> -- npm run <stage>. Это удобно для отладки, но и показывает, что скрипты зависимости — это исполняемый код, а не декларация.
Где npm ожидает компиляцию, а не произвольные действия
Есть случай, когда скрипты установки оправданы. Если в корне пакета лежит файл binding.gyp и свои скрипты install или preinstall не заданы, npm по умолчанию компилирует через node-gyp rebuild. Это компиляция под целевую архитектуру, и без неё нативный модуль просто не соберётся.
Документация npm прямо рекомендует почти никогда явно не задавать preinstall или install. Единственное допустимое применение этих скриптов — компиляция, которую нужно выполнить на целевой архитектуре. Значит, если пакет объявляет собственный install или preinstall, а компиляции там нет, это повод прочитать скрипт целиком и понять, что он делает.
Практический вывод простой: наличие binding.gyp при отсутствии собственных install и preinstall — ожидаемая картина для нативного модуля. Собственный install или preinstall без компиляции — повод разобраться внимательнее.
Что показывают отчёты аудита и оповещения о зависимостях
Отчёты аудита содержат таблицы с информацией об уязвимостях в зависимостях проекта. В таблице уязвимостей есть поля Severity, Description, Package, Patched in, Dependency of, Path и More info. Поле Patched in описывает диапазон семантических версий, в которых содержится исправление уязвимости, — по нему видно, до какой версии нужно обновиться.
Второй слой — оповещения о зависимостях. Dependabot сканирует ветку по умолчанию и отправляет оповещения, когда новая уязвимость добавлена в GitHub Advisory Database или когда меняется граф зависимостей — например, при пуше коммитов, обновляющих пакеты или версии.
Эти два инструмента отвечают на разные вопросы. Аудит показывает, что известно про уязвимости в текущем наборе зависимостей. Оповещения следят за изменениями и новыми записями в базе рекомендаций. Вместе они дают картину, но не заменяют чтения скриптов установки.
Границы автоматических проверок: что они не ловят
У оповещений есть прямо указанное ограничение: они не охватывают все проблемы безопасности. Для точного обнаружения нужно поддерживать манифесты и lock-файлы в актуальном состоянии — иначе картина зависимостей расходится с тем, что реально установлено.
Есть и задержка. Новые уязвимости могут появляться в GitHub Advisory Database не сразу, а оповещения срабатывают только по рекомендациям, проверенным GitHub. То есть отсутствие оповещения не доказывает, что с пакетом всё в порядке.
Отсюда практический вывод: автоматика ловит известное и уже описанное, а скрипты установки — это поведение пакета, которое нужно читать глазами. Аудит и Dependabot — необходимый, но не достаточный слой проверки.
Чек-лист проверки зависимости перед добавлением
Соберём порядок в один список. Он опирается на то, что описано выше, и не требует специальных инструментов сверх обычного чтения пакета.
Сначала посмотрите поля preinstall, install, postinstall и prepare в package.json пакета. Если они есть, прочитайте, что именно выполняется. Затем сверьте наличие binding.gyp: если он есть, а собственных install и preinstall нет — это ожидаемая компиляция. Если собственные скрипты есть, а компиляции нет — разбирайтесь, зачем они.
Дальше проверьте отчёт аудита и поле Patched in для найденных уязвимостей: оно показывает диапазон версий с исправлением. Убедитесь, что оповещения о зависимостях включены и Dependabot сканирует ветку по умолчанию. И держите манифест и lock-файлы в актуальном состоянии — от этого зависит точность обнаружения.
Условный пример: пакет объявляет postinstall, который скачивает и запускает сторонний файл. Аудит может быть чистым, оповещений нет, но скрипт при установке уже отработает. Именно поэтому чтение скриптов стоит до установки, а не после.