Docker CMD 和 ENTRYPOINT 有什么区别？怎么选？

Question

仓乃文 · Accepted Answer

CMD 和 ENTRYPOINT 都用来指定容器启动时执行的命令，但行为差异很大。初学者常混淆两者，导致容器启动行为不符合预期。核心区别：CMD 可以被 docker run 的参数覆盖，ENTRYPOINT 不会被覆盖（除非用 --entrypoint）。

对比表：
```
| 维度           | CMD                    | ENTRYPOINT              |
|---------------|------------------------|------------------------|
| 是否可被覆盖    | docker run 参数直接覆盖  | 需要 --entrypoint 才能覆盖 |
| 多个指令       | 只有最后一个生效         | 只有最后一个生效         |
| 常见用途       | 默认命令+默认参数        | 固定命令+可变参数        |
| 配合使用       | 给 ENTRYPOINT 传默认参数 | 接收 CMD 作为默认参数    |
```

用法示例：
```dockerfile
# 用法 1：只用 CMD（最常见）
FROM node:18-alpine
CMD ["node", "server.js"]
# docker run myapp                    → 执行 node server.js
# docker run myapp node debug.js      → 执行 node debug.js（CMD 被覆盖）

# 用法 2：只用 ENTRYPOINT
FROM python:3.10-slim
ENTRYPOINT ["python"]
# docker run myapp main.py            → 执行 python main.py
# docker run myapp debug.py            → 执行 python debug.py
# 参数追加，不是覆盖！

# 用法 3：ENTRYPOINT + CMD 配合（推荐）
FROM python:3.10-slim
ENTRYPOINT ["python"]
CMD ["main.py"]
# docker run myapp                    → 执行 python main.py（CMD 作为默认参数）
# docker run myapp debug.py           → 执行 python debug.py（覆盖 CMD）
# docker run --entrypoint sh myapp    → 执行 sh（覆盖 ENTRYPOINT）
```

Shell 格式 vs Exec 格式：
```dockerfile
# Shell 格式（不推荐）
CMD node server.js
# 会被解析为 /bin/sh -c "node server.js"
# PID 1 是 /bin/sh 而不是 node，收不到 SIGTERM 信号
# docker stop 时需要等 10 秒超时才能停止

# Exec 格式（推荐）
CMD ["node", "server.js"]
# PID 1 是 node，能正确接收 SIGTERM 信号
# docker stop 时优雅退出
```

常见坑：
```dockerfile
# 坑 1：ENTRYPOINT 用 shell 格式，CMD 不会作为参数
ENTRYPOINT python app.py
CMD ["--help"]
# 实际执行：/bin/sh -c "python app.py"，--help 被忽略

# 坑 2：同时写多个 CMD
CMD ["npm", "install"]
CMD ["npm", "start"]
# 只有最后一个 CMD 生效，npm install 不会执行
# 应该用 RUN npm install

# 坑 3：ENTRYPOINT 写了 shell 命令但忘了中括号
ENTRYPOINT echo "hello"
# 等价于 /bin/sh -c "echo hello"
# 无法接收 CMD 参数
```

选择建议：
```
- 通用应用（Web 服务、API）：用 CMD
- 工具类镜像（CLI 工具、脚本入口）：用 ENTRYPOINT + CMD
- 需要固定命令但允许传参：ENTRYPOINT + CMD
- 规则：不确定就用 CMD，需要固定入口再用 ENTRYPOINT
```