Правила безопасности пакетных менеджеров: что проверить в проекте
- Какие скрипты в зависимости запускаются при установке и как их найти
- Где pnpm хранит правила и какие настройки в pnpm-workspace.yaml игнорируются
- Что покрывает npm audit и как читать его предупреждения
- Чек-лист решений перед добавлением зависимости в проект
Установка зависимости выглядит как одна команда: добавили пакет, дождались завершения, продолжили работу. Но в этот момент на вашей машине и в сборочном окружении выполняется чужой код — скрипты жизненного цикла, которые автор пакета положил в package.json. Отдельно от этого живут настройки самого пакетного менеджера: где хранятся правила, какие из них действительно читаются, а какие молча игнорируются.
Ниже — порядок проверки по официальной документации npm и pnpm: скрипты установки, настройки pnpm-workspace.yaml и аудит зависимостей. Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему стеку и вашим зависимостям. Смежная тема — проверка npm-зависимости перед установкой, а варианты работ с сайтами и кабинетами собраны на странице контента и сайтов.
Что именно проверять в скриптах установки зависимости
Поле scripts в package.json поддерживает встроенные события жизненного цикла и произвольные скрипты. Запускаются они командами npm run-script <stage> или npm run <stage>, а вместе с ними выполняются pre- и post-скрипты с совпадающими именами. То есть запись вида preinstall или postinstall — не декорация, а код, который выполнится в обход вашего явного вызова.
Скрипты зависимостей можно запустить и вручную: npm explore <pkg> -- npm run <stage>. Это удобный способ посмотреть, что именно делает пакет, не дожидаясь, пока он сработает сам при установке.
Отдельный случай — установка через git. Если пакет, устанавливаемый через git, содержит prepare-скрипт, его dependencies и devDependencies устанавливаются, а prepare-скрипт выполняется до упаковки и установки пакета. Здесь проверять нужно не только scripts, но и источник зависимости: репозиторий с веткой вместо фиксированной версии ведёт себя иначе, чем пакет из реестра.
Начиная с npm@7 скрипты жизненного цикла выполняются в фоне, и чтобы увидеть их вывод, нужен флаг --foreground-scripts. Без него установка проходит «тихо», и вы не видите, что именно печатал чужой скрипт. Сами скрипты выполняются через передачу строки как аргумента в sh, а ненулевой код выхода прерывает процесс.
Что с этим делать практически?
Документация npm рекомендует почти никогда явно не задавать preinstall или install-скрипты, а единственным допустимым применением install или preinstall называет компиляцию под целевую архитектуру. Это рекомендация для авторов пакетов, а не автоматическое правило для чужих зависимостей, но она задаёт ориентир: если пакет несёт install-скрипт без компиляции, стоит понять зачем.
Настройки pnpm: где лежат правила и что игнорируется
Если вы работаете с pnpm, важно понимать, откуда он читает настройки. Из файлов .npmrc pnpm берёт только auth, registry, TLS, proxy и local-address, а остальные настройки задаются в pnpm-workspace.yaml или глобальном config.yaml. Проект, где правила годами жили в .npmrc, после перехода на pnpm может вести себя иначе — и это стоит проверить до, а не после инцидента.
Отдельное правило касается URL реестров. В pnpm-workspace.yaml переменные окружения не раскрываются в настройках registry и URL-значениях registries и namedRegistries, а плейсхолдер ${...} в этих настройках приводит к ошибке команды. Причина в том, что pnpm-workspace.yaml коммитится в репозиторий: раскрытие переменных окружения в URL реестров могло бы позволить вредоносному репозиторию увести секреты окружения на подконтрольный атакующему реестр.
Поэтому динамические URL реестров pnpm рекомендует задавать в доверенном месте — глобальном конфигурационном файле или параметрах командной строки. Это не отменяет всех рисков, но убирает возможность управлять адресом реестра из файла, который приходит вместе с кодом.
Есть и обратная сторона: в pnpm-workspace.yaml проекта игнорируются с предупреждением настройки машиноуровневого состояния, включая configDir, globalDir, stateDir, userconfig и workspaceDir. Если вы рассчитывали, что проект задаст эти пути, проверьте фактическое поведение — предупреждение легко пропустить в выводе установки.
Аудит зависимостей: что он покрывает и как читать отчёт
npm audit проверяет direct dependencies, devDependencies, bundledDependencies и optionalDependencies, но не проверяет peerDependencies. Это важная граница: часть дерева зависимостей остаётся вне отчёта, и отсутствие находок не означает, что проблем нет.
Запускается аудит автоматически при установке пакета через npm install, а также может быть запущен вручную для локально установленных пакетов — с отчётом об уязвимостях и, если они есть, предложенными исправлениями. Для работы npm audit пакету нужны файлы package.json и package-lock.json: без блокировки версий отчёт не построить.
Читать отчёт стоит с оглядкой на характер рекомендаций. Если рекомендуемое исправление является потенциально ломающим изменением, оно сопровождается предупреждением SEMVER WARNING. Такое обновление нельзя применять вслепую: сначала проверьте, что код проекта переживёт смену мажорной версии.
Поскольку база рекомендаций может обновляться в любое время, документация npm советует регулярно запускать npm audit вручную или добавлять его в процесс непрерывной интеграции. Разовый прогон перед релизом устаревает быстрее, чем кажется.
И последнее: аудит при установке можно отключить для одного пакета флагом --no-audit.
Документация описывает сам флаг, но не оценивает последствия для безопасности — решение остаётся за вами, и отключать проверку стоит осознанно, а не ради более быстрой установки.
Чек-лист решений перед добавлением зависимости
Соберём проверки в один маршрут. Сначала откройте package.json пакета и найдите поле scripts: есть ли там install или preinstall. Затем посмотрите на источник зависимости — если это git, проверьте наличие prepare-скрипта, потому что при его наличии зависимости пакета установятся, а скрипт выполнится до упаковки.
Дальше — настройки. Если проект на pnpm, просмотрите registry, registries и namedRegistries в pnpm-workspace.yaml: плейсхолдер ${...} в URL реестра приведёт к ошибке команды, а динамические адреса pnpm советует держать в глобальном конфиге или параметрах командной строки. Сверьте, что в .npmrc остались только auth, registry, TLS, proxy и local-address — остальное pnpm оттуда не читает.
Перед запуском аудита убедитесь, что в проекте есть и package.json, и package-lock.json, иначе npm audit не построит отчёт. И проверьте, что аудит включён в шаги непрерывной интеграции или выполняется регулярно вручную: база рекомендаций обновляется, а разовая проверка этого не учитывает.
Условный пример, чтобы увидеть маршрут целиком.
Разработчик добавляет пакет, у которого в scripts есть install-скрипт без компиляции. По документации npm такой скрипт — повод разобраться, зачем он нужен. Дальше он смотрит источник: если пакет тянется через git с prepare-скриптом, установка затронет и devDependencies пакета. Затем проверяет pnpm-workspace.yaml на плейсхолдеры в URL реестров и убеждается, что аудит запускается в CI.
Это иллюстрация порядка проверок, а не результат аудита конкретного проекта.