docker_practice/05_container/5.3_stop.md at 52f6c7347878ecf39000f48e2edb41d49a8e1932

mirror of https://github.com/yeasy/docker_practice.git synced 2026-08-10 08:27:25 +00:00

Files

T

yeasy 51698c89c5 fix(content): correct verified internal inconsistencies across 7 sections

均为书内自证的矛盾，无需外部来源：

- 19.3: golang:1.26-alpine 标注为 ~1GB，但 21.7 将 ~900MB 归给非 alpine 的
  golang:1.26，且 7.17 实测 alpine 版镜像为 295MB——alpine 变体不可能大于其
  非 alpine 版本。改为与 21.7 一致的「golang:1.26 基础镜像的 ~900MB」。
- 20_cases_os: 正文称通用镜像 100-300 MB，紧邻的表格却列 Ubuntu ~80 MB
  （与 4.2 的 ubuntu 24.04 78MB 一致）。正文改为 80-300 MB。
- 4.2: 「查找大于 500MB 的镜像」的 ^[0-9]+GB 不匹配小数，会漏掉 docker 实际
  输出的全部 x.yGB（本书自己的示例即为 2.5GB）。补充可选小数部分。
- 6.2: docker image ls 示例输出把 tag 混入 REPOSITORY 列
  （127.0.0.1:5000/ubuntu:latest + TAG latest），与同块 ubuntu/latest 行及
  本节自述的 tag 格式不符。
- 5.3: 生命周期状态图缺 Stopped --> Running，而 5.3.6 正是讲 docker start
  启动已停止的容器；原图中停止的容器只能被删除。
- 9.5: 端口映射图节点标签 "容器 (Class B: 80)" 语义错乱（Class B 是 IP 地址
  分类，与端口无关），改为「容器 (端口: 80)」。
- appendix/faq/errors.md: 标题「常见错误速查表」与 SUMMARY.md 及 faq/README
  两处链接文字「常见错误处理」不一致（全书 196 篇中唯一一处标题漂移）。

2026-07-16 23:20:25 -07:00

4.4 KiB

Raw Blame History

5.3 终止

本节将介绍如何终止一个运行中的容器，以及几种不同的终止方式及其区别。

5.3.1 终止方式概述

终止容器有三种方式：

方式	命令	说明
优雅停止	`docker stop`	先发 SIGTERM，超时后发 SIGKILL
强制停止	`docker kill`	直接发 SIGKILL
自动终止	-	容器主进程退出时自动停止

5.3.2 docker stop：推荐

docker stop 基本用法

$ docker stop 容器名或ID

工作原理

flowchart TD
    cmd["docker stop mycontainer"] --> A["1. 发送 SIGTERM 信号给容器主进程 (PID 1)"]
    A --> B["2. 等待容器优雅退出 (默认 10 秒)"]
    B --> C["3. 如果超时仍未退出，发送 SIGKILL 强制终止"]

自定义超时时间

## 等待 30 秒后强制终止

$ docker stop -t 30 mycontainer

## 立即发送 SIGKILL（相当于 docker kill）

$ docker stop -t 0 mycontainer

停止多个容器

## 停止多个指定容器

$ docker stop container1 container2 container3

## 停止所有运行中的容器

$ docker stop $(docker ps -q)

5.3.3 docker kill

基本用法

$ docker kill 容器名或ID

与 stop 的区别

命令	信号	使用场景
`docker stop`	SIGTERM → SIGKILL	正常停止，让应用优雅退出
`docker kill`	SIGKILL	应用无响应，强制终止

发送自定义信号

## 发送 SIGHUP（让进程重新加载配置）

$ docker kill -s HUP mycontainer

## 发送 SIGTERM

$ docker kill -s TERM mycontainer

5.3.4 容器自动终止

容器的生命周期与主进程绑定。主进程退出时，容器自动停止：

## 主进程是交互式 bash

$ docker run -it ubuntu bash
root@abc123:/# exit    # 退出 bash → 容器停止

## 主进程执行完毕

$ docker run ubuntu echo "Hello"    # echo 执行完 → 容器停止

5.3.5 查看已停止的容器

$ docker ps -a
CONTAINER ID   IMAGE    COMMAND       STATUS                      NAMES
ba267838cc1b   ubuntu   "/bin/bash"   Exited (0) 2 minutes ago    myubuntu
c5d3a5e8f7b2   nginx    "nginx"       Up 5 minutes                mynginx

STATUS 字段说明：

状态	说明
`Up X minutes`	运行中
`Exited (0)`	正常退出 (退出码 0)
`Exited (1)`	异常退出 (非零退出码)
`Exited (137)`	被 SIGKILL 终止 (128 + 9)
`Exited (143)`	被 SIGTERM 终止 (128 + 15)

5.3.6 重新启动容器

启动已停止的容器

$ docker start 容器名或ID

## 启动并附加终端

$ docker start -ai 容器名

重启运行中的容器

## 先停止再启动

$ docker restart 容器名

## 自定义停止超时

$ docker restart -t 30 容器名

5.3.7 生命周期状态图

stateDiagram-v2
    direction TB
    [*] --> Created : docker create
    Created --> Running : docker start
    Running --> Stopped : docker stop
    Stopped --> Running : docker start
    Running --> Paused : docker pause
    Paused --> Running : docker unpause

    Created --> Deleted : docker rm
    Stopped --> Deleted : docker rm
    Paused --> Deleted : docker rm

    Deleted --> [*]

5.3.8 批量操作

停止所有容器

$ docker stop $(docker ps -q)

删除所有已停止的容器

$ docker container prune

停止并删除所有容器

$ docker stop $(docker ps -q) && docker container prune -f

5.3.9 常见问题

Q：容器停止很慢

原因：应用没有正确处理 SIGTERM 信号，需要等待超时后强制终止。

解决方案：

在应用中正确处理 SIGTERM
使用 docker stop -t 0 立即终止
检查 Dockerfile 中的 STOPSIGNAL 配置

Q：如何让容器优雅退出

确保容器主进程正确处理信号：

## Dockerfile 示例

FROM node:22-alpine
...

## 使用 exec 形式确保信号能传递给 node 进程

CMD ["node", "server.js"]

版本说明：示例使用 node:22-alpine，这是一个精简的 Node.js 22 版本镜像。可根据需求替换为其他版本（如 node:24-alpine、node:latest）。

Q：容器无法停止

## 强制终止

$ docker kill 容器名

## 如果仍无法停止，检查系统资源

$ docker inspect 容器名

4.4 KiB Raw Blame History Unescape Escape