Mensajes de error

Git: «Could not resolve host: github.com» en el Mac

Git no pudo obtener una dirección para github.com. Con remotos HTTPS, Git muestra el mensaje de curl. Con remotos SSH, ssh muestra su propio mensaje.

Se aplica a: Git instalado por macOS o Homebrew, en todas las versiones actuales de macOS. El texto se comprobó con Git 2.56 y OpenSSH 10.5.Revisado: 29 de octubre de 2026

Síntomas

  • Git muestra fatal: unable to access 'https://github.com/…/': Could not resolve host: github.com.
  • Con un remoto SSH, ssh muestra Could not resolve hostname github.com: nodename nor servname provided, or not known.
  • git clone, git pull y git push fallan.

Causas probables

  • Sin conexión o sin DNS. El Mac no puede resolver ningún nombre.
  • Un proxy que Git no usa. En una red que necesita proxy, Git necesita http.proxy o variables de proxy.
  • Una VPN o un filtro DNS. El servidor DNS de una VPN o un filtro pueden no responder para github.com.
  • Una URL remota incorrecta. Una errata en el remoto da un nombre que no existe.

Cómo comprobarlo

  1. Muestra las URL remotas del repositorio.

    git remote -v
  2. Consulta github.com con el resolvedor de macOS.

    dscacheutil -q host -a name github.com
  3. Muestra el ajuste de proxy de Git y tus variables de proxy.

    git config --get http.proxy
    env | grep -i proxy
  4. Prueba la ruta HTTPS con curl.

    curl -I https://github.com

Cómo solucionarlo

  1. Si la resolución falla con todos los nombres, arregla el DNS. Consulta El DNS no resuelve en el Mac.

  2. Si la red necesita un proxy, configúralo para Git.

    git config --global http.proxy http://proxy.example.com:8080
  3. Si un ajuste de proxy antiguo es incorrecto, elimínalo.

    git config --global --unset http.proxy
  4. Corrige la URL remota si tiene una errata.

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

Con Kilobat

  1. El diagnóstico de conexión de Kilobat prueba el host capa por capa: red, proxy, DNS, reglas, IPv4, IPv6, TLS y el servidor. Indica la capa que falló.

    kilobat why github.com
  2. Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con diagnose_connection y diagnose_network. Consulta Averiguar por qué no conecta un sitio o una API.

Preguntas

¿Está caído GitHub?

Puede ser, pero un error de resolución suele ser local. Si dscacheutil encuentra otros nombres pero no github.com, revisa tu DNS o tu filtro.

Fuentes

  • curl: libcurl error codes
  • git-config(1), http.proxy, página man instalada con macOS 27.2 (Git 2.56)
  • ssh(1) y dscacheutil(1), página man instalada con macOS 27.2

Fuentes revisadas el 29 de octubre de 2026. Las páginas man son las que se instalan con macOS; abre una con man <name> en Terminal.