---
title: "«npm error code ECONNREFUSED» на Mac · Руководства Kilobat"
url: "https://kilobat.app/ru/guides/npm-econnrefused"
description: "npm install на вашем Mac останавливается с npm error code ECONNREFUSED. Хост отклонил подключение. Проверьте реестр, прокси и локальные службы."
---

# «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](https://kilobat.app/ru/guides/npm-econnreset).

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

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

## Источники

- [Документация Node.js: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [Документация npm: Common errors](https://docs.npmjs.com/common-errors)

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

## Похожие руководства

- [«npm error code ECONNRESET» на Mac](https://kilobat.app/ru/guides/npm-econnreset): ECONNRESET сообщает о принудительном сбросе соединения.
- [«npm error code ENOTFOUND» на Mac](https://kilobat.app/ru/guides/npm-enotfound): ENOTFOUND сообщает о неудачном поиске DNS.
- [ERR_CONNECTION_REFUSED в Chrome на Mac](https://kilobat.app/ru/guides/err-connection-refused): ERR_CONNECTION_REFUSED — сетевая ошибка Chrome.
- [Настройки прокси мешают приложениям подключаться на Mac](https://kilobat.app/ru/guides/proxy-settings-breaking-apps): Настройка прокси отправляет трафик через другой сервер.
