Docker ENTRYPOINT配置难题：如何兼顾Ctrl+C终止与命令行传参？

我完全懂你遇到的这个两难问题——既要让容器里的程序能响应Ctrl+C正常终止，又要能在docker run时灵活传递自定义参数，两种常见的ENTRYPOINT写法偏偏各踩一个坑。别慌，咱们可以通过**结合exec命令和参数占位符"$@"**来完美解决这个矛盾。

核心思路：让应用接管PID 1，同时保留参数传递能力 #

Docker的信号转发机制只会把信号发送给PID 1进程。如果用纯shell形式启动程序，shell会成为PID 1，可能不会把信号转发给子进程；如果用数组形式直接启动程序，程序成为PID 1，但部分脚本类程序可能没处理SIGINT信号导致Ctrl+C失效。而exec命令能替换当前shell进程，让你的程序直接成为PID 1，同时"$@"能原样传递所有外部参数，刚好补上两个写法的短板。

写法1：直接在ENTRYPOINT中组合实现

在Dockerfile里这么写：

ENTRYPOINT ["/bin/sh", "-c", "exec your_executable \"$@\""]
CMD ["default_arg1", "default_arg2"]

• 运行docker run your_image时，容器会执行exec your_executable default_arg1 default_arg2，用默认参数启动程序
• 需要传递自定义参数时，比如docker run your_image arg1 arg2，容器会执行exec your_executable arg1 arg2，参数完美传递
• exec替换了shell进程，让你的程序成为PID 1，Docker发送的SIGINT（Ctrl+C）会直接被程序接收，实现正常终止

写法2：用自定义entrypoint脚本（适合需要初始化操作的场景）

如果你的程序启动前需要做一些前置操作（比如环境变量配置、依赖检查），可以写一个专门的entrypoint脚本：

1. 先创建entrypoint.sh脚本：

#!/bin/sh
# 这里可以加初始化逻辑，比如配置环境变量、创建目录等
echo "Preparing to start application..."
# 用exec启动主程序，并传递所有外部参数
exec your_executable "$@"

2. 在Dockerfile中配置：

COPY entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/entrypoint.sh
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD ["default_arg"]

这种方式和第一种效果一致，但扩展性更强，能灵活添加启动前的准备工作。

为什么之前的写法有问题？ #

• ENTRYPOINT executable（纯shell形式）：Docker会自动转换成/bin/sh -c 'executable'，但这里没有参数占位符"$@"，所以docker run时传递的参数根本不会被传给executable，只能固定运行程序本身。
• ENTRYPOINT ["executable"]（数组形式）：程序直接作为PID 1运行，但如果是未处理SIGINT信号的脚本类程序，PID 1默认会忽略SIGINT和SIGTERM，导致Ctrl+C无法终止进程；而用exec的方式，既让程序成为PID 1，又通过shell的特性确保信号能被正常接收。

内容的提问来源于stack exchange，提问作者jshbrntt