---
title: "Código de erro npm ETIMEDOUT no Mac: corrigir tempos limite de rede do npm · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/npm-etimedout"
description: "O npm install no Mac para com o código de erro npm ETIMEDOUT. Verifique o registro, o proxy e a conexão e altere os ajustes do npm."
---

Mensagens de erro

# “npm error code ETIMEDOUT” no Mac

ETIMEDOUT significa que o outro lado não respondeu a tempo. A documentação do Node.js diz que a parte conectada não respondeu adequadamente após um período.

Aplica-se ao npm 10 e posteriores, que mostram “npm error”. Versões anteriores mostram “npm ERR!”. Todas as versões atuais do macOS. · Verificado: 29 de outubro de 2026

## Sintomas

- `npm install` para com `npm error code ETIMEDOUT`.
- O npm acrescenta que isso é um problema relacionado à conectividade de rede.
- Falha em uma rede específica, como uma rede corporativa ou um acesso pessoal.

## Possíveis causas

- **Um proxy que o npm não conhece.** Em uma rede que exige proxy, o npm precisa dos ajustes `proxy` e `https-proxy`.
- **Um registro inacessível.** Um ajuste `registry` antigo pode apontar para um servidor privado.
- **Uma conexão lenta ou com perdas.** Pacotes grandes atingem o tempo limite em Wi-Fi fraco ou acesso pessoal.
- **Um caminho IPv6 com problema.** O registro tem um endereço IPv6 e o IPv6 não funciona na sua rede.

## Como verificar

1. Mostre os ajustes de registro e proxy do npm.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
2. Peça uma resposta ao registro.

   ```
   npm ping
   ```
3. Teste o registro com curl, usando apenas IPv4.

   ```
   curl -4 -I https://registry.npmjs.org/
   ```
4. Meça a conexão.

   ```
   networkQuality
   ```

## Como corrigir

1. Se a rede precisar de proxy, configure-o para o npm.

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

   ```
   npm config delete registry
   ```
3. Configure mais tentativas para o npm em uma conexão lenta.

   ```
   npm config set fetch-retries 5
   ```
4. Execute a instalação novamente em uma rede mais rápida, se puder.

## Com o Kilobat

1. O diagnóstico de conexão do Kilobat testa o registro camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e servidor. Ele identifica a camada que falhou.

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Verifique se a rede tem limite de dados, usa uma VPN ou é lenta antes de uma instalação grande.

   ```
   kilobat conditions
   ```
3. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com `diagnose_connection` e `diagnose_network`. Consulte [Descubra por que um site ou API não conecta](https://kilobat.app/pt/guides/recipes/why-cant-it-connect).

## Perguntas

**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`.

**Um ajuste de proxy pode afetar downloads do npm?**

Sim. O npm tem configuração de proxy, e um proxy inacessível ou incorreto pode impedir a conexão com um registro.

## Fontes

- [Documentação do Node.js: erros de sistema comuns](https://nodejs.org/api/errors.html#common-system-errors)
- [Documentação do npm: config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1) e networkQuality(8), páginas de manual instaladas com o macOS 27.2

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [“npm error code ECONNRESET” no Mac](https://kilobat.app/pt/guides/npm-econnreset): ECONNRESET informa uma conexão encerrada à força.
- [Downloads do Homebrew ou npm falham no Mac](https://kilobat.app/pt/guides/homebrew-npm-download-fails): O Homebrew baixa arquivos com curl e Git.
- [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.
- [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.
- [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.