docker compose down-Befehl

Docker-Befehlsreferenz


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:

Start node docker compose down Step 1: SIGTERM ① Send SIGTERM signal Send a stop signal to each container and wait for graceful exit Step 2: Timeout check Timeout? Default 10sBranch: Timeout Yes SIGKILL force killBranch: Normal exit No (normal exit)Step 3: Delete containers ② Delete all containers Remove all container instances defined in the Compose project Step 4: Delete networks ③ Delete project network Remove networks defined in docker-compose.yml (default networks + custom networks) Step 5: Optional operations ④ Optional: Delete data volumes (-v) / Delete images (--rmi) Only executed when the corresponding option is specified; retained by default End Project environment cleaned ✓

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:

OptionenAbkürzungBeschreibungStandardwert
--volumes-vLöscht benannte Daten-Volumes, die in der Compose-Datei definiert sind, sowie anonyme Daten-Volumes, die von Containern eingebunden sind.Nicht löschen
--remove-orphansKeineVerwaiste Container löschen, die Diensten entsprechen, die nicht mehr in der Compose-Datei vorhanden sind.Nicht löschen
--rmi <type>KeineLöscht die von Diensten verwendeten Images; Typ ist optional.all(Alle) oderlocal(nur lokal erstellt)Nicht löschen
--timeout-tTimeout (in Sekunden) zum Stoppen von Containern; nach dem Timeout zwangsweise beenden.10
--dry-runKeineNur 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 &lt;网络名&gt;  # 删除项目网络

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

# Inhalt der Datei docker-compose.yml
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

# docker-compose.yml
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

#!/bin/bash
# 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.


Docker-Befehlsreferenz

Weitere Erweiterungen