“curl: (7) Failed to connect” no Mac
O código de saída 7 do curl indica uma etapa que falhou. A documentação do curl diz: “Failed to connect() to host or proxy.”
Meu Mac está com este problema: “curl: (7) Failed to connect” no Mac. Leia https://kilobat.app/pt/guides/curl-7-failed-to-connect.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.
Sintomas
- O Terminal mostra
curl: (7) Failed to connect to host port 443. - O texto costuma acrescentar “Couldn't connect to server” ou “Connection refused”.
- Scripts e instaladores param com o código de saída 7.
Possíveis causas
- Nada escuta na porta. O serviço está fora do ar ou usa outra porta.
- Um firewall ou proxy. Um firewall pode recusar a conexão. O curl também falha quando há um proxy definido e inacessível.
- Um endereço incorreto. O host ou a porta no URL está errado. Uma variável em um script pode estar vazia.
- Uma rota IPv6 ou de VPN. O curl pode tentar um endereço que a rede não alcança.
Como verificar
Imprima o URL exato. Verifique o host e a porta.
Execute o curl com detalhes. As primeiras linhas mostram o endereço que falhou.
curl -v https://example.comTeste a porta.
nc -vz example.com 443Mostre as variáveis de proxy.
env | grep -i proxy
Como corrigir
Inicie o serviço se ele for seu. Use a porta que ele imprime.
Force IPv4 para testar uma falha de IPv6.
curl -4 -v https://example.comRemova um proxy incorreto.
unset https_proxy http_proxyDesative a VPN para um teste rápido. Ative de novo depois.
Com o Kilobat
O diagnóstico de conexão do Kilobat testa o endereço camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e o servidor. Ele aponta a camada que falhou.
kilobat why https://example.comEssas 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
O código de saída 7 significa que o host está fora do ar?
Nem sempre. O curl não conseguiu se conectar ao host ou ao proxy. Descubra qual com curl -v.
Qual é a diferença para o (6)?
O código de saída 6 significa que o nome do host não foi resolvido. O código 7 significa que a conexão falhou. Veja “curl: (6) Could not resolve host” no Mac.
Fontes
Verificado em 29 de outubro de 2026.