Mac에서 Homebrew 또는 npm 다운로드 실패

증상

• brew install이(가) “curl: (28) … timed out” 또는 “Failed to download resource” 오류와 함께 중지됩니다.
• npm install이 ETIMEDOUT, ECONNRESET 또는 인증서 오류를 표시하며 중단됩니다.
• 회사 네트워크 또는 VPN에서만 다운로드가 실패합니다.
• 느린 연결에서 다운로드가 시작된 후 중지됩니다.

가능한 원인

• 도구에 설정되지 않은 프록시. Homebrew는 http_proxy, https_proxy, all_proxy을 사용합니다. npm은 자체 proxy 및 https-proxy 설정이나 같은 변수를 사용합니다.
• TLS 검사. 회사 프록시가 자체 인증서로 트래픽에 서명합니다. 회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않는 경우를 참고하세요.
• 잘못된 npm 레지스트리. 오래된 registry 설정이 연결할 수 없는 서버를 가리킬 수 있습니다.
• 느리거나 데이터가 제한된 연결. Wi-Fi 신호가 약하거나 핫스팟을 사용할 때 대용량 다운로드가 시간 초과될 수 있습니다.

확인 방법

1. Homebrew로 시스템을 확인합니다.

   brew doctor

2. Homebrew 및 시스템 구성을 표시합니다.

   brew config

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

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

4. npm 레지스트리에 응답을 요청합니다.

   npm ping

5. curl로 다운로드 호스트를 직접 테스트하세요.

   curl -v -o /dev/null https://formulae.brew.sh/api/formula.json

해결 방법

1. 프록시 뒤에서 Homebrew를 사용하려면 같은 셸에서 프록시 변수를 설정하세요.

   export https_proxy=http://proxy.example.com:8080

2. 프록시 뒤의 npm에는 npm 프록시를 설정하세요.

   npm config set https-proxy http://proxy.example.com:8080

3. npm이 기본 레지스트리를 사용하도록 이전 npm 레지스트리 설정을 제거합니다.

   npm config delete registry

4. Homebrew가 실패한 다운로드를 더 많이 재시도하도록 합니다.

   export HOMEBREW_CURL_RETRIES=5

5. 회사에서 미러를 사용한다면 설정하세요. Homebrew는 미러에 HOMEBREW_BOTTLE_DOMAIN 및 HOMEBREW_API_DOMAIN을 사용합니다.

6. 인증서 오류가 발생하면 회사 루트 인증서를 추가하세요. 회사 프록시 인증서로 Mac의 터미널 도구가 작동하지 않는 경우를 참고하세요.

Kilobat 사용

질문

출처

• Homebrew 문서: 매뉴얼 페이지, 환경 변수
• npm 문서: config
• curl(1), macOS 27.2에 설치된 매뉴얼 페이지

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

관련 가이드