Docker ENTRYPOINT 脚本通过可执行脚本（如 entrypoint.sh）在容器启动时执行配置校验、依赖等待、权限初始化等预处理，最后用 exec "$@" 交由 CMD 启动主进程，确保 PID 1 正确并接收信号。
通过 Docker 的 ENTRYPOINT 脚本实现容器启动时的动态预处理，核心在于用可执行脚本替代直接运行主进程，让容器在真正启动服务前完成配置生成、权限校验、依赖等待、环境适配等操作。
编写可执行的 Entrypoint 脚本
脚本需具备可执行权限（chmod +x），通常使用 #!/bin/sh 或 #!/bin/bash 开头。它不直接启动应用，而是先完成预处理逻辑，最后用 exec "$@" 将控制权交给 CMD 或用户传入的命令。
- 把脚本放入镜像（如 COPY entrypoint.sh /usr/local/bin/entrypoint.sh）
- 在 Dockerfile 中声明：
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"] - CMD 保持应用启动命令，例如：
CMD ["node", "app.js"]
常见预处理场景与实现方式
脚本中可嵌入多种轻量级检查和初始化逻辑，无需额外工具依赖：
-
环境变量校验：检查必要变量是否设置，缺失则报错退出（
if [ -z "$DB_HOST" ]; then echo "ERROR: DB_HOST required"; exit 1; fi） -
配置文件渲染：用
envsubst替换模板中的变量（需提前安装或用纯 shell 替代方案），或将变量写入配置文件 -
服务依赖等待：用
nc -z $DB_HOST $DB_PORT或curl -f http://api:8080/health循环检测，超时失败 -
目录/权限初始化：创建挂载点目录、修正日志路径权限（
chown -R appuser:appgroup /var/log/myapp）
保持容器信号传递与 PID 1 行为正确
关键细节在于最后一行必须用 exec "$@"，而非 "$@" 或 sh -c "$@"：
-
exec确保主进程成为 PID 1，能正常接收SIGTERM等信号 -
"$@"会启动子 shell，导致信号无法透传，容器docker stop可能超时或强制 kill - 若需前置后台任务（如日志轮转守护），应确保其不阻塞主进程，且不抢占 PID 1
调试与验证技巧
预处理逻辑出错会导致容器立即退出，排查时可临时修改 ENTRYPOINT 进入交互模式：
- 构建时加调试语句：
set -x显示每条命令执行过程 - 运行时覆盖 ENTRYPOINT：
docker run --rm -it --entrypoint sh myimage -c 'ls -l /app && env' - 检查容器日志：
docker logs查看脚本输出和错误信息
