---
title: "npm error code ECONNRESET en el Mac: por qué se restablecen las conexiones · Guías de Kilobat"
url: "https://kilobat.app/es/guides/npm-econnreset.html"
description: "npm install se detiene en tu Mac con npm error code ECONNRESET. Encuentra el proxy, la VPN, el filtro o la red que restablece la conexión, y soluciónalo."
---

Mensajes de error

# «npm error code ECONNRESET» en el Mac

ECONNRESET significa que el otro extremo cerró la conexión a la fuerza. La documentación de Node.js lo llama «Connection reset by peer» (el otro extremo restableció la conexión).

Se aplica a: npm 10 y posterior muestran «npm error». Las versiones anteriores muestran «npm ERR!». Todas las versiones actuales de macOS. · Revisado: 29 de octubre de 2026

## Síntomas

- `npm install` se detiene con `npm error code ECONNRESET`.
- npm añade que es un problema relacionado con la conectividad de red.
- Ocurre en una red de empresa, en una VPN o con una app de seguridad.

## Causas probables

- **Un proxy o filtro que restablece las conexiones.** Un proxy de empresa o un software de seguridad puede cerrar las conexiones que no permite.
- **Inspección TLS.** Un proxy que inspecciona el tráfico seguro puede romper la conexión. Consulta [Los certificados del proxy corporativo rompen las herramientas de Terminal en el Mac](https://kilobat.app/es/guides/corporate-proxy-certificates.html).
- **Una VPN que se reconecta.** Las conexiones que pasan por la VPN se cierran cuando se reconecta.
- **Una conexión inestable.** La documentación de Node.js dice que puede deberse a un tiempo de espera agotado o a un reinicio en el otro extremo.

## Cómo comprobarlo

1. Muestra los ajustes de registro y de proxy de npm.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
2. Pide una respuesta al registro.

   ```
   npm ping
   ```
3. Prueba el registro con curl. Busca el emisor del certificado.

   ```
   curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
   ```
4. Prueba la instalación en otra red, como el punto de acceso de un teléfono.

## Cómo solucionarlo

1. Si la red necesita un proxy, configúralo para npm.

   ```
   npm config set https-proxy http://proxy.example.com:8080
   ```
2. Si un proxy de empresa inspecciona TLS, añade su certificado raíz para Node.js. Consulta [Los certificados del proxy corporativo rompen las herramientas de Terminal en el Mac](https://kilobat.app/es/guides/corporate-proxy-certificates.html).
3. Dale a npm más reintentos.

   ```
   npm config set fetch-retries 5
   ```
4. Si hay una VPN, un proxy o una app de seguridad activados, desactívalos para una prueba breve. Vuelve a activarlos después de la prueba.

## Con Kilobat

1. El diagnóstico de conexión de Kilobat prueba el registro capa por capa: red, proxy, DNS, reglas, IPv4, IPv6, TLS y el servidor. Indica la capa que falló.

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con `diagnose_connection` y `diagnose_network`. Consulta [Averiguar por qué no conecta un sitio o una API](https://kilobat.app/es/guides/recipes/why-cant-it-connect.html).

## Preguntas

**¿ECONNRESET es un error de mi proyecto?**

Normalmente no. Se cerró la conexión con el registro. Ejecuta la misma instalación en otra red para comparar.

## Fuentes

- [Documentación de Node.js: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- intro(2), ECONNRESET, página man instalada con macOS 27.2
- [npm Docs: config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1), página man instalada con macOS 27.2

Fuentes revisadas el 29 de octubre de 2026. Las páginas man son las que se instalan con macOS; abre una con `man <name>` en Terminal.

## Guías relacionadas

- [«npm error code ETIMEDOUT» en el Mac](https://kilobat.app/es/guides/npm-etimedout.html): ETIMEDOUT significa que el otro extremo no respondió a tiempo.
- [Las descargas de Homebrew o npm fallan en un Mac](https://kilobat.app/es/guides/homebrew-npm-download-fails.html): Homebrew descarga con curl y Git.
- [Los certificados de un proxy corporativo rompen las herramientas de Terminal en un Mac](https://kilobat.app/es/guides/corporate-proxy-certificates.html): Algunas redes de empresa inspeccionan el tráfico HTTPS.
- [Los ajustes de proxy impiden que las apps se conecten en un Mac](https://kilobat.app/es/guides/proxy-settings-breaking-apps.html): Un ajuste de proxy envía el tráfico a través de otro servidor.