---
title: "brew install ou npm install falha com erros de rede no Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/homebrew-npm-download-fails"
description: "Descubra por que brew install ou npm install para com erros de tempo limite, proxy ou certificado e configure o proxy, espelho ou certificado que sua rede exige."
---

Desenvolvedores

# Downloads do Homebrew ou npm falham no Mac

O Homebrew faz downloads com curl e Git. O npm faz downloads do próprio registro. Cada ferramenta lê seus próprios ajustes de proxy e certificado.

Aplica-se a: versões atuais do Homebrew e npm em todas as versões atuais do macOS. · Verificado: 29 de outubro de 2026

## Sintomas

- `brew install` para com “curl: (28) … timed out” ou “Failed to download resource”.
- `npm install` para com ETIMEDOUT, ECONNRESET ou erro de certificado.
- Os downloads falham apenas em uma rede corporativa ou VPN.
- Os downloads começam e param em uma conexão lenta.

## Possíveis causas

- **Um proxy que a ferramenta não conhece.** O Homebrew usa `http_proxy`, `https_proxy` e `all_proxy`. O npm usa seus ajustes `proxy` e `https-proxy` ou as mesmas variáveis.
- **Inspeção TLS.** Um proxy corporativo assina o tráfego com seu próprio certificado. Consulte [Certificados de proxy corporativo impedem o funcionamento de ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates).
- **Registro npm incorreto.** Um ajuste antigo de `registry` pode apontar para um servidor inacessível.
- **Conexão lenta ou com limite de dados.** Downloads grandes podem exceder o tempo limite em um Wi-Fi fraco ou acesso pessoal.

## Como verificar

1. Deixe o Homebrew verificar seu sistema.

   ```
   brew doctor
   ```
2. Mostre a configuração do Homebrew e do sistema.

   ```
   brew config
   ```
3. Mostre os ajustes de registro e proxy do npm.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
4. Solicite uma resposta ao registro do npm.

   ```
   npm ping
   ```
5. Teste o host de download diretamente com curl.

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

## Como corrigir

1. Para usar o Homebrew atrás de um proxy, defina a variável de proxy no mesmo shell.

   ```
   export https_proxy=http://proxy.example.com:8080
   ```
2. Para usar o npm atrás de um proxy, configure o proxy do npm.

   ```
   npm config set https-proxy http://proxy.example.com:8080
   ```
3. Remova um ajuste antigo de registro do npm para que ele use o padrão.

   ```
   npm config delete registry
   ```
4. Permita que o Homebrew tente novamente mais vezes um download que falhou.

   ```
   export HOMEBREW_CURL_RETRIES=5
   ```
5. Se sua empresa usar um espelho, configure-o. O Homebrew usa `HOMEBREW_BOTTLE_DOMAIN` e `HOMEBREW_API_DOMAIN` para espelhos.
6. Para erros de certificado, adicione o certificado raiz da empresa. Consulte [Certificados de proxy corporativo impedem o funcionamento de ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates).

## Com o Kilobat

1. Antes de uma instalação grande, verifique se a rede tem limite de dados, usa VPN ou é lenta.

   ```
   kilobat conditions
   ```
2. Encontre a camada que impede o acesso ao host de download. Adicione `--app` para usar as variáveis de proxy desse processo.

   ```
   kilobat why https://ghcr.io/v2/homebrew/core --app process:curl
   ```
3. Mantenha o Mac ativo durante a instalação.

   ```
   kilobat awake -- brew upgrade
   ```
4. Esses comandos são gratuitos. Consulte [Verificar a rede antes de um download grande em um agente](https://kilobat.app/pt/guides/recipes/check-network-before-download).

## Perguntas

**O Homebrew usa o proxy dos Ajustes do Sistema?**

A documentação do Homebrew lista variáveis de proxy para curl, Git e Subversion. Defina `https_proxy` no shell.

**Quanto tempo o npm espera?**

A documentação do npm informa o padrão `fetch-timeout` de 300000 ms, cinco minutos, e 2 `fetch-retries`.

## Fontes

- [Documentação do Homebrew: página de manual, variáveis de ambiente](https://docs.brew.sh/Manpage)
- [Documentação do npm: config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1), página de manual instalada com o macOS 27.2

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [Certificados de proxy empresarial interferem em ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates): Algumas redes empresariais inspecionam o tráfego HTTPS.
- [Ajustes de proxy impedem apps de se conectar no Mac](https://kilobat.app/pt/guides/proxy-settings-breaking-apps): Um ajuste de proxy envia tráfego por outro servidor.
- [Verifique a rede antes de um grande download em um agente](https://kilobat.app/pt/guides/recipes/check-network-before-download): Um agente pode perguntar ao Kilobat se é um bom momento para uma grande transferência.
- [SSH e Git esgotam o tempo de espera no Mac](https://kilobat.app/pt/guides/ssh-git-timeouts): SSH e Git precisam de uma conexão TCP funcional com o servidor.
- [“npm error code ETIMEDOUT” no Mac](https://kilobat.app/pt/guides/npm-etimedout): ETIMEDOUT significa que o outro lado não respondeu a tempo.