讲师中心 微信公众号
AI工具推荐 视频效率加速

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

酷杰大大_4696

酷杰大大_4696

发布时间:2026-10-25 07:59:04

|

365人浏览过

|

来源于php中文网

原创

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'

热门AI工具

更多
UP简历
UP简历 Hot

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

WorkBuddy

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

豆包大模型

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

火山引擎

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

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

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

蛙蛙写作

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
string转int
string转int

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

6579

2023.08.02

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

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

3185

2024.08.29

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

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

4128

2025.08.29

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

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

2825

2025.08.29

k8s和docker区别
k8s和docker区别

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

745

2023.07.24

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

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

5839

2024.04.08

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

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

6897

2024.04.08

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

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

2693

2024.04.08

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

20

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

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

共0课时 | 0人学习

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

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