首页/云/Docker 容器速查/ENTRYPOINT 固定入口点
镜像与构建107 条

ENTRYPOINT 固定入口点

把镜像固定成某个可执行程序:docker run 追加的命令行参数会附加到 ENTRYPOINT 之后,适合做 CLI 型镜像。

Docker 容器速查云更新于 2026-10-12
用途固定容器入口程序
语法ENTRYPOINT ["/app/server", "--port", "8080"](exec 形式)
参数传递run 追加参数附加在 entrypoint 之后

示例

示例
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD ["nginx", "-g", "daemon off;"]

# 临时覆盖入口调试
docker run --rm --entrypoint /bin/sh app/web:1.0
推荐 exec 形式:参数透传与信号处理都更可控;需要 shell 变量时显式写 ["/bin/sh", "-c", "..."]。

易错点

  • shell 形式的 ENTRYPOINT 会忽略 run 追加的参数与 CMD(被当作 shell 命令串处理),参数完全传不进去
  • entrypoint 脚本里启动服务要带 exec(如 exec "$@"),否则信号到不了服务进程

数据来源与参考

  • Docker 官方文档:Dockerfile ENTRYPOINT(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