Las descargas de Homebrew o npm fallan en un Mac

Síntomas

• brew install se detiene con «curl: (28) … timed out» o «Failed to download resource».
• npm install se detiene con ETIMEDOUT, ECONNRESET o un error de certificado.
• Las descargas fallan solo en una red de empresa o con VPN.
• Las descargas empiezan y luego se detienen en una conexión lenta.

Causas probables

• Un proxy que la herramienta no conoce. Homebrew usa http_proxy, https_proxy y all_proxy. npm usa sus ajustes proxy y https-proxy o las mismas variables.
• Inspección TLS. Un proxy de empresa firma el tráfico con su propio certificado. Consulta Los certificados de un proxy corporativo rompen las herramientas de Terminal en el Mac.
• Un registro de npm incorrecto. Un ajuste registry antiguo puede apuntar a un servidor al que no puedes llegar.
• Una conexión lenta o con límite de datos. Las descargas grandes pueden agotar el tiempo con un Wi-Fi débil o un punto de acceso.

Cómo comprobarlo

1. Deja que Homebrew revise tu sistema.

   brew doctor

2. Muestra la configuración de Homebrew y del sistema.

   brew config

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

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

4. Pide una respuesta al registro de npm.

   npm ping

5. Prueba el servidor de descargas directamente con curl.

   curl -v -o /dev/null https://formulae.brew.sh/api/formula.json

Cómo solucionarlo

1. Para Homebrew detrás de un proxy, define la variable de proxy en la misma shell.

   export https_proxy=http://proxy.example.com:8080

2. Para npm detrás de un proxy, configura el proxy de npm.

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

3. Elimina un ajuste de registro de npm antiguo para que npm use el predeterminado.

   npm config delete registry

4. Deja que Homebrew reintente más veces una descarga fallida.

   export HOMEBREW_CURL_RETRIES=5

5. Si tu empresa usa una réplica, configúrala. Homebrew usa HOMEBREW_BOTTLE_DOMAIN y HOMEBREW_API_DOMAIN para las réplicas.

6. Para los errores de certificado, añade el certificado raíz de la empresa. Consulta Los certificados de un proxy corporativo rompen las herramientas de Terminal en el Mac.

Con Kilobat

Preguntas

Fuentes

• Homebrew Docs: Manpage, variables de entorno
• npm Docs: 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