Сообщения об ошибках

«npm error code ECONNRESET» на Mac

ECONNRESET означает, что другая сторона принудительно закрыла подключение. В документации Node.js это называется «Connection reset by peer».

Применимо к: npm 10 и новее выводит «npm error», более старые версии — «npm ERR!». Все актуальные версии macOS.Проверено: 29 октября 2026 г.

Симптомы

  • npm install завершается с npm error code ECONNRESET.
  • npm добавляет, что проблема связана с сетевым подключением.
  • Это происходит в корпоративной сети, с VPN или с защитным приложением.

Вероятные причины

  • Прокси или фильтр, сбрасывающий подключения. Корпоративный прокси или защитное ПО может закрывать подключения, которые не разрешает.
  • Инспекция TLS. Прокси, который проверяет защищённый трафик, может ломать подключение. См. Сертификаты корпоративного прокси ломают инструменты Терминала на Mac.
  • VPN переподключается. Подключения через VPN закрываются, когда он переподключается.
  • Нестабильное подключение. В документации Node.js сказано, что причиной может быть тайм-аут или перезагрузка на удалённой стороне.

Как проверить

  1. Покажите настройки реестра и прокси npm.

    npm config get registry
npm config get proxy
npm config get https-proxy

  2. Запросите ответ у реестра.

    npm ping

  3. Проверьте реестр с помощью curl. Обратите внимание на издателя сертификата.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer

  4. Попробуйте установку в другой сети, например через точку доступа телефона.

Как исправить

  1. Если в сети нужен прокси, задайте его для npm.

    npm config set https-proxy http://proxy.example.com:8080

  2. Если корпоративный прокси проверяет TLS, добавьте его корневой сертификат для Node.js. См. Сертификаты корпоративного прокси ломают инструменты Терминала на Mac.

  3. Дайте npm больше повторных попыток.

    npm config set fetch-retries 5

  4. Если включены VPN, прокси или защитное приложение, ненадолго выключите их для проверки. После проверки включите снова.

С Kilobat

  1. Диагностика подключения в Kilobat проверяет реестр уровень за уровнем: сеть, прокси, DNS, правила, IPv4, IPv6, TLS и сервер — и называет уровень, на котором произошёл сбой.

    kilobat why https://registry.npmjs.org/

  2. Эти проверки Kilobat бесплатны. ИИ-агенты запускают их через MCP с помощью diagnose_connection и diagnose_network. См. Почему не подключается один сайт или API.

Вопросы

ECONNRESET — это ошибка в моём проекте?

Обычно нет. Закрылось подключение к реестру. Для сравнения запустите ту же установку в другой сети.

Источники

Источники проверены 29 октября 2026 г. Man-страницы — те, что установлены вместе с macOS; откройте любую командой man <name> в Терминале.