docker 本身不提供原生 poststart/prestop 钩子，但可通过自定义 entrypoint 脚本实现启动前初始化、healthcheck 指令模拟探针、信号捕获（trap term）实现终止前清理，以及外部事件监听或 ci/cd 协同完成等效钩子功能。

Docker 本身不提供像 Kubernetes 那样的原生 postStart 或 preStop 钩子，但可以通过几种成熟、轻量、可落地的方式，在关键生命周期节点执行自定义逻辑。核心原则是：把钩子逻辑“嵌入”到容器启动和退出流程中，而不是等待 Docker 主动回调。

启动前做初始化（类 pre-start）

这是最常用也最可靠的钩子场景。目标是在主应用进程启动前，完成配置准备、依赖探活、目录创建等操作。

• 用 ENTRYPOINT 指向一个 shell 脚本（如 entrypoint.sh），脚本里先执行初始化逻辑，再用 exec "$@" 启动原始 CMD
• 初始化内容常见包括：
  • 创建 /config /log 等持久化目录
  • 生成 machine-id 或密钥文件
  • 等待数据库、Redis 等依赖服务就绪（例如 while ! nc -z db 5432; do sleep 1; done）
  • 渲染配置模板（如用 envsubst 替换环境变量）
• 注意：脚本末尾必须用 exec，否则主进程变成子进程，容器可能提前退出

运行中做健康判断（类 liveness/readiness）

Docker 没有内置探针，但可通过 HEALTHCHECK 指令实现等效效果：

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

• 在 Dockerfile 中添加：

  HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
    CMD curl -f http://localhost:8080/health || exit 1

• 容器运行后，Docker 引擎会定期执行该命令，并更新 docker inspect <name> --format='{{.State.Health.Status}}'</name> 的结果
• 应用内需暴露 /health 端点，返回 HTTP 200 表示就绪；也可用 tcp-connect 或 pg_isready 等命令替代

终止前做清理（类 pre-stop）

关键在于捕获 SIGTERM 并阻塞退出，直到清理完成：

• 在 entrypoint.sh 或应用代码中设置信号处理器：

  cleanup() {
    echo "Shutting down gracefully..."
    # 关闭连接、刷盘、上报状态等
    exit 0
  }
  trap cleanup TERM INT

• 主进程必须前台运行（不能加 & 或 nohup），否则信号无法送达
• 清理逻辑别超时——Docker 默认 10 秒后强制 SIGKILL，所以耗时操作建议异步触发+快速返回

外部协同式钩子（适合编排或运维场景）

当单容器内逻辑太重或需跨容器联动时，可借助外部机制：

• 用 docker events --filter 'event=start' --filter 'event=stop' 监听事件，配合脚本触发备份、告警、注册注销等
• 在 CI/CD 流水线中，docker run 前后插入 shell 步骤，比如启动前 dump 数据库、停止后推送日志
• Docker Compose 支持 on-create、pre-start、post-start 等钩子（通过 x-harness 或第三方插件），适合多服务协同初始化

不复杂但容易忽略