docker stop 默认优雅停止容器,通过发送 sigterm 信号让主进程处理清理后退出;若超时(默认10秒)则发 sigkill 强杀,需确保 pid 1 进程能接收并响应 sigterm。

使用 docker stop 优雅停止容器,核心是让容器内主进程收到 SIGTERM 信号并有机会完成清理(如保存状态、关闭连接),而不是直接被 SIGKILL 强杀。默认情况下 docker stop 就是“优雅”的,但需确保镜像和应用本身支持该机制。
确认容器支持优雅停止
不是所有容器都能真正优雅退出。关键看两点:
- 容器的 主进程(PID 1)必须能接收并处理
SIGTERM—— 比如 Node.js、Python Flask、Nginx 等主流服务默认支持;而直接运行sleep infinity或未做信号处理的 shell 脚本则不会响应。 - Dockerfile 中推荐使用
exec形式启动(如exec "$@"),避免因 shell 进程作为 PID 1 导致信号无法传递到真正应用。
基本停止命令与超时控制
执行以下命令即可触发优雅停止流程:
docker stop默认等待 10 秒,若容器未自行退出,则发送 SIGKILL 强制终止。如需调整等待时间(例如给数据库留更长的刷盘时间):
单位为秒,建议根据应用实际关机耗时设定,避免过短导致强杀,或过长拖慢部署流程。
验证是否真正优雅退出
停止后可检查容器退出码和日志,判断是否正常收尾:
- 运行
docker ps -a查看 STATUS 列,显示Exited (0)通常表示主进程正常退出;非零退出码(如 137)往往意味着被SIGKILL终止(可能超时了)。 - 用
docker logs <container></container>查看最后几行,寻找类似shutting down...、gracefully stopping、received SIGTERM的日志,说明应用已响应信号。
批量停止与脚本化建议
生产中常需停止多个相关容器(如一个 compose 服务组),推荐方式:
- 使用
docker-compose stop(对应docker-compose.yml中定义的服务),它会按依赖顺序发送SIGTERM,并默认等待 10 秒。 - 如需自定义批量操作,可用
docker stop $(docker ps -q --filter "label=com.docker.compose.project=myapp"),配合 label 精准筛选,避免误停。 - 不建议用
docker kill替代stop,除非明确需要立即强杀(如进程僵死)。










