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.
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
Mostre o comando exato. Confirme que o nome do host está correto.
Consulte o nome pelo resolvedor do macOS.
dscacheutil -q host -a name example.comPara 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.1Mostre as variáveis de proxy que o curl lê.
env | grep -i proxyExecute curl com detalhes. As primeiras linhas mostram a consulta.
curl -v https://example.com
Como corrigir
Se a consulta do macOS também falhar, corrija o DNS. Consulte DNS não resolve no Mac.
Se a rede precisar de proxy, configure-o para curl.
export https_proxy=http://proxy.example.com:8080Para um nome da empresa, conecte a VPN primeiro.
Limpe o cache DNS e tente novamente. Consulte Limpe o cache DNS no Mac.
Com o Kilobat
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.comPara usar as variáveis de proxy de um processo em execução, adicione
--appcom seu nome.kilobat why https://example.com --app process:curlEssas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_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.