Zurück zum Blog

Port bereits belegt: Den Prozess hinter dem Port finden

Port bereits belegt? So finden Sie mit ss, lsof und fuser den belegenden Prozess, beenden ihn sauber oder wechseln den Port und beheben verwandte Fehler.

Nodesty-Team7 Min. LesezeitServer
Der Schriftzug Port in Use mit ss, lsof und fuser auf dunklem Nodesty-Hintergrund

Die Meldung Port bereits belegt („address already in use“) bedeutet, dass der Port, den Ihre Anwendung nutzen möchte, schon von einem anderen Prozess belegt ist. Der Fehler tritt in vielen Varianten auf: Node.js meldet EADDRINUSE, nginx verweigert den Start, ein Minecraft-Server schreibt FAILED TO BIND TO PORT und Docker meldet port is already allocated. In jedem Fall beginnt die Lösung mit derselben Frage: Welcher Prozess hält den Port fest?

In dieser Anleitung zeigen wir, wie Sie diesen Prozess mit ss, lsof und fuser finden, wie Sie die Ausgabe lesen, wer die üblichen Verursacher sind und wie Sie sie sauber beenden. Zum Schluss geht es um das umgekehrte Problem: Es lauscht gar nichts.

So sieht der Fehler aus

Auf einem Port kann bei gleicher IP-Adresse und gleichem Protokoll immer nur ein Prozess lauschen. Versucht es ein zweiter, erhält er eine Fehlermeldung wie diese:

# Node.js
Error: listen EADDRINUSE: address already in use :::3000

# nginx
nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use)

# Minecraft (Java Edition)
**** FAILED TO BIND TO PORT!
The exception was: java.net.BindException: Address already in use

# Docker
Bind for 0.0.0.0:80 failed: port is already allocated

Die Zahl in der Meldung (3000, 80, 25565) ist der Port, den Sie untersuchen müssen. Wenn Sie nicht sicher sind, was ein Port ist, lesen Sie zuerst unsere Anleitung Was ist ein Port?.

Den Prozess finden: ss, lsof und fuser

Nachdem Sie sich per SSH mit Ihrem Server verbunden haben, ist ss das schnellste Werkzeug; es ist auf jeder aktuellen Distribution installiert:

sudo ss -tulpn | grep :80

-t und -u zeigen TCP und UDP, -l nur lauschende Sockets, -p den Prozess und -n numerische Ports. Führen Sie den Befehl mit sudo aus, sonst bleibt die Prozessspalte bei Diensten anderer Benutzer leer. Eine typische Zeile sieht so aus:

tcp   LISTEN 0      511      0.0.0.0:80      0.0.0.0:*    users:(("nginx",pid=1234,fd=6))

Der Prozess ist hier nginx mit der PID 1234. Zwei weitere Werkzeuge liefern dieselbe Antwort:

sudo lsof -nP -iTCP:80 -sTCP:LISTEN
sudo fuser -v 80/tcp

lsof zeigt Befehlsname, PID und Benutzer, fuser gibt die PIDs aus, die den Port verwenden. Fehlt eines davon, installieren Sie es mit sudo apt install lsof psmisc (unter AlmaLinux mit sudo dnf install lsof psmisc). Für einen UDP-Port, etwa einen Bedrock-Server auf 19132, verwenden Sie sudo fuser -v 19132/udp.

Mehr über eine PID erfahren Sie, wenn Sie sich die vollständige Befehlszeile und den zugehörigen systemd-Dienst ansehen:

ps -fp 1234
systemctl status 1234

Die ss-Ausgabe lesen

Die Spalte Local Address:Port verrät, wo der Prozess lauscht:

AdresseBedeutung
0.0.0.0:80Alle IPv4-Adressen, von außen erreichbar
[::]:80 / *:80Alle IPv6-Adressen (je nach Anwendung oft auch IPv4)
127.0.0.1:3306Nur vom Server selbst (localhost)
203.0.113.10:80Nur auf dieser bestimmten IP-Adresse des Servers

LISTEN bedeutet, dass der Prozess auf Verbindungen wartet. Steht in der Prozessspalte statt einer Anwendung systemd, hält eine systemd-Socket-Unit den Port; welche, zeigt systemctl list-sockets. Steht dort docker-proxy, veröffentlicht ein Docker-Container den Port.

