docker exec -it öffnet eine interaktive Shell in einem Container, der bereits läuft: -i hält die Standardeingabe offen und -t weist ein Terminal zu. In Produktion beginnen Sie mit sh, wenn Sie nicht wissen, was das Image mitbringt, legen den Benutzer mit -u und das Verzeichnis mit --workdir fest und ändern nichts, was ein Neuerstellen nicht überstehen würde.
docker exec -it: minimale Syntax und was jedes Flag bewirkt
Die Grundform lautet docker exec [options] CONTAINER COMMAND, und der Befehl läuft im bestehenden Container, statt einen neuen zu erzeugen. Ermitteln Sie zuerst den genauen Namen und steigen Sie dann ein:
docker ps
docker exec -it api sh
# With Docker Compose, by service name
docker compose exec api sh-i verbindet Ihre Standardeingabe mit dem Prozess und -t gibt ihm ein Pseudo-Terminal; ohne -t erhalten Sie weder Prompt noch Zeilenbearbeitung. docker compose exec weist standardmäßig ein Terminal zu, und -T schaltet das ab, was genau das ist, was Skripte brauchen. Steckt der Container in einer Neustartschleife fest, schlägt exec fehl: Prüfen Sie zuerst docker logs --tail 100 api.
sh vs. bash bei docker exec: So erkennen Sie, welche Shell das Image mitbringt
Viele minimale Images, etwa solche auf Alpine-Basis, enthalten sh, aber kein bash, und Distroless-Images enthalten überhaupt keine Shell. Fordern Sie bash an, wo es nicht existiert, meldet Docker einen Fehler, dass die ausführbare Datei nicht im $PATH gefunden wurde. Prüfen statt raten:
docker exec api sh -c 'command -v bash || echo no-bash'
# Use bash if present, otherwise stay in sh
docker exec -it api bash
docker exec -it api shsh ist die sichere Voreinstellung: Es funktioniert fast immer, und zum Lesen von Logs oder Prüfen der Konfiguration braucht man keine ausgefeilte Vervollständigung. Installieren Sie bash nicht aus Bequemlichkeit mit dem Paketmanager im Container; diese Installation ist nach dem nächsten Deployment weg. Hat das Image keine Shell, funktioniert docker cp trotzdem, sodass Sie Dateien herausholen und auf dem Host lesen können.
Benutzer bei docker exec: -u, root und Dateien mit falschem Eigentümer
docker exec läuft standardmäßig als derselbe Benutzer wie der Hauptprozess des Containers, also als der USER des Images oder der --user, mit dem er erstellt wurde. Vergewissern Sie sich, wer Sie sind, bevor Sie etwas anfassen:
docker inspect --format '{{.Config.User}}' api
docker exec api id
# Root only for what strictly needs it
docker exec -it -u 0 api sh
# Same UID:GID as the application
docker exec -it -u 1000:1000 api shEin leerer String von docker inspect bedeutet, dass der Container als root läuft. Das eigentliche Risiko von -u 0 ist nicht nur die Sicherheit: Eine als root in einem gemeinsam genutzten Volume angelegte Datei kann verhindern, dass die Anwendung, die unter einer anderen UID läuft, sie später beschreibt. Arbeitsregel: als Anwendungsbenutzer lesen, für eine bestimmte Aktion zu root wechseln und direkt danach wieder hinausgehen.
--workdir bei docker exec: die Shell im relevanten Verzeichnis öffnen
-w oder --workdir legt das Arbeitsverzeichnis des Befehls fest; ohne diese Option startet docker exec im WORKDIR des Images. Zusammen mit -u beseitigt das den klassischen Fehler mit dem falschen cd:
docker exec -it -w /var/log/nginx web sh
# One-off command, no interactive shell
docker exec -w /app api ls -la
# User and directory together
docker exec -it -u www-data -w /var/www/html web shEinzeilige Prüfungen brauchen kein -it: Ein docker exec ohne Terminal gibt die Ausgabe aus und beendet sich, was das erneute Ausführen und das Einfügen in einen Incident-Bericht erleichtert.
Mit docker exec vorgenommene Änderungen, die ein Neuerstellen des Containers nicht überstehen
Alles, was außerhalb eines Volumes geschrieben wird, landet in der beschreibbaren Schicht des Containers, und docker compose up -d --force-recreate oder jedes neue Deployment verwirft diese Schicht. Ein einfaches docker restart behält sie bei, wodurch ein Hotfix dauerhaft wirkt, obwohl er es nicht ist. Prüfen Sie vor dem Verlassen, was Sie angefasst haben:
# A = added, C = changed, D = deleted
docker diff api
# Paths that do persist (volumes and bind mounts)
docker inspect --format '{{range .Mounts}}{{.Destination}} {{end}}' api
# Take a copy before you start poking
docker cp api:/app/config/settings.yml ./settings.yml- Installieren Sie keine Pakete zum Debuggen; sie verschwinden und verändern das Image, von dem Sie glauben, dass es läuft.
- Bearbeiten Sie keine Konfiguration im Container; korrigieren Sie sie im Image, in der Compose-Datei oder im Volume.
- Führen Sie kein chmod oder chown außerhalb eines Volumes aus; das nächste Neuerstellen macht es stillschweigend rückgängig.
- Beenden Sie nicht PID 1; wenn der Hauptprozess stirbt, stoppt der gesamte Container.
docker exec -it vom Smartphone vs. vom Desktop: was sich ändert
Um vom Smartphone in einen Container zu gelangen, braucht man zwei Dinge, die am Desktop selbstverständlich sind: Tasten wie Ctrl und Tab sowie eine Sitzung, die einen Ortswechsel übersteht. Hier der Vergleich:
| Bedarf bei docker exec | Desktop | Smartphone mit termi1 |
|---|---|---|
| Ctrl+C, Ctrl+D, Tab und Pfeiltasten | Physische Tastatur | Eigene Tastatur mit Esc, Ctrl, Tab und Pfeiltasten |
| Netzwerkwechsel | Über SSH geht die offene Shell verloren | Mosh hält die Sitzung beim Wechsel von WLAN zu mobilen Daten |
| Lange Aufgaben auf dem Host | tmux, von Hand eingerichtet | tmux: Was Sie laufen lassen, ist weiterhin da |
| Herunterladen einer mit docker cp herausgeholten Datei | scp oder sftp in einem anderen Fenster | Integriertes SFTP, ohne die Sitzung zu verlassen |
| Eingeben des Befehls | Von Hand oder aus dem Verlauf | Die KI tippt ihn am Prompt ein, ohne Enter zu drücken |
Bei einer als Produktion markierten Verbindung sendet der Production Guard in termi1, dem mobilen SSH-Terminal, nie automatisch Enter und hält alles zurück, was etwas löscht, stoppt oder ändert, bevor es den Prompt erreicht, sodass ein docker exec mit -u 0 nie von selbst ausgelöst wird. Die KI öffnet die Sitzung nicht und erhält keine Schlüssel, und der private SSH-Schlüssel verlässt nie das Smartphone. Sie erhalten sie über die termi1-App bei Google Play; weitere Server-Anleitungen finden Sie im technischen Blog von termi1.
Häufig gestellte Fragen
Warum findet docker exec -it kein bash im Container?
docker exec -it findet bash nicht, weil viele minimale Images, etwa solche auf Alpine-Basis, nur sh enthalten und Distroless-Images überhaupt keine Shell mitbringen. Verwenden Sie stattdessen docker exec -it container sh, und wenn keine Shell vorhanden ist, holen Sie Dateien mit docker cp heraus, um sie auf dem Host zu prüfen.
Wie bekomme ich mit docker exec eine Root-Shell im Container?
Eine Root-Shell mit docker exec erhalten Sie über -u 0, zum Beispiel docker exec -it -u 0 api sh. Beschränken Sie sie auf eine bestimmte Aktion: Dateien, die Sie als root in einem Volume anlegen, kann die Anwendung, die meist unter einer anderen UID läuft, danach möglicherweise nicht mehr beschreiben.
Gehen mit docker exec vorgenommene Änderungen beim Neustart des Containers verloren?
Mit docker exec vorgenommene Änderungen außerhalb eines Volumes überstehen docker restart, gehen aber verloren, wenn der Container mit docker compose up -d --force-recreate oder durch ein neues Deployment neu erstellt wird. docker diff listet die Dateien auf, die Sie in der beschreibbaren Schicht hinzugefügt, geändert oder gelöscht haben.
Was ist der Unterschied zwischen docker exec und docker attach?
docker exec startet einen neuen Prozess im Container, während docker attach sich mit der Ein- und Ausgabe des Hauptprozesses verbindet. Bei attach kann ein Ctrl+C den Hauptprozess erreichen und den Container stoppen, deshalb ist docker exec die vorsichtige Wahl, um Produktionssysteme zu untersuchen.