На главную

DF-ВЕБ-032 · Контент и сайты

Проверка npm-зависимости перед установкой: скрипты, версии, аудит

Редакция Deskforge · 14 ноября 2026 · 4 мин чтения
Проверка 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, который скачивает и запускает сторонний файл. Аудит может быть чистым, оповещений нет, но скрипт при установке уже отработает. Именно поэтому чтение скриптов стоит до установки, а не после.

Источники

Назад