规范 docker 启动脚本需解耦启动逻辑与运行时配置，用 entrypoint 封装初始化流程（如环境校验、服务等待），cmd 仅传参；支持健康检查、调试模式和前台运行，并配套标准化 docker run 命令。

在复杂项目中编写规范的 docker 启动脚本，核心是把“启动逻辑”和“运行时配置”解耦，确保可复用、可调试、可运维。不靠硬编码，也不依赖宿主机环境，所有行为都收敛到容器内部可控路径。

用 ENTRYPOINT 封装初始化流程

这是最推荐的方式，适合含多步检查、配置生成、依赖等待的场景：

• 写一个 /entrypoint.sh，开头必须是 #!/bin/sh，结尾必须是 exec "$@"（保证主进程为 PID 1，能接收 SIGTERM）
• 脚本内可做：读取环境变量动态替换配置、校验必要参数、用 until nc -z $DB_HOST $DB_PORT; do sleep 2; done 等待下游服务就绪、生成密钥或日志目录
• Dockerfile 中明确 COPY 并赋予执行权限：
  

  COPY entrypoint.sh /entrypoint.sh<br>RUN chmod +x /entrypoint.sh<br>ENTRYPOINT ["/entrypoint.sh"]

用 CMD 提供默认运行参数，不写具体命令

CMD 应该只承担“参数传递”角色，不是执行主体：

OpenClaw Docker Setup

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

下载

• 推荐写法：CMD ["--port=3000", "--log-level=info"]（数组格式）
• 避免写 CMD npm start 这类完整命令——它会覆盖 ENTRYPOINT，失去初始化能力
• 这样 docker run myapp --port=4000 --debug 就能自然传参给入口程序，比如 node app.js --port=4000 --debug

启动脚本需支持快速验证与降级

生产级脚本不能“一跑就黑”，要留出可观测和干预通道：

• 加简单健康检查：脚本开头检测关键环境变量是否为空，缺失则 echo "ERROR: missing ENVIRONMENT" && exit 1
• 提供调试模式：比如当 DEBUG=1 时，跳过等待逻辑、打印详细步骤、不 exec 而是 sleep infinity 挂起，方便进容器排查
• 避免后台化：所有服务必须前台运行，禁止 service nginx start & 或 nohup ./app &，否则容器立即退出

配套 docker run 命令也要标准化

脚本再规范，启动命令乱套也会失效。建议固定常用参数组合：

• 强制后台与自愈：--restart=unless-stopped
• 绑定资源防失控：--memory=512m --cpus=1.0
• 挂载日志与配置：-v /data/app/logs:/app/logs -v /etc/app/conf.yml:/app/conf.yml:ro
• 注入元信息：-e POD_NAME=$HOSTNAME -e START_TIME=$(date -u +%Y-%m-%dT%H:%M:%SZ)