오류 메시지

Mac에서 Homebrew가 “curl: (28)” 오류로 실패합니다

Homebrew는 curl로 다운로드합니다. curl 종료 코드 28은 시간 초과입니다. curl 문서에는 “지정된 시간 초과 기간에 도달했습니다”라고 설명되어 있습니다.

적용 대상: 현재 지원되는 모든 macOS 버전의 최신 Homebrew.확인일: 2026년 10월 29일

증상

  • brew install이 curl: (28)과 시간 초과 메시지를 표시하며 중단됩니다.
  • Homebrew에 리소스를 다운로드하지 못했다는 메시지가 표시됩니다.
  • 느린 네트워크, VPN 또는 회사 네트워크에서 다운로드가 실패합니다.

가능한 원인

  • 느리거나 손실이 있는 연결. Wi-Fi 신호가 약하거나 핫스팟을 사용하면 큰 bottle을 다운로드하는 중에 시간이 초과될 수 있습니다.
  • curl이 사용하지 않는 프록시. Homebrew는 http_proxy, https_proxy 및 all_proxy을 사용합니다.
  • 트래픽을 버리는 방화벽. 다운로드 호스트로의 연결을 버리는 네트워크에서는 시간 초과가 발생합니다.
  • IPv6 경로 문제. 다운로드 호스트에 IPv6 주소가 있지만 IPv6이 작동하지 않습니다.

확인 방법

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

    brew doctor

  2. curl로 IPv4만 사용하여 다운로드 호스트를 테스트합니다.

    curl -4 -I https://ghcr.io/v2/

  3. 프록시 변수를 표시합니다.

    env | grep -i proxy

  4. 연결을 측정합니다.

    networkQuality

해결 방법

  1. Homebrew가 더 많이 재시도하도록 합니다. 기본값은 3회입니다.

    export HOMEBREW_CURL_RETRIES=5

  2. 네트워크에 프록시가 필요하면 같은 셸에서 설정하세요.

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

  3. 회사에 미러가 있다면 HOMEBREW_BOTTLE_DOMAIN 및 HOMEBREW_API_DOMAIN을 설정하세요.

  4. 가능하면 더 빠른 네트워크에서 명령을 다시 실행하세요.

Kilobat 사용

  1. 네트워크가 데이터 요금제 연결인지, VPN을 사용하는지, 속도가 느린지 확인하세요.

    kilobat conditions

  2. Kilobat 연결 진단은 네트워크, 프록시, DNS, 규칙, IPv4, IPv6, TLS 및 서버 등 각 계층에서 호스트를 테스트합니다. 실패한 계층을 알려줍니다.

    kilobat why https://ghcr.io/v2/

  3. 설치가 실행되는 동안 Mac을 깨워 둡니다.

    kilobat awake -- brew upgrade

  4. 이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해 diagnose_connection 및 diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.

질문

curl 오류 28이란 무엇인가요?

CURLE_OPERATION_TIMEDOUT입니다. curl 매뉴얼 페이지에는 종료 코드 28이 작업 시간 초과로 나와 있습니다.

curl 오류 28은 다운로드 서버가 다운되었다는 증거인가요?

아니요. 작업 시간이 초과되었습니다. 느린 연결, 프록시 또는 방화벽도 시간 초과를 유발할 수 있습니다.

출처

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