Как отключить рискованные install‑скрипты без поломки проекта

При выполнении npm install, yarn или pnpm install пакетный менеджер может автоматически запускать скрипты, указанные в полях preinstall, install, postinstall, prepare и других. Если среди зависимостей окажется вредоносный пакет, такие скрипты могут выполнить произвольный код на вашей машине или в CI‑окружении. Ниже описано, как отключить автоматический запуск этих скриптов, при этом сохранив работоспособность проекта там, где скрипты действительно нужны.

Почему скрипты могут быть опасны

Скрипты 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 или сгенерировать типы), полное отключение приведёт к ошибкам. В таких случаях рекомендуется следующая стратегия:

  1. Установить зависимости с флагом —ignore-scripts, чтобы убедиться, что никакой вредоносный код не выполнится.
  2. Проверить список скриптов, которые были бы выполнены. Это можно сделать, посмотрев поля scripts в package.json каждой зависимости (или используя команду npm ls —depth=0 —json и анализируя вывод).
  3. Для проверенных пакетов, которым действительно нужны скрипты, выполнить их вручную в контролируемой среде. Например:
    # после установки без скриптов
    npm run postinstall # если скрипт определён в корневом package.json
    # либо вызвать скрипт конкретной зависимости:
    npx some-package postinstall
  4. Если скрипт нужен только на этапе разработки, можно добавить его в отдельный 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

Как вернуть выполнение нужных скриптов после проверки

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

  1. Создайте список «белого» набора пакетов, которым разрешен запуск скриптов (например, на основе внутреннего реестра или проверенных издателей).
  2. Установите зависимости обычным способом (npm install без флага) и сразу после установки выполните только нужные скрипты вручную:
    # пример для одного пакета
    npm run postinstall —if-present # выполнит скрипт только если он есть
  3. В 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, чтобы вся команда следовала одной практике.

Эта статья носит информационный характер. Она не заменяет профессиональную оценку безопасности зависимостей. Если ваш проект обрабатывает критически важные данные или работает в регулируемой среде, перед принятием решений о запуске или отключении скриптов рекомендуется провести дополнительный аудит с участием специалиста по информационной безопасности.

PEFile.ru