---
title: "brew install o npm install fallan con errores de red en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/homebrew-npm-download-fails.html"
description: "Descubre por qué brew install o npm install se detienen con tiempos de espera agotados o errores de proxy o de certificado, y configura el proxy, la réplica o el certificado que necesita tu red."
---

Desarrolladores

# Las descargas de Homebrew o npm fallan en un Mac

Homebrew descarga con curl y Git. npm descarga desde su registro. Cada herramienta lee sus propios ajustes de proxy y de certificados.

Se aplica a: Homebrew y npm actuales en todas las versiones actuales de macOS. · Revisado: 29 de octubre de 2026

## 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](https://kilobat.app/es/guides/corporate-proxy-certificates.html).
- **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](https://kilobat.app/es/guides/corporate-proxy-certificates.html).

## Con Kilobat

1. Antes de una instalación grande, comprueba si la red tiene límite de datos, va por VPN o es lenta.

   ```
   kilobat conditions
   ```
2. Encuentra la capa que bloquea el servidor de descargas. Añade `--app` para usar las variables de proxy de ese proceso.

   ```
   kilobat why https://ghcr.io/v2/homebrew/core --app process:curl
   ```
3. Mantén el Mac activo mientras se ejecuta la instalación.

   ```
   kilobat awake -- brew upgrade
   ```
4. Estos comandos son gratuitos. Consulta [Comprobar la red antes de una descarga grande en un agente](https://kilobat.app/es/guides/recipes/check-network-before-download.html).

## Preguntas

**¿Homebrew usa el proxy de Ajustes del Sistema?**

La documentación de Homebrew lista variables de proxy para curl, Git y Subversion. Define `https_proxy` en tu shell.

**¿Cuánto espera npm?**

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

## Fuentes

- [Homebrew Docs: Manpage, variables de entorno](https://docs.brew.sh/Manpage)
- [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

- [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.
- [Comprobar la red antes de una descarga grande en un agente](https://kilobat.app/es/guides/recipes/check-network-before-download.html): Un agente puede preguntar a Kilobat si ahora es buen momento para una transferencia grande.
- [SSH y Git agotan el tiempo de espera en un Mac](https://kilobat.app/es/guides/ssh-git-timeouts.html): SSH y Git necesitan una conexión TCP con el servidor que funcione.
- [«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.