---
title: "Mac에서 Git Could not resolve host: github.com 해결 · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/git-could-not-resolve-host-github"
description: "Mac에서 git clone 또는 git push 실행 시 Could not resolve host: github.com 오류가 발생하나요? DNS, 프록시 및 원격 URL을 확인하고 이름 조회 문제를 해결하세요."
---

오류 메시지

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

## 질문

**GitHub가 중단되었나요?**

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

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

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

## 출처

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

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

## 관련 가이드

- [Mac에서 “curl: (6) Could not resolve host”](https://kilobat.app/ko/guides/curl-could-not-resolve-host): curl 종료 코드 6은 curl이 호스트 이름의 주소를 가져오지 못했다는 뜻입니다.
- [Mac에서 ssh: connect to host port 22: Operation timed out](https://kilobat.app/ko/guides/ssh-port-22-operation-timed-out): ssh가 포트 22에 연결을 요청했지만 응답을 받지 못했습니다.
- [Mac에서 SSH와 Git 연결 시간 초과](https://kilobat.app/ko/guides/ssh-git-timeouts): SSH와 Git에는 서버에 정상적으로 연결되는 TCP 연결이 필요합니다.
- [Mac에서 DNS 이름이 확인되지 않는 경우](https://kilobat.app/ko/guides/dns-server-not-found): DNS가 실패하면 Mac이 apple.com 같은 이름을 IP 주소로 변환할 수 없습니다.
- [회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않음](https://kilobat.app/ko/guides/corporate-proxy-certificates): 일부 회사 네트워크는 HTTPS 트래픽을 검사합니다.