ENTRYPOINT 实现参数化 CLI 工具，主命令固定（如 ["curl", "-m", "10"]），CMD 仅提供默认参数（如 ["https://httpbin.org/get"]），运行时传参可覆盖 CMD；推荐 exec 形式以支持信号传递和参数透传。

Dockerfile 中的 ENTRYPOINT 是实现参数化命令行工具的关键，它能让容器像本地可执行程序一样被调用，同时支持传入动态参数。

ENTRYPOINT 与 CMD 的协作机制

ENTRYPOINT 定义容器启动时**始终执行的主命令**，而 CMD 提供其**默认参数**。当运行容器时传入参数（如 docker run mytool --help），这些参数会追加到 ENTRYPOINT 后面，覆盖 CMD 的默认值。

• 推荐使用 exec 形式： ENTRYPOINT ["node", "app.js"]，避免 shell 解析带来的变量和信号问题
• CMD 应只写参数，例如 CMD ["--port", "3000"]，不写命令本身
• 若用 shell 形式（ENTRYPOINT node app.js），则无法接收外部参数——它会被整个当作 shell 命令执行，忽略后续参数

构建一个可复用的 CLI 工具镜像

以封装 curl 为例，制作一个带预设超时和 User-Agent 的 HTTP 工具：

FROM curlimages/curl:8.9.1
ENTRYPOINT ["curl", "-m", "10", "-A", "my-cli/1.0"]
CMD ["https://httpbin.org/get"]

构建后可直接使用：

• docker run http-tool https://example.com → 使用自定义 URL 替换默认地址
• docker run http-tool -I https://example.com → 加入 -I 参数获取响应头
• docker run --rm -v $(pwd):/data http-tool -o /data/out.html https://example.com → 结合挂载和额外选项

支持多子命令的进阶用法

当工具需支持类似 git commit、git push 的子命令时，可将入口设为包装脚本：

COPY entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/entrypoint.sh
ENTRYPOINT ["entrypoint.sh"]

entrypoint.sh 内容示例：

#!/bin/sh
case "$1" in
  fetch) exec git fetch "$@" ;;
  log)   exec git log --oneline "$@" ;;
  *)     exec git "$@" ;;
esac

• 用 exec 替换当前 shell 进程，确保信号（如 Ctrl+C）能正确传递给子命令
• 保持参数透传，用户操作体验与原生 CLI 一致
• 适合封装 git、jq、ffmpeg 等已有工具，添加默认配置或权限控制

调试与验证技巧

确认 ENTRYPOINT 行为是否符合预期：

• 用 docker inspect myimage | jq '.[0].Config.Entrypoint' 查看解析后的入口数组
• 临时绕过 ENTRYPOINT： docker run --entrypoint sh myimage -c 'echo $0 $@' arg1 arg2
• 在容器内执行 ps aux，观察实际启动的进程是否为预期命令（而非 /bin/sh）