Die üblichen Verursacher

  • Apache und nginx gleichzeitig: Beide wollen die Ports 80 und 443. Wer nginx auf einem Server installiert, auf dem Apache bereits läuft (apache2 unter Ubuntu, httpd unter AlmaLinux), löst damit am häufigsten den Bind-Fehler von nginx aus.
  • Eine zweite Instanz des Gameservers: Ein Minecraft- oder anderer Gameserver, den Sie früher in tmux oder screen gestartet haben, läuft nach dem Trennen der Verbindung weiter. Prüfen Sie das mit tmux ls und screen -ls.
  • Ein Prozess, der nicht beendet wurde: Nach einem Absturz oder einem erzwungenen Neustart kann ein alter Java- oder Node.js-Prozess hängen bleiben und den Port weiter belegen.
  • Ein Docker-Container: Ein Container, der denselben Port mit -p 80:80 veröffentlicht, womöglich mit der Richtlinie restart: always.
  • Ein systemd-Dienst: Ein Dienst mit Restart=always ist wenige Sekunden nach dem Beenden wieder da.

Den Prozess sauber beenden

Gehört der Port zu einem systemd-Dienst, beenden Sie ihn über systemd. Soll er beim Booten nicht wieder starten, verwenden Sie zusätzlich disable:

sudo systemctl stop apache2
sudo systemctl disable apache2

Einen Docker-Container finden Sie anhand des veröffentlichten Ports und stoppen ihn:

docker ps --filter "publish=80"
docker stop containername

Ein Container mit Neustart-Richtlinie startet wieder, sobald Docker neu startet; brauchen Sie ihn nicht, entfernen Sie ihn mit docker rm oder ändern Sie seine Portzuordnung. Bei einem Gameserver in tmux oder screen verbinden Sie sich mit der Sitzung und beenden den Server mit seinem eigenen stop-Befehl, damit die Welt gespeichert wird.

Erst wenn kein Manager hinter dem Prozess steht, beenden Sie ihn selbst:

kill 1234
# nur, wenn er nach einigen Sekunden noch läuft:
kill -9 1234

Ein einfaches kill sendet SIGTERM und lässt die Anwendung sauber beenden. kill -9 beendet sie sofort und kann ungespeicherte Daten kosten; heben Sie es sich daher als letztes Mittel auf. sudo fuser -k 80/tcp beendet alle Prozesse auf dem Port auf einen Schlag, lässt Ihnen aber keine Gelegenheit zu prüfen, was Sie gerade beenden.

Stattdessen den Port wechseln

Manchmal müssen beide Anwendungen laufen. Geben Sie dann einer davon einen anderen Port: listen 8080; in einem nginx-Serverblock, Listen 8080 in der ports.conf von Apache, server-port in der server.properties von Minecraft, die Variable PORT oder der listen()-Aufruf in Node.js und -p 8080:80 bei Docker. Ports unter 1024 erfordern Root-Rechte; wählen Sie für Anwendungen, die als normaler Benutzer laufen, einen höheren Port. Vergessen Sie nicht, den neuen Port in der Firewall freizugeben; siehe UFW Firewall.

Möchten Sie mehrere Websites gleichzeitig auf den Ports 80 und 443 betreiben, setzen Sie stattdessen nginx als Reverse Proxy davor; das erklären wir in Nginx installieren.

TIME_WAIT und SO_REUSEADDR

Nachdem ein Server Verbindungen geschlossen hat, zeigt ss -tan diese unter Umständen etwa eine Minute lang im Zustand TIME_WAIT. Einen Neustart verhindert das normalerweise nicht: Die meisten Server, darunter nginx und Node.js, setzen die Socket-Option SO_REUSEADDR und können sofort wieder lauschen. Meldet Ihre eigene Anwendung den Fehler nur direkt nach einem Neustart und funktioniert eine Minute später, setzen Sie SO_REUSEADDR auf ihrem lauschenden Socket.

Alle lauschenden Ports als Sicherheitscheck auflisten

Derselbe Befehl ohne Filter zeigt alles, was Ihr Server nach außen anbietet:

sudo ss -tulpn

Gehen Sie die Liste durch und fragen Sie sich bei jeder Zeile auf 0.0.0.0 oder [::], ob sie wirklich aus dem Internet erreichbar sein muss. Datenbanken wie MySQL (3306), PostgreSQL (5432) und Redis (6379) sollten in der Regel nur auf 127.0.0.1 lauschen. Entfernen Sie Dienste, die Sie nicht nutzen, und sperren Sie den Rest mit der Firewall. Weitere nützliche Werkzeuge für solche Prüfungen finden Sie in unserer Anleitung Linux-Befehle.

Das umgekehrte Problem: Connection refused

