В современном JavaScript-проекте собственный код обычно составляет лишь малую часть. Остальное — сотни, а иногда тысячи пакетов в папке node_modules, и каждый из них написан кем-то другим. Атака на цепочку поставок (supply chain) использует именно это доверие: злоумышленник взламывает не ваш сайт, а пакет, которым вы пользуетесь, и вредоносный код сам приходит к вам со следующим npm install. В этой статье разберём, как выглядят такие атаки и как защитить проект.
На какое звено цепочки нацелена атака
Первый способ — захват существующего популярного пакета. Злоумышленник получает доступ к npm-аккаунту автора через фишинг или утёкший пароль и публикует новую, вредоносную версию. Через зависимости, записанные диапазоном (например, ^4.1.0), она автоматически попадает в тысячи проектов. Наглядный пример — случай 2025 года, когда автор очень распространённых пакетов chalk и debug попался на фишинговое письмо и через его аккаунт были выпущены вредоносные версии. Похожие истории случались и раньше, например с event-stream и ua-parser-js.
Второй способ — тайпсквоттинг: публикация поддельного пакета с именем, очень похожим на популярное. Если разработчик в спешке ошибётся на одну букву, вместо настоящей библиотеки он установит пакет злоумышленника. Третий — путаница зависимостей (dependency confusion): если в публичном реестре появляется пакет с именем внутреннего пакета компании, неправильно настроенный проект может подтянуть публичную версию вместо внутренней.
Когда запускается вредоносный код
Многие думают, что вредоносный пакет опасен только при запуске приложения, но самый опасный момент — сама установка. Пакеты npm могут объявлять в package.json скрипты preinstall, install и postinstall, которые автоматически выполняются во время npm install на компьютере разработчика или CI-сервере. В этот момент скрипт может украсть переменные окружения, токены из .npmrc, SSH-ключи и ключи облачных сервисов.
Другой тип вредоносного кода прячется в самом приложении, особенно во фронтенд-коде, который отправляется в браузер. Например, скрипт, подменяющий адреса криптокошельков или отправляющий данные платёжной формы на внешний сервер. Такой код после сборки выполняется в браузере каждого посетителя, и найти его по серверным логам сложно.
Lock-файл и npm ci: первая линия защиты
Самый простой и эффективный шаг — хранить package-lock.json в репозитории и на сервере и в CI использовать npm ci вместо npm install. npm install может выбрать самую новую версию в пределах диапазона и обновить lock-файл, а npm ci ставит ровно те версии, что записаны в lock-файле, и выдаёт ошибку, если он не совпадает с package.json. Тогда вредоносная версия, вышедшая сегодня, не попадёт к вам, пока вы сознательно не обновитесь.
# точная установка по lock-файлу (для CI и сервера)
npm ci
# установка без install-скриптов
npm ci --ignore-scripts
# постоянная настройка проекта (.npmrc)
echo "ignore-scripts=true" >> .npmrc
# проверка известных уязвимостей и подписей пакетов
npm audit
npm audit signatures
С включённым ignore-scripts некоторые пакеты, например собирающие нативные модули, могут работать некорректно. В этом случае безопаснее не включать скрипты целиком, а вручную выполнить npm rebuild имя-пакета для нужного пакета.
Что проверить перед добавлением нового пакета
Каждая новая зависимость приносит в проект чужой код, поэтому перед её добавлением стоит потратить несколько минут на проверку. Копируйте имя пакета из официальной документации или репозитория, а при ручном вводе следите за опечатками. Посмотрите, когда пакет опубликован, сколько у него версий и кто его поддерживает.
# сведения о пакете: авторы, версии, даты
npm view имя-пакета
npm view имя-пакета time --json
# какие скрипты запускает пакет
npm view имя-пакета scripts
# полное дерево зависимостей проекта
npm ls --all | less
Часто безопаснее написать несколько строк своего кода, чем ради мелкой задачи тянуть пакет с большим деревом зависимостей. Полезная привычка — не ставить только что вышедшую версию сразу: вредоносные версии обычно обнаруживают и удаляют из реестра в течение нескольких часов или дней. В некоторых пакетных менеджерах есть настройка, позволяющая выждать определённый срок перед установкой новых версий, — проверьте эту возможность в документации своего инструмента.
Реальный сценарий: случайное обновление на CI
Панель для клиентов службы доставки из Ташкента написана на React, и каждое изменение автоматически собиралось через CI и выкладывалось на сервер. В скрипте CI стоял npm install, а не npm ci, и lock-файл не был добавлен в репозиторий. В итоге однажды одна из транзитивных зависимостей перешла на новую версию пакета со взломанным аккаунтом автора, и её postinstall-скрипт отправил переменные окружения CI на внешний адрес. Среди них были SSH-ключ сервера и токен SMS-сервиса.
После инцидента команда сменила все ключи, добавила lock-файл в репозиторий, перешла на npm ci --ignore-scripts в CI и перенастроила секреты так, чтобы они выдавались только нужному этапу. Главное — ключ деплоя ограничили правом записи в одну папку на одном сервере, чтобы ущерб от следующей утечки был гораздо меньше.
Если вы автор пакета
Если вы сами публикуете пакеты в npm, вы тоже звено цепочки. Включите в аккаунте двухфакторную аутентификацию не только для входа, но и для публикации: тогда даже при утечке пароля новую версию выпустить не получится. Создавайте токены с минимальными правами и никогда не записывайте их в репозиторий или открытые логи.
npm profile enable-2fa auth-and-writes
npm token list
Полностью устранить риск цепочки поставок невозможно, но lock-файл, npm ci, контроль install-скриптов и ограничение секретов заметно его снижают. Эти правила работают одинаково, где бы ни размещалось приложение — на VPS от sayt.uz или в любом другом месте.