规范 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)
