执行 docker stop 时，Docker 先发 SIGTERM 给 PID 1 进程，10 秒后未退出则发 SIGKILL；要执行自定义清理，需确保 PID 1 能捕获 SIGTERM 并主动运行脚本，推荐用 tini 或 trap 封装的 entrypoint.sh 实现。
当执行 docker stop 时，Docker 会向容器主进程（PID 1）发送 SIGTERM 信号，等待默认 10 秒后若进程未退出，再发 SIGKILL 强制终止。要让容器在停止前执行自定义清理脚本，关键在于：容器内 PID 1 进程必须能捕获 SIGTERM 并主动调用清理逻辑，而不是直接忽略或被立即 kill。
确保主进程可捕获 SIGTERM
很多基础镜像（如官方 alpine、debian）的 shell 或简单命令（如 sleep infinity、tail -f /dev/null）无法正确转发或响应信号。若你用 CMD ["myapp"] 启动单个二进制，它必须自身支持处理 SIGTERM；否则需用一个能代理信号的启动脚本作为 PID 1。
- 推荐使用轻量级信号代理工具，如 tini（Docker 官方推荐），它会转发信号并支持预停止钩子
- 或自己写一个简单的 Bash wrapper 脚本，用
trap捕获SIGTERM，执行清理后再退出 - 避免使用
sh -c "cmd && wait"这类写法——sh不会将信号传给后台进程，导致清理不被执行
在容器内编写并注册清理脚本
把清理逻辑（如关闭连接、刷盘、删除临时文件、通知上游服务等）写成独立脚本（例如 /usr/local/bin/cleanup.sh），并赋予可执行权限：
#!/bin/sh echo "[INFO] Running cleanup..." rm -f /tmp/app.lock curl -X POST http://api.example.com/health?status=down 2>/dev/null || true sync echo "[INFO] Cleanup done."
然后在启动脚本中用 trap 注册：
#!/bin/sh trap "/usr/local/bin/cleanup.sh" TERM INT exec "$@" # 启动你的实际应用，保持为 PID 1
最后在 Dockerfile 中使用该脚本作为入口点：
COPY entrypoint.sh /entrypoint.sh RUN chmod +x /entrypoint.sh ENTRYPOINT ["/entrypoint.sh"] CMD ["your-app-binary", "--config", "/etc/app.conf"]
验证清理是否生效
不要仅依赖日志输出判断，因为 SIGKILL 会中断一切。可通过以下方式确认：
- 在清理脚本中写标记文件（如
touch /tmp/cleanup_ran），停容器后docker cp出来检查 - 用
docker stop --time=30 mycontainer延长超时时间，给清理留足时间 - 运行容器后手动测试：
docker kill -s TERM mycontainer，观察是否触发清理；再用docker logs mycontainer查看输出 - 避免在清理脚本中阻塞过久（如无 timeout 的网络请求），否则可能拖过 grace period 导致被强制终止
补充：使用 Docker Stop Hook（需宿主机支持）
Docker 本身不提供容器内“stop hook”机制，但 Linux 宿主机可通过 systemd 管理容器时，在 .service 文件中配置 ExecStopPre 执行宿主机侧清理（如清理共享卷、更新 registry 状态）。这属于编排层增强，不替代容器内信号处理。
