Mensagens de erro

“curl: (6) Could not resolve host” no Mac

O código de saída 6 do curl significa que ele não conseguiu obter um endereço para o nome do host. A documentação do curl diz que o host remoto informado não foi resolvido.

Aplica-se ao curl incluído no macOS e ao curl do Homebrew em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

  • O Terminal mostra curl: (6) Could not resolve host: example.com.
  • Scripts e instaladores que usam curl param com o código de saída 6.
  • O mesmo endereço abre em um navegador ou falha nele também.

Possíveis causas

  • Um erro de digitação ou host vazio. Uma variável em um script pode estar vazia, e o curl recebe um nome incorreto.
  • Sem conexão ou DNS. O Mac não consegue acessar um servidor DNS.
  • Uma VPN com DNS próprio. Nomes da empresa só são resolvidos enquanto a VPN está ativa.
  • Um proxy que o curl não usa. Em redes que só permitem proxy, o curl precisa dos ajustes do proxy. Ele então deixa o proxy resolver o nome.

Como verificar

  1. Mostre o comando exato. Confirme que o nome do host está correto.

  2. Consulte o nome pelo resolvedor do macOS.

    dscacheutil -q host -a name example.com
  3. Para um nome público, compare com um servidor DNS público. Não envie nomes privados a ele.

    dig +short example.com @1.1.1.1
  4. Mostre as variáveis de proxy que o curl lê.

    env | grep -i proxy
  5. Execute curl com detalhes. As primeiras linhas mostram a consulta.

    curl -v https://example.com

Como corrigir

  1. Se a consulta do macOS também falhar, corrija o DNS. Consulte DNS não resolve no Mac.

  2. Se a rede precisar de proxy, configure-o para curl.

    export https_proxy=http://proxy.example.com:8080
  3. Para um nome da empresa, conecte a VPN primeiro.

  4. Limpe o cache DNS e tente novamente. Consulte Limpe o cache DNS no Mac.

Com o Kilobat

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

    kilobat why example.com
  2. Para usar as variáveis de proxy de um processo em execução, adicione --app com seu nome.

    kilobat why https://example.com --app process:curl
  3. 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

Por que o navegador funciona, mas curl não?

O navegador pode usar o proxy do sistema ou seu próprio DNS. O curl lê variáveis de proxy como https_proxy. Consulte Ajustes de proxy impedem apps de se conectar no Mac.

O erro 6 do curl significa que o servidor recusou a conexão?

Não. O nome do host não foi resolvido. Uma conexão com esse host não pôde ser iniciada.

Fontes

  • curl: códigos de erro da libcurl
  • curl(1), EXIT CODES, página de manual instalada com o macOS 27.2
  • dscacheutil(1) e dig(1), páginas de manual instaladas com o macOS 27.2

Verificado em 29 de outubro de 2026.