---
title: "Código de erro npm ECONNRESET no Mac: por que conexões são interrompidas · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/npm-econnreset"
description: "O npm install no Mac para com o código de erro npm ECONNRESET. Identifique e corrija o proxy, a VPN, o filtro ou a rede que interrompe a conexão."
---

Mensagens de erro

# “npm error code ECONNRESET” no Mac

ECONNRESET informa uma conexão encerrada à força. Ele não identifica a origem do encerramento. A documentação do Node.js o chama de “Connection reset by peer”.

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 ECONNRESET`.
- O npm acrescenta que isso é um problema relacionado à conectividade de rede.
- Isso acontece em uma rede corporativa, VPN ou com um app de segurança.

## Possíveis causas

- **Um proxy ou filtro que interrompe conexões.** Um proxy corporativo ou software de segurança pode encerrar conexões que não permite.
- **Inspeção TLS.** Um proxy que inspeciona tráfego seguro pode interromper a conexão. Consulte [Certificados de proxy corporativo prejudicam ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates).
- **Uma VPN que se reconecta.** Conexões que passam pela VPN são encerradas quando ela se reconecta.
- **Uma conexão instável.** A documentação do Node.js informa que um tempo limite ou reinicialização no lado remoto pode causar isso.

## 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. Procure o emissor do certificado.

   ```
   curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
   ```
4. Tente a instalação em outra rede, como o acesso pessoal de um telefone.

## 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. Se um proxy corporativo inspecionar TLS, adicione seu certificado raiz para o Node.js. Consulte [Certificados de proxy corporativo prejudicam ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates).
3. Configure mais tentativas para o npm.

   ```
   npm config set fetch-retries 5
   ```
4. Se houver uma VPN, proxy ou app de segurança ativo, desative-o para um teste breve. Ative-o novamente após o teste.

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

**ECONNRESET é um erro do meu projeto?**

Geralmente não. A conexão ao registro foi encerrada. Execute a mesma instalação em outra rede para comparar.

**ECONNRESET é o mesmo que um tempo esgotado?**

Não. ECONNRESET indica que a conexão foi interrompida. Um tempo limite esgotado informa que uma operação não terminou a tempo.

## Fontes

- [Documentação do Node.js: erros de sistema comuns](https://nodejs.org/api/errors.html#common-system-errors)
- intro(2), ECONNRESET, página de manual instalada com o macOS 27.2
- [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

- [“npm error code ETIMEDOUT” no Mac](https://kilobat.app/pt/guides/npm-etimedout): ETIMEDOUT significa que o outro lado não respondeu a tempo.
- [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.
- [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.