Erhalten Clients Connection refused oder eine Zeitüberschreitung, prüfen Sie zuerst, ob überhaupt etwas lauscht:

sudo ss -tulpn | grep :3000
curl -I http://127.0.0.1:3000
  • Keine Ausgabe: Es lauscht nichts. Die Anwendung wurde beendet oder ist abgestürzt; sehen Sie in ihre Logs (journalctl -u dienstname). Damit systemd sie automatisch neu startet, lesen Sie unsere Anleitung systemd-Service erstellen.
  • Lauscht auf 127.0.0.1: Die Anwendung funktioniert lokal, ist aber von außen nicht erreichbar. Ändern Sie die Bind-Adresse auf 0.0.0.0 oder setzen Sie nginx davor.
  • Lauscht auf 0.0.0.0, ist aber von außen nicht erreichbar: Die Firewall blockiert. Ein sofortiges Connection refused bedeutet meist, dass nichts lauscht oder die Firewall das Paket ablehnt; eine Zeitüberschreitung deutet meist darauf hin, dass eine Firewall es verwirft. Geben Sie den Port mit sudo ufw allow 3000/tcp frei, unter AlmaLinux mit firewall-cmd.

Wer Docker nutzt, sollte wissen, dass veröffentlichte Ports UFW umgehen können; Details finden Sie in unserer Anleitung Docker installieren.

Ports auf Nodesty-Servern

Die Nodesty-Pakete AMD Ryzen 9 9950X vServer und AMD EPYC 7763 vServer kommen mit NVMe-Speicher und vollem Root-Zugriff; Sie sehen alle lauschenden Ports und entscheiden selbst, welcher Dienst auf welchem Port läuft. Bei den vServer-Paketen sind tägliche Backups kostenlos und werden 7 Tage aufbewahrt.

Häufig gestellte Fragen

Was bedeutet die Meldung "Address already in use"?

Die Anwendung wollte auf einem Port lauschen, auf dem bereits ein anderer Prozess lauscht. Auf derselben IP-Adresse und mit demselben Protokoll kann immer nur ein Prozess einen Port belegen, deshalb startet der zweite nicht. Die Lösung besteht darin, den Prozess zu finden und zu beenden, der den Port belegt, oder der neuen Anwendung einen anderen Port zu geben.

Wie finde ich unter Linux heraus, welcher Prozess einen Port belegt?

Führen Sie sudo ss -tulpn aus und filtern Sie nach der Portnummer, zum Beispiel mit sudo ss -tulpn | grep :80. In der letzten Spalte stehen der Prozessname und die PID. sudo lsof -i :80 und sudo fuser -v 80/tcp liefern dieselbe Information in anderer Form.

Ich habe den Prozess beendet, aber der Port ist wieder belegt. Warum?

Der Prozess wird höchstwahrscheinlich von systemd, Docker oder einem Prozessmanager verwaltet, der ihn automatisch neu startet. Beenden Sie ihn über diesen Manager, etwa mit sudo systemctl stop dienstname oder docker stop containername, und deaktivieren Sie ihn, wenn er beim Booten nicht starten soll.

Sollte ich kill -9 verwenden, um einen Port freizugeben?

Nur als letztes Mittel. Ein einfaches kill sendet SIGTERM, sodass die Anwendung Daten speichern und sauber beenden kann. kill -9 beendet den Prozess sofort, wodurch ein Gameserver oder eine Datenbank ungespeicherte Daten verlieren kann. Versuchen Sie zuerst systemctl stop oder ein einfaches kill und warten Sie einige Sekunden.

Können Apache und nginx auf demselben Server laufen?

Ja, aber nicht beide auf den Ports 80 und 443. Entfernen Sie entweder den Webserver, den Sie nicht brauchen, oder verlegen Sie einen auf einen anderen Port, etwa Apache auf 8080 hinter nginx als Reverse Proxy.

Der Port ist frei, trotzdem bekomme ich keine Verbindung. Woran liegt das?

Prüfen Sie mit ss -tulpn, ob überhaupt etwas lauscht. Lauscht die Anwendung nur auf 127.0.0.1, ist sie nur vom Server selbst erreichbar. Lauscht sie auf 0.0.0.0 und ist von außen trotzdem nicht erreichbar, blockiert vermutlich die Firewall den Port.

Nodesty

Über den Autor

Nodesty-Team · Infrastruktur und Support

Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.

Verwandte Artikel

Starte deinen Server jetzt.

Erstellen, wachsen und skalieren Sie Ihre Projekte grenzenlos auf der Premium-Infrastruktur von Nodesty.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································