Docker-Container wird sofort beendet: Ursache finden und beheben

So erkennen Sie das Problem

• `docker ps` zeigt den Container nicht an, aber `docker ps -a` führt ihn als Exited
• Der Container startet und verschwindet innerhalb weniger Sekunden
• In den Logs steht nichts oder nur eine Fehlermeldung beim Start
• Die Anwendung läuft lokal, beendet sich im Container aber sofort
• Der Exit-Code ist 0, 1, 127 oder 137

Häufigste Ursachen

Lösung Schritt für Schritt

1. 1

   Status und Exit-Code prüfen

   Führen Sie docker ps -a aus, um alle Container einschließlich der beendeten anzuzeigen. Achten Sie auf die Spalte STATUS und den Exit-Code. Code 0 bedeutet, dass der Prozess normal beendet wurde, 1 ist ein allgemeiner Fehler, 127 ein nicht existierender Befehl und 137 deutet auf eine erzwungene Beendigung hin, oft wegen Speichermangels.

2. 2

   Logs prüfen

   Führen Sie docker logs <Name_oder_ID> aus. Wenn der Container beendet ist, fügen Sie --tail 100 hinzu, um die letzten hundert Zeilen zu sehen. Die Logs enthalten meist den genauen Grund, zum Beispiel einen Konfigurationsfehler oder die Meldung, dass der Befehl nicht gefunden wurde.

3. 3

   Container interaktiv starten

   Umgehen Sie den Startbefehl und gehen Sie in die Shell: docker run -it --entrypoint /bin/sh <Image>. Wenn das Image kein sh hat, versuchen Sie bash. Starten Sie die Anwendung innerhalb des Containers manuell und sehen Sie den Fehler, den Sie sonst nicht sehen.

4. 4

   Befehl und Entrypoint prüfen

   Sehen Sie sich das Dockerfile und den docker run-Befehl an. Stellen Sie sicher, dass CMD oder ENTRYPOINT im richtigen Format vorliegen und der Pfad zur ausführbaren Datei existiert. Wenn Sie docker compose verwenden, prüfen Sie das Feld command in docker-compose.yml.

5. 5

   Sicherstellen, dass der Hauptprozess im Vordergrund bleibt

   Die Anwendung darf nicht im Hintergrund gestartet werden oder sofort enden. Wenn es sich um ein Skript handelt, fügen Sie am Ende eine Schleife hinzu oder starten Sie einen Server, der lauscht. Für Container, die nur aktiv bleiben sollen, verwenden Sie tail -f /dev/null als vorübergehende Lösung.

6. 6

   Umgebungsvariablen und Konfiguration prüfen

   Vergleichen Sie docker inspect <Container> mit dem, was die Anwendung erwartet. Fügen Sie fehlende Variablen über -e oder im Abschnitt environment hinzu. Prüfen Sie auch, ob Konfigurationsdateien am richtigen Pfad eingebunden sind.

7. 7

   Berechtigungen und Eigentümer prüfen

   Wenn die Anwendung in ein Volume oder Verzeichnis schreibt, stellen Sie sicher, dass der Benutzer im Container die Berechtigung hat. Fügen Sie in docker run --user hinzu oder passen Sie das Dockerfile an. Berechtigungsfehler erscheinen oft in den Logs als Permission denied.

8. 8

   Healthcheck und Abhängigkeiten deaktivieren

   Wenn Sie Compose verwenden, kommentieren Sie vorübergehend healthcheck und depends_on aus, um zu sehen, ob der Container eigenständig läuft. Fügen Sie sie dann einzeln wieder hinzu und beobachten Sie das Verhalten.

9. 9

   Image neu erstellen

   Wenn Sie das Dockerfile geändert haben, führen Sie docker build --no-cache -t <Name> . aus und starten Sie den Container erneut. Ein zwischengespeicherter Layer kann eine Änderung verbergen, die die Ursache des Problems ist.

Wenn nichts hilft

So beugen Sie vor

• Verwenden Sie immer `docker logs` und den Exit-Code, bevor Sie etwas ändern.
• Geben Sie im Dockerfile explizit `CMD` oder `ENTRYPOINT` an und testen Sie es lokal.
• Bereinigen Sie gelegentlich beendete Container, ungenutzte Netzwerke und dangling Images mit `docker system prune`; prüfen Sie vor dem Ausführen, was entfernt wird, und erstellen Sie eine Sicherung wichtiger Daten.
• Definieren Sie in der Compose-Datei einen Healthcheck und `restart: unless-stopped` für Dienste, die dauerhaft laufen sollen.

Häufige Fragen