На главную

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

Правила безопасности пакетных менеджеров: что проверить в проекте

Редакция Deskforge · 16 ноября 2026 · 5 мин чтения
Правила безопасности пакетных менеджеров: что проверить в проекте
Из статьи вы узнаете
  • Какие скрипты в зависимости запускаются при установке и как их найти
  • Где 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.

Это иллюстрация порядка проверок, а не результат аудита конкретного проекта.

Источники

Назад