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.
  • 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.

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.

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

Verificado em 29 de outubro de 2026.