docker compose down-Befehl
docker compose downWird verwendet, um alle Container, Netzwerke und zugehörigen Ressourcen, die vondocker compose upgestartet wurden, zu stoppen und zu löschen.
Beim Ausführen vondocker compose upNach dem Starten einer Reihe von Diensten erstellt Docker automatisch Container, Netzwerke und sogar anonyme Daten-Volumes.
Wenn Sie nurdocker compose stopverwenden, werden die Container nur pausiert, belegen aber weiterhin Speicherplatz und behalten die Netzwerkkonfiguration bei; beim nächsten Start kann der alte Zustand zu Konflikten führen.
docker compose downDann erfolgt eine gründliche Bereinigung mit einem Klick: Container stoppen, Container löschen, Netzwerke entfernen und die Umgebung in einen sauberen Zustand zurückversetzen.
Das folgende Flussdiagramm zeigt die vollständige Ausführungskette des down-Befehls:
Wenn Sie sich nicht sicher sind, ob die aktuelle Umgebung sauber ist, verwenden Sie zuerstdocker compose psÜberprüfen Sie die laufenden Container und entscheiden Sie dann, ob Sie down ausführen möchten.
Schnellstart
Einfachste Verwendung: In einem Verzeichnis, dasdocker-compose.ymlenthält, führen Sie im Verzeichnis, in dem sich die Datei befindet, aus:
# 进入 Compose 项目目录 cd ~/myproject # 一键停止并清理所有资源 docker compose down
Nach der Ausführung gibt das Terminal normalerweise etwa Folgendes aus:
[+] Running 3/3 Container myproject-web-1 Removed 1.2s Container myproject-db-1 Removed 0.8s Network myproject_default Removed 0.3s
Zu diesem Zeitpunkt:
- Alle von Compose gestarteten Container wurden gestoppt und gelöscht.
- Das projektspezifische Netzwerk wurde entfernt.
- Daten-VolumesStandardmäßig beibehalten(um versehentliches Löschen von Daten zu verhindern)
Kurzübersicht der Befehlsoptionen
Im Folgenden finden Sie die vollständige Liste der unterstützten Optionen fürdocker compose down:
| Optionen | Abkürzung | Beschreibung | Standardwert |
|---|---|---|---|
| --volumes | -v | Löscht benannte Daten-Volumes, die in der Compose-Datei definiert sind, sowie anonyme Daten-Volumes, die von Containern eingebunden sind. | Nicht löschen |
| --remove-orphans | Keine | Verwaiste Container löschen, die Diensten entsprechen, die nicht mehr in der Compose-Datei vorhanden sind. | Nicht löschen |
| --rmi <type> | Keine | Löscht die von Diensten verwendeten Images; Typ ist optional.all(Alle) oderlocal(nur lokal erstellt) | Nicht löschen |
| --timeout | -t | Timeout (in Sekunden) zum Stoppen von Containern; nach dem Timeout zwangsweise beenden. | 10 |
| --dry-run | Keine | Nur die auszuführenden Vorgänge ausgeben, ohne sie tatsächlich auszuführen (v2.21+). | Nicht aktivieren |
Standardverhaltensweisen, die die meiste Aufmerksamkeit erfordern:Daten-Volumes werden standardmäßig nicht gelöschtDas bedeutet, dass selbst wenn Sie down ausführen, die Datenbankdaten im Daten-Volume verbleiben und beim nächsten Ausführen von up wiederhergestellt werden. Dies ist ein Schutzmechanismus, aber wenn Sie wirklich gründlich aufräumen möchten, denken Sie daran, hinzuzufügen-v。
Detaillierte Verwendung
Grundlegende Verwendung: stoppen und aufräumen
Direkt im Projektverzeichnis ohne Optionen ausführen:
# 停止并删除容器和网络,保留数据卷 docker compose down
Dies entspricht der Ausführung in dieser Reihenfolge:
docker compose stop # 停止所有容器 docker compose rm -f # 强制删除所有容器 docker network rm <网络名> # 删除项目网络
Datenvolumes ebenfalls löschen: -v / --volumes
Wenn Sie die Umgebung vollständig bereinigen müssen – einschließlich persistenter Inhalte wie Datenbankdaten und Caches – fügen Sie-v:
# 删除容器、网络以及 Compose 文件中定义的所有具名数据卷 docker compose down -v
The following is a complete comparison example to help understand-vAuswirkung zu verstehen:
Beispiel
services:
web:
image: nginx
ports:
- "8080:80"
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: example123
volumes:
- db_data:/var/lib/mysql # benannte Volumes
volumes:
db_data: # benannte Volumes definieren
# 不带 -v:db_data 数据卷保留,数据库中的数据不丢失 $ docker compose down [+] Running 3/3 Container test-web-1 Removed Container test-db-1 Removed Network test_default Removed # 带 -v:db_data 数据卷被删除,数据库数据永久丢失 $ docker compose down -v [+] Running 4/4 Container test-web-1 Removed Container test-db-1 Removed Volume test_db_data Removed Network test_default Removed
Ausführung in einer Produktionsumgebungdown -vBevor [Sie dies tun], überlegen Sie es sich zweimal – sobald ein Daten-Volume gelöscht wurde, sind die Daten nicht wiederherstellbar. Es wird empfohlen, zuerst eine Datensicherung durchzuführen oder es nur in Nicht-Produktionsumgebungen zu verwenden.-v。
Verwaiste Container bereinigen: --remove-orphans
Wenn Sie eine Dienstdefinition aus Ihrer docker-compose.yml-Datei löschen, der Container dieses Dienstes aber weiterhin vorhanden ist, werden diese Container als "verwaiste Container" bezeichnet.
Beispiel
services:
app:
image: nginx
networks:
- shared_network # verweist auf externes Netzwerk
networks:
shared_network:
external: true # externes Netzwerk, down wird es nicht löschen
volumes:
shared_data:
external: true # externes Volume, down -v löscht es ebenfalls nicht
Dies ist sinnvoll: Externe Ressourcen können von mehreren Compose-Projekten gemeinsam genutzt werden und sollten nicht von einem einzelnen Projekt bereinigt werden.
Startreihenfolge von Container-Abhängigkeiten
down stoppt Container in umgekehrter Reihenfolge, das heißt, zuerst wird die abhängige Seite gestoppt, dann die Seite, von der sie abhängt – entgegengesetzt zur Startreihenfolge während up –, wodurch sichergestellt wird, dass Abhängigkeiten korrekt freigegeben werden.
Kompatibilität mit docker-compose (Legacy-Version)
Wenn Sie eine ältere Versiondocker-compose(mit Bindestrich) verwenden, lautet das Befehlsformat:
$ docker-compose down -v
Das neue Docker Compose v2 integriert die Compose-Funktionalität in die Docker CLI, und der Befehl wird zudocker compose(durch Leerzeichen getrennt). Die Parameter der beiden sind genau gleich, es wird jedoch empfohlen, durchgängig das neue Format zu verwenden.
FAQ
F: Sind die Container nach dem Ausführen von down noch in Betrieb?
Möglicher Grund: Diese Container wurden nicht durch die aktuelle Compose-Datei erstellt, sondern überdocker rungestartet oder durch andere Compose-Dateien gestartet.
Verwenden Siedocker ps, um Containerdetails anzuzeigen und zu bestätigen, ob das Präfix des Containernamens mit dem Compose-Projektnamen übereinstimmt.
F: Speicherplatz nach down -v nicht freigegeben?
Prüfe, ob ungenutzte Images Speicherplatz belegen:
$ docker image ls # 查看镜像列表 $ docker image prune -a # 清理未使用的镜像
Docker räumt Images nicht automatisch auf; du musst manuelldocker image pruneausführen oderdown --rmiverwenden, um gemeinsam aufzuräumen.
F: Wie führt man down in einem Skript sicher aus?
Beispiel
# Sicheres Aufräumskript: zuerst prüfen, ob das Projekt läuft, dann down ausführen
PROJECT="/opt/example-app"
if [ -f "$PROJECT_DIR/docker-compose.yml" ]; then
cd "$PROJECT_DIR"
# Zuerst ps verwenden, um zu prüfen, ob laufende Dienste vorhanden sind
if docker compose ps -- running | grep -q .; dann
echo "Stoppe EXAMPLE-Projekt"
docker compose down --remove-orphans
echo "Bereinigung abgeschlossen"
else
echo "Projekt läuft nicht, Down-Vorgang wird übersprungen"
fi
else
echo "Fehler: docker-compose.yml-Datei nicht gefunden"
exit 1
fi
Dieses Skript führt grundlegende Pfadprüfungen und Zustandsprüfungen vor der Bereinigung durch, um versehentliche Operationen zu vermeiden.
Weitere Erweiterungen