Mensajes de error

«npm error code ETIMEDOUT» en el Mac

Q: ¿Cuánto espera npm?

La documentación de npm indica un fetch-timeout predeterminado de 300000 ms, cinco minutos, y 2 fetch-retries.

ETIMEDOUT significa que el otro extremo no respondió a tiempo. La documentación de Node.js dice: «the connected party did not properly respond after a period of time» (la otra parte no respondió correctamente tras un tiempo).

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 ETIMEDOUT.
npm añade que es un problema relacionado con la conectividad de red.
Falla en una red concreta, como una red de empresa o un punto de acceso.

Causas probables

Un proxy que npm no conoce. En una red que necesita un proxy, npm necesita sus ajustes proxy y https-proxy.
Un registro al que no puedes llegar. Un ajuste registry antiguo puede apuntar a un servidor privado.
Una conexión lenta o con pérdidas. Los paquetes grandes agotan el tiempo de espera en un Wi-Fi débil o en un punto de acceso.
Una ruta IPv6 rota. El registro tiene una dirección IPv6 y el IPv6 no funciona en tu red.

Cómo comprobarlo

Muestra los ajustes de registro y de proxy de npm.

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

Pide una respuesta al registro.
```
npm ping
```
Prueba el registro con curl, solo por IPv4.
```
curl -4 -I https://registry.npmjs.org/
```
Mide la conexión.
```
networkQuality
```

Cómo solucionarlo

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

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

Elimina un ajuste de registro antiguo para que npm use el predeterminado.
```
npm config delete registry
```
Dale a npm más reintentos en una conexión lenta.
```
npm config set fetch-retries 5
```
Vuelve a ejecutar la instalación en una red más rápida, si puedes.

Con Kilobat

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/
```
Antes de una instalación grande, comprueba si la red tiene límite, si pasa por una VPN o si va lenta.
```
kilobat conditions
```
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.

Preguntas

¿Cuánto espera npm?

La documentación de npm indica un fetch-timeout predeterminado de 300000 ms, cinco minutos, y 2 fetch-retries.

Fuentes

Documentación de Node.js: Common system errors
npm Docs: config
curl(1) y networkQuality(8), 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.