首页/云/Docker 容器速查/compose 停服信号与宽限期
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose 停服信号与宽限期

控制停容器时发送的信号与等待时长:配置 stop_signal 与 stop_grace_period,让应用有机会优雅退出、完成在途请求。

Docker 容器速查云更新于 2026-10-12
字段stop_signal(如 SIGTERM/SIGINT)/ stop_grace_period(如 30s)
默认SIGTERM + 10 秒
超时后SIGKILL 强杀

示例

示例
services:
  api:
    image: app/api:1.4.2
    stop_signal: SIGTERM
    stop_grace_period: 30s
docker compose stop api
应用需要额外时间落盘或注销注册中心时调大宽限期;SIGKILL 收尾会跳过清理逻辑。

易错点

  • grace 太小等于直接砍掉优雅退出逻辑,长事务服务务必实测停服耗时
  • 应用若吞掉 SIGTERM 不退出,最终仍会被 SIGKILL,信号处理要写进应用代码

数据来源与参考

  • Docker 官方文档:Compose stop_signal 与 stop_grace_period(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