Mensagens de erro

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

O Git não conseguiu obter um endereço para github.com. Para remotos HTTPS, o Git mostra a mensagem do curl. Para remotos SSH, o ssh mostra sua própria mensagem.

Aplica-se a: Git instalado pelo macOS ou Homebrew em todas as versões atuais do macOS. O texto foi verificado com Git 2.56 e OpenSSH 10.5.Verificado: 29 de outubro de 2026

Sintomas

  • O Git mostra fatal: unable to access 'https://github.com/…/': Could not resolve host: github.com.
  • Com um remoto SSH, o ssh mostra Could not resolve hostname github.com: nodename nor servname provided, or not known.
  • git clone, git pull e git push falham.

Possíveis causas

  • Sem conexão ou DNS. O Mac não consegue consultar nenhum nome.
  • Um proxy que o Git não usa. Em uma rede que exige proxy, o Git precisa de http.proxy ou de variáveis de proxy.
  • Uma VPN ou filtro DNS. O servidor DNS de uma VPN ou um filtro pode não responder por github.com.
  • Uma URL remota incorreta. Um erro de digitação no remoto produz um nome que não existe.

Como verificar

  1. Mostre as URLs remotas do repositório.

    git remote -v
  2. Consulte github.com pelo resolvedor do macOS.

    dscacheutil -q host -a name github.com
  3. Mostre o ajuste de proxy do Git e suas variáveis de proxy.

    git config --get http.proxy
    env | grep -i proxy
  4. Teste o caminho HTTPS com curl.

    curl -I https://github.com

Como corrigir

  1. Se a consulta falhar para todos os nomes, corrija o DNS. Consulte DNS não resolve no Mac.

  2. Se a rede exigir um proxy, configure-o para o Git.

    git config --global http.proxy http://proxy.example.com:8080
  3. Se um ajuste antigo de proxy estiver incorreto, remova-o.

    git config --global --unset http.proxy
  4. Corrija a URL remota se houver um erro de digitação.

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

Com o Kilobat

  1. O diagnóstico de conexão do Kilobat testa o host camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e servidor. Ele indica a camada que falhou.

    kilobat why github.com
  2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com diagnose_connection e diagnose_network. Consulte Descubra por que um site ou API não conecta.

Perguntas

O GitHub está fora do ar?

Talvez, mas um erro de consulta geralmente é local. Se dscacheutil encontrar outros nomes, mas não github.com, verifique seu DNS ou filtro.

Esta mensagem significa que o Git se autenticou e foi rejeitado?

Não. A consulta do host falhou antes que o Git pudesse conectar e autenticar.

Fontes

  • curl: códigos de erro da libcurl
  • git-config(1), http.proxy, página de manual instalada com o macOS 27.2 (Git 2.56)
  • ssh(1) e dscacheutil(1), páginas de manual instaladas com o macOS 27.2

Verificado em 29 de outubro de 2026.