«npm error code ECONNREFUSED» на Mac

ECONNREFUSED сообщает об отклонённом подключении. В документации Node.js сказано: «No connection could be made because the target machine actively refused it.»

Решите это с помощью агентаКопирует промпт для Claude Code, Codex или любого агента, который умеет работать с Терминалом.

У моего Mac такая проблема: «npm error code ECONNREFUSED» на Mac. Прочитай https://kilobat.app/ru/guides/npm-econnrefused.md и разберись с ней вместе со мной. Если Kilobat CLI не установлен, установи его: brew install seifip/kilobat/kilobat. Проверки в Терминале и через kilobat из руководства выполни сам и расскажи, что нашёл. Составь список шагов, которые могу сделать только я. Перед изменением любой настройки спрашивай меня.

Относится к: npm 10 и новее выводит «npm error». Старые версии выводят «npm ERR!». Node.js во всех актуальных версиях macOS.Проверено: 29 октября 2026 г.

Симптомы

  • npm install или скрипт останавливается с npm error code ECONNREFUSED.
  • Следующая строка называет адрес и порт, например 127.0.0.1:8080.
  • Часто это следует за настройкой прокси или реестра.

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

  • Настройка прокси, который никуда не ведёт. Задан прокси на 127.0.0.1 или другом хосте, но там прокси не запущен.
  • Локальный реестр выключен. Локальное зеркало или кеш не работает.
  • Неактивная служба. В документации Node.js сказано, что обычно причина в службе, неактивной на удалённом хосте.
  • Скрипт обращается к локальному серверу. Шаг теста или сборки может обращаться к серверу, который не запущен.

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

  1. Прочитайте адрес и порт в ошибке.

  2. Покажите прокси и реестр npm.

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. Проверьте этот порт.

    nc -vz 127.0.0.1 8080
  4. Покажите переменные прокси.

    env | grep -i proxy

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

  1. Удалите ненужную настройку прокси.

    npm config delete proxy
    npm config delete https-proxy
  2. Запустите локальный реестр или сервер, который указан в адресе.

  3. Сбросьте неверные переменные прокси.

    unset https_proxy http_proxy
  4. Повторите установку.

Вопросы

ECONNREFUSED — то же, что ECONNRESET?

Нет. ECONNREFUSED — отказ в самом начале. ECONNRESET закрывает уже открытое соединение. Смотрите «npm error code ECONNRESET» на Mac.

Почему там указан 127.0.0.1?

npm пробовал локальный адрес, обычно из настройки прокси или реестра.

Источники

Проверено 29 октября 2026 года.