---
title: "Mac의 npm error code ECONNRESET: 연결이 재설정되는 이유 · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/npm-econnreset"
description: "Mac에서 npm install이 npm 오류 코드 ECONNRESET과 함께 중단됩니다. 연결을 재설정하는 프록시, VPN, 필터 또는 네트워크를 찾아 해결하세요."
---

오류 메시지

# Mac에서 “npm error code ECONNRESET”

ECONNRESET은 연결이 강제로 재설정되었음을 나타냅니다. 재설정한 주체는 알려주지 않습니다. Node.js 문서에서는 “Connection reset by peer”라고 부릅니다.

적용 대상: npm 10 이상은 “npm error”를 출력합니다. 이전 버전은 “npm ERR!”를 출력합니다. 현재 지원되는 모든 macOS 버전. · 확인일: 2026년 10월 29일

## 증상

- `npm install`이(가) `npm error code ECONNRESET` 메시지와 함께 중단됩니다.
- npm은 이 문제가 네트워크 연결과 관련되어 있다고 덧붙입니다.
- 회사 네트워크, VPN 또는 보안 앱을 사용할 때 발생합니다.

## 가능한 원인

- **연결을 재설정하는 프록시 또는 필터.** 회사 프록시나 보안 소프트웨어가 허용하지 않는 연결을 닫을 수 있습니다.
- **TLS 검사.** 보안 트래픽을 검사하는 프록시가 연결을 방해할 수 있습니다. [회사 프록시 인증서로 Mac의 터미널 도구가 작동하지 않는 경우](https://kilobat.app/ko/guides/corporate-proxy-certificates)를 참고하세요.
- **다시 연결되는 VPN.** VPN이 다시 연결되면 VPN을 통한 연결이 끊어집니다.
- **불안정한 연결.** Node.js 문서에 따르면 원격 측의 시간 초과 또는 재부팅이 원인일 수 있습니다.

## 확인 방법

1. npm의 레지스트리 및 프록시 설정을 표시합니다.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
2. 레지스트리에 응답을 요청하세요.

   ```
   npm ping
   ```
3. curl로 레지스트리를 테스트합니다. 인증서 발급자를 확인하세요.

   ```
   curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
   ```
4. 휴대전화 핫스팟 같은 다른 네트워크에서 설치를 시도하세요.

## 해결 방법

1. 네트워크에 프록시가 필요하면 npm에 설정하세요.

   ```
   npm config set https-proxy http://proxy.example.com:8080
   ```
2. 회사 프록시가 TLS를 검사한다면 Node.js용 루트 인증서를 추가하세요. [회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않는 경우](https://kilobat.app/ko/guides/corporate-proxy-certificates)를 참고하세요.
3. npm의 재시도 횟수를 늘립니다.

   ```
   npm config set fetch-retries 5
   ```
4. VPN, 프록시 또는 보안 앱이 켜져 있으면 잠시 꺼서 테스트하세요. 테스트 후 다시 켭니다.

## Kilobat 사용

1. Kilobat 연결 진단은 네트워크, 프록시, DNS, 규칙, IPv4, IPv6, TLS 및 서버 순으로 레지스트리를 테스트합니다. 실패한 계층을 알려줍니다.

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. 이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해 `diagnose_connection` 및 `diagnose_network`(으)로 실행합니다. [특정 사이트나 API에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참조하세요.

## 질문

**ECONNRESET은 프로젝트의 버그인가요?**

보통은 아닙니다. 레지스트리 연결이 종료된 것입니다. 다른 네트워크에서 같은 설치를 실행하여 비교하세요.

**ECONNRESET은 시간 초과와 같은가요?**

아니요. ECONNRESET은 연결 재설정을 보고합니다. 시간 초과는 작업이 제시간에 끝나지 않았음을 나타냅니다.

## 출처

- [Node.js 문서: 일반적인 시스템 오류](https://nodejs.org/api/errors.html#common-system-errors)
- intro(2), ECONNRESET, macOS 27.2와 함께 설치된 매뉴얼 페이지
- [npm 문서: config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1), macOS 27.2에 설치된 매뉴얼 페이지

2026년 10월 29일 확인했습니다.

## 관련 가이드

- [Mac에서 “npm error code ETIMEDOUT” 발생](https://kilobat.app/ko/guides/npm-etimedout): ETIMEDOUT은 상대방이 제때 응답하지 않았음을 의미합니다.
- [Mac에서 Homebrew 또는 npm 다운로드 실패](https://kilobat.app/ko/guides/homebrew-npm-download-fails): Homebrew는 curl과 Git으로 다운로드합니다.
- [회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않음](https://kilobat.app/ko/guides/corporate-proxy-certificates): 일부 회사 네트워크는 HTTPS 트래픽을 검사합니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.