“curl: (7) Failed to connect” auf dem Mac
Der curl-Exit-Code 7 meldet einen fehlgeschlagenen Schritt. Die curl-Dokumentation sagt: “Failed to connect() to host or proxy.”
Mein Mac hat dieses Problem: „curl: (7) Failed to connect“ auf dem Mac. Lies https://kilobat.app/de/guides/curl-7-failed-to-connect.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.
Symptome
- Das Terminal zeigt
curl: (7) Failed to connect to host port 443. - Der Text ergänzt oft „Couldn't connect to server“ oder „Connection refused“.
- Skripte und Installer brechen mit dem Exit-Code 7 ab.
Mögliche Ursachen
- Nichts lauscht am Port. Der Dienst ist aus, oder er nutzt einen anderen Port.
- Eine Firewall oder ein Proxy. Eine Firewall kann die Verbindung ablehnen. curl scheitert auch, wenn ein Proxy gesetzt, aber nicht erreichbar ist.
- Eine falsche Adresse. Host oder Port in der URL sind falsch. Eine Variable in einem Skript kann leer sein.
- Eine IPv6- oder VPN-Route. curl versucht möglicherweise eine Adresse, die das Netzwerk nicht erreicht.
So prüfst du es
Gib die genaue URL aus. Prüfe Host und Port.
Führe curl mit Details aus. Die ersten Zeilen zeigen die Adresse, die gescheitert ist.
curl -v https://example.comTeste den Port.
nc -vz example.com 443Zeige die Proxy-Variablen an.
env | grep -i proxy
So behebst du es
Starte den Dienst, wenn es deiner ist. Nutze den Port, den er ausgibt.
Erzwinge IPv4, um einen IPv6-Fehler zu testen.
curl -4 -v https://example.comEntferne einen falschen Proxy.
unset https_proxy http_proxySchalte das VPN für einen kurzen Test aus. Schalte es danach wieder ein.
Mit Kilobat
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.comDiese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit
diagnose_connectionunddiagnose_networkaus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.
Fragen
Heißt Exit-Code 7, dass der Host ausgefallen ist?
Nicht immer. curl konnte den Host oder den Proxy nicht erreichen. Finde mit curl -v heraus, welchen.
Was ist der Unterschied zu (6)?
Exit-Code 6 heißt, dass der Hostname nicht aufgelöst wurde. Code 7 heißt, dass die Verbindung scheiterte. Siehe “curl: (6) Could not resolve host” auf dem Mac.
Quellen
Geprüft am 29. Oktober 2026.