오류 메시지

Git: Mac에서 “Could not resolve host: github.com”

Git이 github.com의 주소를 가져오지 못했습니다. HTTPS 원격 저장소에서는 Git이 curl 메시지를 출력합니다. SSH 원격 저장소에서는 ssh가 자체 메시지를 출력합니다.

적용 대상: 현재 지원되는 모든 macOS 버전에서 macOS 또는 Homebrew가 설치한 Git. 텍스트는 Git 2.56 및 OpenSSH 10.5에서 확인했습니다.확인일: 2026년 10월 29일

증상

  • Git에 fatal: unable to access 'https://github.com/…/': Could not resolve host: github.com이 표시됩니다.
  • SSH 원격 저장소에서는 ssh가 Could not resolve hostname github.com: nodename nor servname provided, or not known를 표시합니다.
  • git clone, git pull, git push이(가) 모두 실패합니다.

가능한 원인

  • 연결 또는 DNS 없음. Mac에서 어떤 이름도 조회할 수 없습니다.
  • Git이 사용하지 않는 프록시. 프록시가 필요한 네트워크에서는 Git에 http.proxy 또는 프록시 변수가 필요합니다.
  • VPN 또는 DNS 필터. VPN의 DNS 서버나 필터가 github.com에 응답하지 못할 수 있습니다.
  • 잘못된 원격 URL. 원격 주소에 오타가 있으면 존재하지 않는 이름이 됩니다.

확인 방법

  1. 저장소의 원격 URL을 표시합니다.

    git remote -v

  2. macOS 리졸버를 통해 github.com을 조회합니다.

    dscacheutil -q host -a name github.com

  3. Git 프록시 설정과 프록시 변수를 표시합니다.

    git config --get http.proxy
env | grep -i proxy

  4. curl로 HTTPS 경로를 테스트하세요.

    curl -I https://github.com

해결 방법

  1. 모든 이름의 조회가 실패하면 DNS를 해결하세요. Mac에서 DNS가 확인되지 않는 경우를 참조하세요.

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

    git config --global http.proxy http://proxy.example.com:8080

  3. 오래된 프록시 설정이 잘못되었다면 제거하세요.

    git config --global --unset http.proxy

  4. 원격 URL에 오타가 있으면 수정하세요.

    git remote set-url origin https://github.com/OWNER/REPO.git

Kilobat 사용

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

    kilobat why github.com

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

질문

GitHub가 중단되었나요?

가능하지만 조회 오류는 대개 로컬 문제입니다. dscacheutil가 다른 이름은 찾지만 github.com은 찾지 못하면 DNS 또는 필터를 확인하세요.

이 메시지는 Git 인증 후 거부되었다는 뜻인가요?

아니요. Git이 연결하고 인증하기 전에 호스트 조회에 실패했습니다.

출처

  • curl: libcurl 오류 코드
  • git-config(1), http.proxy, macOS 27.2와 함께 설치된 매뉴얼 페이지 (Git 2.56)
  • ssh(1) 및 dscacheutil(1), macOS 27.2와 함께 설치된 매뉴얼 페이지

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