Docker 的 CMD 与 ENTRYPOINT 怎么配合设置启动命令

酷杰大大_4696

酷杰大大_4696

2026-10-25

365人浏览

原创

entrypoint定义主程序,cmd提供默认参数,二者须用exec格式(json数组)才能正确拼接、传参和响应信号;entrypoint是固定外壳,cmd是可替换内芯,运行时新命令仅覆盖cmd。

核心就一条:entrypoint 定义主程序,cmd 提供它的默认参数。两者必须都用 exec 形式(也就是 json 数组写法),才能正确拼接、传递参数、响应信号。

ENTRYPOINT 是“固定外壳”,CMD 是“可换内芯”

容器启动时,真正执行的是 ENTRYPOINT + CMD 的组合。如果运行时传入新命令,CMD 被完全替换,但 ENTRYPOINT 始终不变。

  • 写法示例:ENTRYPOINT ["node", "server.js"] + CMD ["--port", "3000"] → 启动时执行 node server.js --port 3000
  • 运行时覆盖:docker run myimg --port 8080 --env=prod → 实际执行 node server.js --port 8080 --env=prod,原 CMD 被丢弃
  • 如果只写 CMD,没写 ENTRYPOINT,那 CMD 就是完整命令,运行时参数会直接覆盖整条 CMD

必须用 exec 形式,shell 形式会出问题

shell 形式(比如 ENTRYPOINT nginx -g "daemon off;")会启动一个 /bin/sh 进程来包裹命令,导致 PID 1 不是 nginx,信号(如 SIGTERM)无法正确传给主服务,容器可能无法优雅退出。

Docker Encyclopedia
Docker Encyclopedia

Docker 文档优先工作流:针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载
  • ✅ 正确:ENTRYPOINT ["nginx", "-g"] + CMD ["daemon off;"]
  • ❌ 危险:ENTRYPOINT nginx -g "daemon off;" —— 此时 CMD 会被忽略,且 nginx 不在 PID 1
  • exec 形式不经过 shell,环境变量不会自动展开,如需变量,应在脚本里处理,或改用入口脚本

推荐做法:用入口脚本统一收口

把复杂逻辑(比如配置生成、权限检查、环境适配)放进一个可执行脚本,再让 ENTRYPOINT 调它,CMD 传业务参数。

  • 镜像中包含 entrypoint.sh,开头加 #!/bin/sh,并 chmod +x
  • Dockerfile 写:ENTRYPOINT ["./entrypoint.sh"] + CMD ["start"]
  • 脚本末尾用 exec "$@" 安全转发命令,既支持 docker run myimg,也支持 docker run myimg sh 调试
  • 这样既能保证主进程是 PID 1,又能灵活扩展启动逻辑

调试与临时接管技巧

容器起不来?别急着改镜像,先用运行时参数快速验证。

  • 跳过原有 ENTRYPOINT:docker run -it --entrypoint /bin/sh myimg,直接进 shell 查文件、看日志、手动执行启动命令
  • 只换 CMD 参数:docker run myimg --help,适合 CLI 类镜像
  • 检查最终生效配置:docker inspect myimg | grep -A 5 'Entrypoint\|Cmd'

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

docker

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6599

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

3205

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

4128

10

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.29

2825

10

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

745

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5859

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6917

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2693

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

299

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习