---
title: "npm error code ECONNRESET sur Mac : pourquoi les connexions sont réinitialisées · Guides Kilobat"
url: "https://kilobat.app/fr/guides/npm-econnreset.html"
description: "npm install s’arrête sur votre Mac avec npm error code ECONNRESET. Trouvez le proxy, le VPN, le filtre ou le réseau qui réinitialise la connexion, et corrigez-le."
---

Messages d’erreur

# « npm error code ECONNRESET » sur Mac

ECONNRESET signifie que l’autre côté a fermé la connexion de force. La documentation de Node.js l’appelle « Connection reset by peer ».

S’applique à : npm 10 et versions ultérieures affichent « npm error ». Les versions plus anciennes affichent « npm ERR! ». Toutes les versions actuelles de macOS. · Vérifié le 29 octobre 2026

## Symptômes

- `npm install` s’arrête avec `npm error code ECONNRESET`.
- npm ajoute qu’il s’agit d’un problème lié à la connectivité réseau.
- Cela arrive sur un réseau d’entreprise, avec un VPN ou avec une app de sécurité.

## Causes probables

- **Un proxy ou un filtre qui réinitialise les connexions.** Un proxy d’entreprise ou un logiciel de sécurité peut fermer les connexions qu’il n’autorise pas.
- **L’inspection TLS.** Un proxy qui inspecte le trafic sécurisé peut casser la connexion. Voir [Les certificats d’un proxy d’entreprise cassent les outils de Terminal sur Mac](https://kilobat.app/fr/guides/corporate-proxy-certificates.html).
- **Un VPN qui se reconnecte.** Les connexions qui passent par le VPN se ferment quand il se reconnecte.
- **Une connexion instable.** Selon la documentation de Node.js, un délai dépassé ou un redémarrage côté distant peut en être la cause.

## Comment vérifier

1. Affichez les réglages de registre et de proxy de npm.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
2. Demandez une réponse au registre.

   ```
   npm ping
   ```
3. Testez le registre avec curl. Cherchez l’émetteur du certificat.

   ```
   curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
   ```
4. Essayez l’installation sur un autre réseau, par exemple le partage de connexion d’un téléphone.

## Comment corriger

1. Si le réseau nécessite un proxy, configurez-le pour npm.

   ```
   npm config set https-proxy http://proxy.example.com:8080
   ```
2. Si un proxy d’entreprise inspecte le TLS, ajoutez son certificat racine pour Node.js. Voir [Les certificats d’un proxy d’entreprise cassent les outils de Terminal sur Mac](https://kilobat.app/fr/guides/corporate-proxy-certificates.html).
3. Accordez plus de tentatives à npm.

   ```
   npm config set fetch-retries 5
   ```
4. Si un VPN, un proxy ou une app de sécurité est activé, désactivez-le pour un court test. Réactivez-le ensuite.

## Avec Kilobat

1. Le diagnostic de connexion de Kilobat teste le registre couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur. Il indique la couche qui a échoué.

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec `diagnose_connection` et `diagnose_network`. Consultez [Trouver pourquoi un site ou une API ne se connecte pas](https://kilobat.app/fr/guides/recipes/why-cant-it-connect.html).

## Questions

**ECONNRESET est-il un bug de mon projet ?**

En général, non. La connexion au registre s’est fermée. Lancez la même installation sur un autre réseau pour comparer.

## Sources

- [Documentation Node.js : Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- intro(2), ECONNRESET, page man installée avec macOS 27.2
- [Documentation npm : config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1), page man installée avec macOS 27.2

Sources vérifiées le 29 octobre 2026. Les pages man sont celles installées avec macOS ; ouvrez-en une avec `man <name>` dans Terminal.

## Guides associés

- [« npm error code ETIMEDOUT » sur Mac](https://kilobat.app/fr/guides/npm-etimedout.html): ETIMEDOUT signifie que l’autre côté n’a pas répondu à temps.
- [Les téléchargements Homebrew ou npm échouent sur un Mac](https://kilobat.app/fr/guides/homebrew-npm-download-fails.html): Homebrew télécharge avec curl et Git.
- [Les certificats de proxy d’entreprise bloquent les outils de Terminal sur un Mac](https://kilobat.app/fr/guides/corporate-proxy-certificates.html): Certains réseaux d’entreprise inspectent le trafic HTTPS.
- [Des réglages de proxy empêchent les apps de se connecter sur un Mac](https://kilobat.app/fr/guides/proxy-settings-breaking-apps.html): Un réglage de proxy fait passer le trafic par un autre serveur.