讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Docker镜像配置Entrypoint与Cmd差异对比

星涛吖_8427

星涛吖_8427

发布时间:2026-03-29 16:03:36

|

819人浏览过

|

来源于php中文网

原创

ENTRYPOINT 是容器主程序,CMD 是其默认参数;二者共存时,运行时参数覆盖 CMD 并追加至 ENTRYPOINT;推荐 exec 形式以确保 PID 1 和信号正常传递。

docker镜像配置entrypoint与cmd差异对比

ENTRYPOINT 和 CMD 都是定义容器启动行为的指令,但角色完全不同:ENTRYPOINT 是“主程序”,CMD 是“默认参数”。理解这个分工,就能避免镜像启动失败或参数被意外丢弃的问题。

职责定位不同

ENTRYPOINT 指定容器必须运行的可执行文件,比如 /app/server 或 nginx。它让镜像表现得像一个独立命令,不可跳过(除非用 --entrypoint 强制覆盖)。
CMD 则只提供参数,默认值,比如 --port 8080 或 start。当没有 ENTRYPOINT 时,CMD 才会作为主命令执行;一旦设了 ENTRYPOINT,CMD 就自动降级为它的默认参数。

运行时参数如何传递

使用 docker run myimage arg1 arg2 时:

  • 仅含 CMD:整个 CMD 被完全替换,原命令丢失
  • 仅含 ENTRYPOINT:arg1 arg2 会追加到 ENTRYPOINT 后面,组成完整命令
  • 两者共存:ENTRYPOINT 固定,CMD 作为初始参数;运行时传入的参数会覆盖 CMD,但继续传给 ENTRYPOINT

例如:

ENTRYPOINT ["curl"]<br>CMD ["-I", "https://example.com"]

执行 docker run myimage https://google.com → 实际运行 curl https://google.com。

语法与信号处理建议

两者都支持 shell 形式(如 CMD echo hello)和 exec 形式(如 CMD ["echo", "hello"]),但强烈推荐后者:

  • exec 形式让进程直接成为 PID 1,能正常接收 SIGTERM 等信号,支持优雅退出
  • shell 形式会多一层 /bin/sh -c 包装,导致信号无法透传,容器可能无法被 docker stop 正常终止
  • exec 形式中环境变量不会自动展开(如 $HOME),需在脚本内处理或改用 ENV + SHELL 配合

典型误用与修正方式

常见错误是把主程序写进 CMD:

  • ❌ 错误写法:CMD ["nginx", "-g", "daemon off;"] → 运行 docker run img bash 时,Nginx 根本不启动
  • ✅ 正确写法:
    ENTRYPOINT ["nginx", "-g", "daemon off;"]<br>CMD []
    → 主进程锁定,调试时可灵活加参数,如 docker run img -t
  • ✅ 更实用组合:
    ENTRYPOINT ["/entrypoint.sh"]<br>CMD ["--config", "/etc/app.yaml"]
    → 用 shell 脚本封装初始化逻辑,CMD 提供可调配置

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

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4127

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

6985

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1516

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3998

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

557

2026.01.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn