ERR_CONNECTION_REFUSED auf Localhost (XAMPP, Laragon, MAMP)

Was dieser Fehler bedeutet und wie du ihn erkennst

• Der Browser zeigt für localhost oder einen lokalen Hostnamen sofort ERR_CONNECTION_REFUSED an.
• XAMPP, Laragon oder MAMP zeigt Apache oder Nginx als gestoppt, fehlgeschlagen oder nicht mehr laufend an.
• Der Server startet und beendet sich anschließend wieder, manchmal mit einem Hinweis auf einen Port, eine Konfigurationsdatei oder einen Syntaxfehler.
• Das Problem tritt nach einem Neustart, einer Änderung am Betriebssystem, der Installation eines lokalen Servers oder einer Konfigurationsänderung auf.
• Die Projektdateien sind auf dem Computer vorhanden, aber der Browser kann keine Verbindung zum lokalen Server herstellen.
• Ein Server mit benutzerdefiniertem Port kann unter einer Adresse funktionieren, während einfaches localhost fehlschlägt, weil der Browser den Standard-HTTP-Port verwendet.

Hauptursachen nach Wahrscheinlichkeit

1. Apache oder Nginx läuft nicht — Der lokale Dienst wurde möglicherweise nicht gestartet oder ist beim Start fehlgeschlagen.
2. Ein anderer Prozess verwendet den konfigurierten Port — IIS, eine weitere XAMPP-, Laragon- oder MAMP-Installation, ein eigenständiger Apache- oder Nginx-Prozess, Virtualisierungssoftware oder eine andere Anwendung lauscht möglicherweise bereits auf Port 80 oder 443.
3. Die Serverkonfiguration ist ungültig — Ein Syntaxfehler in httpd.conf, einer Nginx-Konfigurationsdatei, einer Virtual-Host-Datei oder einer anderen kürzlich bearbeiteten Serverdatei kann dazu führen, dass der Dienst sofort beendet wird.
4. Der Browser verwendet den falschen Port — Ein Stack, der für Port 8080 oder einen anderen benutzerdefinierten Port konfiguriert ist, antwortet normalerweise nicht auf einfaches localhost am standardmäßigen HTTP-Port.
5. Firewall- oder Antivirensoftware greift ein — Eine kürzliche Änderung an der Sicherheitssoftware kann den lokalen Server oder dessen Netzwerkbindung blockieren. Dies ist jedoch seltener als ein gestoppter Dienst oder ein Portkonflikt.

So behebst du den Fehler

1. Lokalen Server und Adresse prüfen

Öffnen Sie das XAMPP Control Panel, die Laragon- oder die MAMP-Anwendung und prüfen Sie, ob Apache oder Nginx als Running gekennzeichnet ist. Wenn der Dienst gestoppt ist, wählen Sie Start und notieren Sie die genaue Meldung, falls der Start fehlschlägt.

Prüfen Sie, welchen HTTP- oder HTTPS-Port der Stack verwendet. Bei einem benutzerdefinierten Port testen Sie die passende Adresse, zum Beispiel localhost:8080, statt davon auszugehen, dass einfaches localhost korrekt ist.

2. Portkonflikt ermitteln

Wenn die Startmeldung besagt, dass ein Port bereits verwendet wird, prüfen Sie den betreffenden Port. Öffnen Sie unter Windows bei Bedarf die Eingabeaufforderung mit Administratorrechten und führen Sie diese schreibgeschützten Befehle aus:

netstat -ano | findstr :80
netstat -ano | findstr :443

Verwenden Sie die angezeigte Prozess-ID, um den Besitzer im Task-Manager zu ermitteln. Beenden Sie keinen unbekannten Prozess. Wenn IIS den Port verwendet und Sie berechtigt sind, Änderungen am Computer vorzunehmen, deaktivieren oder stoppen Sie den betreffenden IIS-Dienst nur, wenn IIS nicht benötigt wird. Konfigurieren Sie den lokalen Stack andernfalls für einen verfügbaren Port und verwenden Sie diesen Port im Browser.

