“curl: (56) Failure when receiving data” auf dem Mac

Der curl-Exit-Code 56 meldet einen fehlgeschlagenen Schritt. Die curl-Dokumentation sagt: “Failure with receiving network data.”

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

Mein Mac hat dieses Problem: „curl: (56) Failure when receiving data“ auf dem Mac. Lies https://kilobat.app/de/guides/curl-56-failure-receiving-data.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: das mit macOS gelieferte curl und das curl von Homebrew, unter allen aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • Das Terminal zeigt curl: (56) Failure when receiving data from the peer oder eine ähnliche Zeile.
  • Ein Download beginnt und bricht dann ab.
  • Der Text kann „Connection reset by peer“ ergänzen.

Mögliche Ursachen

  • Eine zurückgesetzte Verbindung. Ein Server, Proxy oder eine Firewall hat die Verbindung geschlossen, während Daten flossen.
  • Ein VPN oder ein Netzwerkwechsel. Eine VPN-Neuverbindung oder ein WLAN-Wechsel bricht die Übertragung ab.
  • Ein Proxy, der den Inhalt blockiert. Ein Filter kann eine Antwort abschneiden, die er nicht erlaubt.
  • Ein Serverfehler. Der Server kann bei einer langen Antwort ausfallen.

So prüfst du es

  1. Führe curl mit Details aus. Notiere, wann der Fehler beginnt.

    curl -v https://example.com
  2. Wiederhole den Versuch in einem anderen Netzwerk, etwa einem iPhone-Hotspot.

  3. Zeige die Proxy-Variablen an.

    env | grep -i proxy
  4. Prüfe die WLAN-Verbindung, während die Übertragung läuft.

    kilobat wifi

So behebst du es

  1. Wiederhole die Übertragung. Baue in Skripten Wiederholungen ein.

    curl --retry 3 -O https://example.com/file.zip
  2. Schalte das VPN, den Proxy oder die Sicherheits-App für einen kurzen Test aus. Schalte sie danach wieder ein.

  3. Setze einen Download mit -C - fort.

    curl -C - -O https://example.com/file.zip
  4. Wenn es nur in einem Netzwerk scheitert, frage dessen Administrator nach Filterung.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet die Adresse Schicht für Schicht: Netzwerk, Proxy, DNS, Regeln, IPv4, IPv6, TLS und Server. Er nennt die Schicht, die fehlgeschlagen ist.

    kilobat why https://example.com
  2. Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit diagnose_connection und diagnose_network aus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.

Fragen

Ist (56) dasselbe wie ECONNRESET?

Eine zurückgesetzte Verbindung ist eine mögliche Ursache. Siehe “npm error code ECONNRESET” auf dem Mac.

Beweist es, dass der Server fehlerhaft ist?

Nein. Auch ein Gerät auf dem Weg kann die Verbindung schließen.

Quellen

Geprüft am 29. Oktober 2026.