---
title: "Mac의 Homebrew curl: (28) 시간 초과와 다운로드 실패 해결 · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/homebrew-curl-28-timed-out"
description: "Mac에서 brew install 또는 brew update가 curl: (28) 오류로 중단되나요? 다운로드 시간이 초과된 이유를 찾고 재시도, 프록시 또는 미러를 설정하세요."
---

오류 메시지

# 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에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참조하세요.

## 질문

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

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

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

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

## 출처

- [curl: libcurl 오류 코드](https://curl.se/libcurl/c/libcurl-errors.html)
- curl(1), 종료 코드, macOS 27.2와 함께 설치된 매뉴얼 페이지
- [Homebrew 문서: 매뉴얼 페이지, 환경 변수](https://docs.brew.sh/Manpage)
- brew(1), HOMEBREW_CURL_RETRIES, Homebrew와 함께 설치된 매뉴얼 페이지

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

## 관련 가이드

- [Mac에서 Homebrew 또는 npm 다운로드 실패](https://kilobat.app/ko/guides/homebrew-npm-download-fails): Homebrew는 curl과 Git으로 다운로드합니다.
- [Mac에서 “curl: (6) Could not resolve host”](https://kilobat.app/ko/guides/curl-could-not-resolve-host): curl 종료 코드 6은 curl이 호스트 이름의 주소를 가져오지 못했다는 뜻입니다.
- [에이전트의 대용량 다운로드 전에 네트워크 확인](https://kilobat.app/ko/guides/recipes/check-network-before-download): 에이전트는 지금이 대용량 전송에 적합한 시점인지 Kilobat에 물어볼 수 있습니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.