Die obigen Befehle gelten speziell für Windows. Verwenden Sie auf einem anderen Betriebssystem die integrierten Netzwerk- oder Prozesstools oder die von der Systemsteuerung des Stacks bereitgestellten Portinformationen.

3. Server-Error-Log prüfen

Wenn kein offensichtlicher Prozess den konfigurierten Port verwendet, öffnen Sie das Apache- oder Nginx-Error-Log über den lokalen Stack oder das konfigurierte Log-Verzeichnis. Suchen Sie nach dem ersten konkreten Fehler, insbesondere nach einem Dateipfad, einer Konfigurationsdirektive und einer Zeilennummer.

Wenn der Fehler nach einer Konfigurationsänderung begann, korrigieren Sie diese Änderung oder machen Sie sie rückgängig. Prüfen Sie httpd.conf, Nginx-Konfigurationsdateien, Virtual-Host-Definitionen und alle eingebundenen Dateien. Ändern Sie jeweils nur eine Datei, damit die Ursache erkennbar bleibt.

4. Doppelte lokale Server prüfen

Suchen Sie nach einer zweiten XAMPP-, Laragon-, MAMP- oder WAMP-Installation sowie nach eigenständigen Apache- oder Nginx-Installationen. Zwei Dienste können normalerweise nicht an derselben Adresse und demselben Port lauschen. Stoppen Sie einen nicht benötigten Dienst nur, wenn Sie sicher sind, dass dies unbedenklich ist und Sie dazu berechtigt sind, oder weisen Sie den benötigten Stacks unterschiedliche Ports zu.

5. Änderungen an Sicherheitssoftware prüfen

Wenn die Serverkonfiguration gültig ist und kein konkurrierender Prozess den Port verwendet, prüfen Sie kürzliche Änderungen an Firewall oder Antivirensoftware. Verwenden Sie die normalen Einstellungen des Sicherheitsprodukts und erstellen Sie eine Ausnahme nur, wenn Sie die dadurch erlaubten Zugriffe verstehen. Deaktivieren Sie den Schutz nicht pauschal als ersten Schritt zur Fehlerbehebung.

6. Reparatur überprüfen

Warten Sie, bis Apache oder Nginx dauerhaft den Status Running anzeigt, und öffnen Sie anschließend die konfigurierte Localhost-Adresse erneut. Statt ERR_CONNECTION_REFUSED sollte nun eine Standardseite des Servers oder das Projekt geladen werden.

Wenn die Standardseite geladen wird, das Projekt jedoch nicht, ist das Verbindungsproblem behoben. Fahren Sie mit der Fehlersuche bei Document Root, Routing, Virtual Host oder der Anwendung fort, statt die Porteinstellungen erneut zu ändern.

Vorbeugung und Überprüfung der Lösung

• Notieren Sie die von jedem lokalen Stack verwendeten HTTP- und HTTPS-Ports, insbesondere wenn mehr als ein Stack installiert ist.
• Vermeiden Sie es, mehrere lokale Server auf derselben Adresse und demselben Port auszuführen. Weisen Sie ihnen unterschiedliche Ports zu, wenn beide benötigt werden.
• Halten Sie Änderungen an Apache-, Nginx- und Virtual-Host-Konfigurationsdateien fest.
• Starten Sie den Dienst nach einer Änderung der Serverkonfiguration und prüfen Sie das Error-Log, bevor Sie von einem Fehler im Projektcode ausgehen.
• Verwenden Sie die Systemsteuerung des Stacks, um zu bestätigen, dass der Dienst dauerhaft läuft und nicht nur einmalig startet.
• Vergewissern Sie sich vor dem Stoppen eines Prozesses oder Dienstes, dass er nicht von IIS, einem anderen Entwicklungstool oder einer unabhängigen Anwendung benötigt wird.

Häufig gestellte Fragen