“Could not connect to the server” (NSURLErrorDomain -1004) no Mac
O app encontrou o endereço do servidor, mas a conexão não abriu. O servidor a recusou, ou algo no caminho a bloqueou.
Meu Mac está com este problema: “Could not connect to the server” (NSURLErrorDomain -1004) no Mac. Leia https://kilobat.app/pt/guides/nsurl-error-1004-could-not-connect-to-the-server.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
- Um app mostra “Could not connect to the server.” com o erro -1004.
- O Console ou um log mostra NSURLErrorDomain Code=-1004.
- O Safari mostra a mensagem parecida “can’t connect to the server”.
Possíveis causas
- O servidor está fora do ar ou não escuta. Nada aceita conexões nessa porta.
- Um servidor local não está em execução. Para
localhost, seu próprio servidor precisa estar rodando. Veja Porta já em uso no Mac. - Um firewall, filtro, VPN ou proxy. Algo bloqueia a porta ou o host.
- Um endereço ou uma porta incorreta. O app usa um URL antigo.
Como verificar
Teste a porta com um limite de 5 segundos.
nc -vz -G 5 example.com 443Solicite a página e mostre cada etapa da conexão.
curl -v -o /dev/null https://example.comPara um endereço local, veja o que escuta na porta.
lsof -nP -iTCP:3000 -sTCP:LISTEN
Como corrigir
Abra o mesmo endereço em outro dispositivo. Se falhar lá também, a causa é o servidor ou a rede.
Inicie o servidor local e use a porta que ele imprime.
Desative uma VPN, um proxy ou um filtro como teste e depois ative de novo.
Verifique no app se o URL tem o host e a porta certos.
Tente de novo mais tarde. Um servidor ocupado pode se recuperar.
Com o Kilobat
Verifique Wi-Fi, roteador, internet, DNS e páginas de login em uma etapa.
kilobat diagnoseSe um site ou serviço falhar, encontre a camada que o impede.
kilobat why example.comA CLI é gratuita. No app, as recomendações dessas verificações fazem parte do Kilobat Pro. Veja Descubra por que um site ou API não conecta.
Perguntas
Qual é a diferença entre -1004 e -1001?
-1004 é uma conexão recusada ou bloqueada. -1001 é um tempo esgotado. Veja “The request timed out.” no Mac.
Por que o localhost dá -1004?
Nada escuta na porta, ou o servidor escuta em outro endereço.
Fontes
- Texto de erro em CFNetwork.framework, macOS 27.2 (Localizable.loctable)
- curl(1) e nc(1), página de manual instalada com o macOS 27.2
Verificado em 29 de outubro de 2026.