“Could not connect to the server” (NSURLErrorDomain -1004) auf dem Mac

Die App hat die Adresse des Servers gefunden, aber die Verbindung wurde nicht geöffnet. Der Server hat sie abgelehnt, oder etwas auf dem Weg hat sie blockiert.

Mit deinem Agenten behebenKopiert einen Prompt für Claude Code, Codex oder jeden Agenten, der das Terminal nutzen kann.

Mein Mac hat dieses Problem: „Could not connect to the server“ (NSURLErrorDomain -1004) auf dem Mac. Lies https://kilobat.app/de/guides/nsurl-error-1004-could-not-connect-to-the-server.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.

Gilt für: macOS 13 Ventura und neuer. Der Text wurde in CFNetwork unter macOS 27.2 geprüft.Geprüft: 29. Oktober 2026

Symptome

  • Eine App zeigt „Could not connect to the server.“ mit dem Fehler -1004.
  • Die Konsole oder ein Log zeigt NSURLErrorDomain Code=-1004.
  • Safari zeigt die ähnliche Meldung „can’t connect to the server“.

Mögliche Ursachen

  • Der Server ist ausgefallen oder lauscht nicht. Nichts nimmt Verbindungen an diesem Port an.
  • Ein lokaler Server läuft nicht. Für localhost muss dein eigener Server laufen. Siehe Port auf dem Mac bereits belegt.
  • Eine Firewall, ein Filter, ein VPN oder ein Proxy. Etwas blockiert den Port oder den Host.
  • Eine falsche Adresse oder ein falscher Port. Die App nutzt eine alte URL.

So prüfst du es

  1. Teste den Port mit einem Timeout von 5 Sekunden.

    nc -vz -G 5 example.com 443
  2. Ruf die Seite ab und zeig jeden Schritt der Verbindung an.

    curl -v -o /dev/null https://example.com
  3. Sieh bei einer lokalen Adresse nach, was am Port lauscht.

    lsof -nP -iTCP:3000 -sTCP:LISTEN

So behebst du es

  1. Öffne dieselbe Adresse auf einem anderen Gerät. Wenn es dort auch scheitert, liegt die Ursache beim Server oder im Netzwerk.

  2. Starte den lokalen Server und nutze den Port, den er ausgibt.

  3. Schalte zum Test ein VPN, einen Proxy oder Filter aus und danach wieder ein.

  4. Prüfe die URL in der App auf den richtigen Host und Port.

  5. Versuche es später erneut. Ein ausgelasteter Server kann sich erholen.

Mit Kilobat

  1. Prüfe WLAN, Router, Internet, DNS und Anmeldeseiten in einem Schritt.

    kilobat diagnose
  2. Wenn eine einzelne Website oder ein Dienst scheitert, finde die Ebene, die ihn stoppt.

    kilobat why example.com
  3. Die CLI ist kostenlos. In der App gehören die Empfehlungen aus diesen Prüfungen zu Kilobat Pro. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.

Fragen

Wie unterscheidet sich -1004 von -1001?

-1004 ist eine abgelehnte oder blockierte Verbindung. -1001 ist ein Timeout. Siehe “The request timed out.” auf dem Mac.

Warum liefert localhost -1004?

Nichts lauscht am Port, oder der Server lauscht an einer anderen Adresse.

Quellen

  • Fehlertext in CFNetwork.framework, macOS 27.2 (Localizable.loctable)
  • curl(1) und nc(1), mit macOS 27.2 installierte Man-Page

Geprüft am 29. Oktober 2026.