“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.

Resolva com seu agenteCopia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

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.

Vale para: macOS 13 Ventura e posteriores. O texto foi verificado no CFNetwork do macOS 27.2.Verificado: 29 de outubro de 2026

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

  1. Teste a porta com um limite de 5 segundos.

    nc -vz -G 5 example.com 443
  2. Solicite a página e mostre cada etapa da conexão.

    curl -v -o /dev/null https://example.com
  3. Para um endereço local, veja o que escuta na porta.

    lsof -nP -iTCP:3000 -sTCP:LISTEN

Como corrigir

  1. Abra o mesmo endereço em outro dispositivo. Se falhar lá também, a causa é o servidor ou a rede.

  2. Inicie o servidor local e use a porta que ele imprime.

  3. Desative uma VPN, um proxy ou um filtro como teste e depois ative de novo.

  4. Verifique no app se o URL tem o host e a porta certos.

  5. Tente de novo mais tarde. Um servidor ocupado pode se recuperar.

Com o Kilobat

  1. Verifique Wi-Fi, roteador, internet, DNS e páginas de login em uma etapa.

    kilobat diagnose
  2. Se um site ou serviço falhar, encontre a camada que o impede.

    kilobat why example.com
  3. A 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.