npm 라이브러리 설치 시 ETIMEDOUT 오류 원인과 해결 (registry 문제)

msw를 사용하기 위해 다음과 같이 설치를 진행했다.

npm i msw --save-dev

 

보통 오래 걸려도 1~2분이면 설치가 완료되는데 10분 넘게 설치 중인 게 이상했다.

그래서 캐시 삭제 후 재설치했지만 똑같은 현상이 반복되었고 한참 기다린 끝에 나오는 건 다음과 같은 오류 메시지였다.

npm error code ETIMEDOUT 
npm error syscall connect 
npm error errno ETIMEDOUT 
npm error network request to https://registry.npmjs.org/msw failed, reason: connect ETIMEDOUT 104.16.6.34:443 
npm error network This is a problem related to network connectivity. 
npm error network In most cases you are behind a proxy or have bad network settings. 
npm error network 
npm error network If you are behind a proxy, please make sure that the 
npm error network 'proxy' config is set properly. See: 'npm help config' 
npm error A complete log of this run can be found in:

 

에러 메시지를 해석해 보면 이건 msw라이브러리의 문제보다는 npm registry 네트워크 연결이 타임아웃되어 발생하는 현상이라는 걸 확인할 수 있었다.

따라서 잘 연결되어 있는지 확인하기 위해 다음과 같은 명령어를 실행했다.

 

1. 네트워크가 npm registry에 닿는지 확인해 보기

curl -I https://registry.npmjs.org/msw

 

위의 명령어를 통해 다음과 같이 200 코드가 나왔으므로 네트워크가 npm registry에 정상적으로 닿고 있다는 걸 확인할 수 있었다.

HTTP/2 200 
date: Thu, 29 Jan 2026 07:28:44 GMT 
content-type: application/json 
server: cloudflare 
cf-ray: 9c5703b31f3ec6c3-ICN 
cf-cache-status: HIT 
accept-ranges: bytes 
access-control-allow-origin: * 
age: 64 
cache-control: public, max-age=300 
etag: "e9134face2a3bcbf37f3fe0b81dfc522" 
last-modified: Sat, 27 Dec 2025 19:27:53 GMT 
vary: accept-encoding, accept 
set-cookie: _cfuvid=d3frAGqbsq5XPC0EMx1qudC4t.z..z5.gCVbenFvzYI-1769671724034-0.0.1.1-604800000; path=/; domain=.npmjs.org; HttpOnly; Secure; SameSite=None

그래서 그다음 프록시 설정이 잘 되어있는지 확인해 보기로 했다.

2. npm 프록시 설정이 꼬여있는지 확인해 보기

npm config get proxy
npm config get https-proxy
npm config get registry

 

위 명령어 입력 시 다음과 같이 나왔다.

aseukeuseutoliui-MacBookAir:$ npm config get proxy 
null 
aseukeuseutoliui-MacBookAir:$ npm config get https-proxy null aseukeuseutoliui-MacBookAir: npm config get registry https://registry.npmmirror.com

 

registry가  https://registry.npmmirror.com  (중국미러)를 가리켜서 발행하는 타임아웃 현상이었다.

내가 잘못 설정한 게 있나 싶었는데 종종 있는 일이라고 한다.

따라서 registry를 공식 npm으로 되돌리기로 했다.

3. registry를 공식 npm으로 되돌리기

npm config set registry https://registry.npmjs.org/

4. 잘 변경됐는지 확인

npm config get registry

 

다음과 같이 공식 npm으로 출력되는 걸 보니 정상적으로 바뀐 걸 확인할 수 있었다.

aseukeuseutoliui-MacBookAir: npm config get registry https://registry.npmjs.org/

그래서 다시 내가 설치하고자 하는 라이브러리를 설치한 결과 아주 빠르게 설치되었다.

 

원인 요약
npm registry가 공식 npm이 아닌 npmmirror.com(중국 미러)를 가리키고 있었고,
해당 미러와의 네트워크 연결이 타임아웃되면서 설치가 지연되었다.

 

 

끝!