При выполнении npm install, yarn или pnpm install пакетный менеджер может автоматически запускать скрипты, указанные в полях preinstall, install, postinstall, prepare и других. Если среди зависимостей окажется вредоносный пакет, такие скрипты могут выполнить произвольный код на вашей машине или в CI‑окружении. Ниже описано, как отключить автоматический запуск этих скриптов, при этом сохранив работоспособность проекта там, где скрипты действительно нужны.
- Почему скрипты могут быть опасны
- Основные способы отключения скриптов
- npm
- Yarn (1.x и 2+)
- pnpm
- Когда просто отключить скрипты недостаточно
- Практический чек‑лист перед отключением скриптов
- Сравнение флагов у разных менеджеров
- Как вернуть выполнение нужных скриптов после проверки
- Типичные ошибки и как их избежать
- Краткие рекомендации
Почему скрипты могут быть опасны
Скрипты install‑этапа выполняются с теми же правами, что и процесс установки. Они имеют доступ к файловой системе, переменным окружения, сети и могут:
- устанавливать дополнительные зависимости без вашего ведома;
- изменять или удалять файлы проекта;
- экспортировать конфиденциальные данные (токены, ключи) на внешние сервера;
- запускать майнинг или другие вредоносные процессы.
Не все скрипты опасны: многие легитимные пакеты используют postinstall для компиляции нативных модулей, генерации типов или подготовки ресурсов. Полное отключение может привести к ошибкам сборки, поэтому нужен выборочный подход.
Основные способы отключения скриптов
Большинство современных менеджеров пакетов предоставляют флаги и конфигурационные параметры, которые подавляют автоматический запуск скриптов на этапе установки. Ниже перечислены проверенные методы для npm, Yarn и pnpm.
npm
- Флаг командной строки – при вызове npm install добавьте —ignore-scripts. Например:
npm install —ignore-scripts - Глобальная конфигурация – установить значение по умолчанию для всех проектов:
npm config set ignore-scripts true
После этого любые последующие вызовы npm install будут игнорировать скрипты, пока вы не измените настройку обратно (npm config set ignore-scripts false).
Yarn (1.x и 2+)
- Флаг – yarn install —no-scripts (Yarn 1) или yarn install —ignore-scripts (Yarn 2+). Пример:
yarn install —ignore-scripts - Конфигурация – в файле .yarnrc.yml (Yarn 2) можно задать:
nodeLinker: node-modules
scriptsEnabled: false
Для Yarn 1 достаточно добавить в .yarnrc строку enable-scripts false.
pnpm
- Флаг – pnpm install —ignore-scripts. Пример:
pnpm install —ignore-scripts - Конфигурация – установить через pnpm config set ignore-scripts true или добавить в .npmrc строку ignore-scripts=true (pnpm читает тот же формат, что и npm).
Когда просто отключить скрипты недостаточно
Если после установки зависимости требуется выполнить определённые действия (например, собрать нативный модуль с помощью node-gyp или сгенерировать типы), полное отключение приведёт к ошибкам. В таких случаях рекомендуется следующая стратегия:
- Установить зависимости с флагом —ignore-scripts, чтобы убедиться, что никакой вредоносный код не выполнится.
- Проверить список скриптов, которые были бы выполнены. Это можно сделать, посмотрев поля scripts в package.json каждой зависимости (или используя команду npm ls —depth=0 —json и анализируя вывод).
- Для проверенных пакетов, которым действительно нужны скрипты, выполнить их вручную в контролируемой среде. Например:
# после установки без скриптов
npm run postinstall # если скрипт определён в корневом package.json
# либо вызвать скрипт конкретной зависимости:
npx some-package postinstall - Если скрипт нужен только на этапе разработки, можно добавить его в отдельный npm‑скрипт проекта (например, prepare) и запускать его явно после проверки кода.
Практический чек‑лист перед отключением скриптов
Чтобы не сломать проект, выполните следующие шаги:
- Сделайте резервную копию текущего node_modules и lock‑файла (package-lock.json, yarn.lock или pnpm-lock.yaml).
- Запустите аудит уязвимостей:
npm audit
или эквивалент для Yarn/pnpm. Это покажет известные проблемы в зависимостях, включая потенциально вредоносные пакеты. - Просмотрите список зависимостей с помощью npm list —depth=0 (или yarn list —depth=0, pnpm list —depth=0). Обратите внимание на пакеты с неизвестным издателем или те, которые недавно обновлены.
- Проверьте скрипты в зависимостях. Некоторые менеджеры позволяют вывести их:
# npm
npm explore — npm run
# Yarn 1
yarn run
# pnpm
pnpm exec —helpЕсли в списке присутствуют подозрительные названия (install, postinstall, prepublish без очевидной нужды), отметьте их для дальнейшего анализа.
- Запустите установку с игнорированием скриптов и соберите проект. Если сборка проходит успешно, скрипты, вероятно, не нужны для базовой работы.
- Если сборка падает, определите, какой пакет вызвал ошибку, и решите, нужно ли запускать его скрипт вручную или заменить пакет на более безопасный аналог.
Сравнение флагов у разных менеджеров
| Менеджер | Флаг для отключения скриптов | Примечание |
|---|---|---|
| npm | —ignore-scripts | Также можно задать через npm config set ignore-scripts true |
| Yarn 1 | —no-scripts | В конфиге .yarnrc – enable-scripts false |
| Yarn 2+ | —ignore-scripts | В .yarnrc.yml – scriptsEnabled: false |
| pnpm | —ignore-scripts | Через конфиг: pnpm config set ignore-scripts true или .npmrc – ignore-scripts=true |
Как вернуть выполнение нужных скриптов после проверки
После того как вы убедились, что проект корректно работает без автоматических скриптов, можно постепенно вернуть их выполнение только для доверенных пакетов:
- Создайте список «белого» набора пакетов, которым разрешен запуск скриптов (например, на основе внутреннего реестра или проверенных издателей).
- Установите зависимости обычным способом (npm install без флага) и сразу после установки выполните только нужные скрипты вручную:
# пример для одного пакета
npm run postinstall —if-present # выполнит скрипт только если он есть - В CI‑pipeline разделите этапы: сначала install —ignore-scripts, затем отдельный шаг run-scripts, который выполняет проверенный набор скриптов (например, через npm run prepare после аудита).
Типичные ошибки и как их избежать
- Ошибка: полное отключение скриптов приводит к падению сборки нативных модулей.Решение: определите, какие пакеты требуют компиляции (обычно они содержат binding.gyp или CMakeLists.txt), и запустите их скрипты вручную после проверки.
- Ошибка: полагаться только на npm audit для обнаружения вредоносных скриптов. Решение: аудит проверяет известные уязвимости, но не обнаруживает новые или целенаправленно вредоносные пакеты. Всегда дополнительно проверяйте поля scripts в package.json зависимостей.
- Ошибка: игнорировать скрипты только в локальной разработке, но не в CI. Решение: применяйте одинаковые флаги во всех окружениях, иначе злоумышленник может получить шанс выполнить код в процессе сборки.
Краткие рекомендации
- По умолчанию в CI и на серверах сборки используйте —ignore-scripts (или эквивалент).
- Локально можно оставить скрипты включёнными, если вы доверяете своему lock‑файлу и регулярно проводите аудит.
- После каждой значительной обновления зависимостей (npm update, yarn upgrade, pnpm update) повторяйте проверку скриптов.
- Если проект использует монорепозиторий (например, lerna, turbo или pnpm workspace), применяйте флаг корневоуровнево; он распространяется на все рабочие пространства.
- Документируйте выбранный подход в файле README или в внутреннем wiki, чтобы вся команда следовала одной практике.
Эта статья носит информационный характер. Она не заменяет профессиональную оценку безопасности зависимостей. Если ваш проект обрабатывает критически важные данные или работает в регулируемой среде, перед принятием решений о запуске или отключении скриптов рекомендуется провести дополнительный аудит с участием специалиста по информационной безопасности.
