ENTRYPOINT 和 CMD 有什么区别？

Question

Accepted Answer

**ENTRYPOINT** 和 **CMD** 都定义了容器启动时运行的内容，但它们扮演不同的角色并以特定方式交互。理解它们的区别（以及两种形式——exec 与 shell）对于编写表现正确的 Dockerfile 很重要。

## CMD — 默认命令（可被覆盖）

```dockerfile
CMD ["node", "server.js"]
# → the DEFAULT command when the container starts
# → but it's REPLACED if you pass a command at run time:
#   docker run myapp echo hello   → runs "echo hello" INSTEAD of node server.js
```

`CMD` 提供**默认命令**，该命令会被 `docker run` 中指定的任何命令**完全覆盖**。

## ENTRYPOINT — 固定的可执行文件

```dockerfile
ENTRYPOINT ["node", "server.js"]
# → ALWAYS runs; run-time arguments are APPENDED (not replacing it):
#   docker run myapp --port 8080   → runs "node server.js --port 8080"
# → makes the container behave like a specific executable
```

`ENTRYPOINT` 设置一个**固定的可执行文件**，它总是运行；运行时参数**附加**到它而不是替换它。

## 将它们一起使用（常见模式）

```dockerfile
ENTRYPOINT ["node", "server.js"]   # the fixed command
CMD ["--port", "3000"]              # DEFAULT arguments (overridable)
# docker run myapp                  → node server.js --port 3000 (defaults)
# docker run myapp --port 8080      → node server.js --port 8080 (CMD overridden)
→ ENTRYPOINT = the command; CMD = default arguments you can override. A clean pattern.
```

## Exec 形式与 shell 形式

```text
EXEC form  → CMD ["node", "server.js"]  (JSON array) — PREFERRED:
  runs the executable DIRECTLY (PID 1) → receives signals (SIGTERM) → graceful shutdown
SHELL form → CMD node server.js  → runs via /bin/sh -c → the shell is PID 1,
  the app may NOT receive signals properly (shutdown issues) → avoid for the main process
```

## 为什么这很重要

理解 ENTRYPOINT 和 CMD 之间的区别对于**编写表现正确的 Dockerfile** 很重要，因此这是有价值的实用知识，也是一个常见的易混淆的主题。

行为差异很重要：**CMD** 提供一个默认命令，该命令会被传递给 `docker run` 的任何命令**完全覆盖**，而 **ENTRYPOINT** 设置一个固定的可执行文件，它总是运行且运行时参数**附加**到它——不同的行为影响容器如何响应运行时参数。

理解**将它们一起使用的常见模式**（`ENTRYPOINT` 作为命令，`CMD` 作为可覆盖的默认参数）是一种干净、符合惯用法的方法，使容器表现得像可配置的可执行文件——这是一种广泛使用的技术，值得了解。

至关重要的是，理解 **exec 形式与 shell 形式**对于正确性很重要：**exec 形式**（JSON 数组，例如 `CMD ["node", "server.js"]`）是更优选的，因为它将可执行文件**直接作为 PID 1 运行**，这样它**能正确接收 SIGTERM 等信号**，实现**优雅关闭**——而 **shell 形式**（`CMD node server.js`）通过 shell 运行，shell 成为 PID 1，常常导致应用程序**无法正确接收关闭信号**（导致粗暴终止、流程中的工作丢失或停止缓慢）。

这种信号处理/优雅关闭问题是一个真实的、微妙的问题，exec 形式可以避免。

由于定义容器启动时运行的内容是每个 Dockerfile 的基础，而且由于 ENTRYPOINT/CMD 的区别（以及 exec 与 shell 形式的信号处理问题）直接影响容器的行为和正确性（参数处理、优雅关闭），理解 ENTRYPOINT 与 CMD——它们的角色、如何组合以及重要的信号处理 exec 形式实践——是有价值的、实用相关的 Docker 知识，是一个常被误解的主题，其中理解这些区别能防止真实的行为和关闭问题。