Dockerfile中ENTRYPOINT搭配CMD导致Node.js应用未启动的问题

这是典型的Docker ENTRYPOINT 和 CMD 配合使用时的误区，我来帮你拆解问题并给出可行的解决办法：

为什么你的Node.js应用没启动？ #

你当前的Dockerfile中，ENTRYPOINT 使用了exec数组格式（["geth", "--raft", "--raftjoinexisting", "1"]），而 CMD 是字符串格式的 "node watcher.js"。在Docker的规则里，当ENTRYPOINT是exec数组时，CMD的内容会被当作ENTRYPOINT命令的参数，而不是独立运行的命令。

所以实际执行的命令是：

geth --raft --raftjoinexisting 1 /bin/sh -c "node watcher.js"

这就导致geth把node watcher.js当成了自身的启动参数，而非启动一个独立的Node进程，自然看不到Node应用运行。

几种可行的解决方案 #

方案1：使用启动脚本（推荐，灵活易维护）

创建一个start.sh启动脚本，同时管理两个进程并保证容器前台运行：

#!/bin/sh

# 后台启动geth并记录PID
geth --raft --raftjoinexisting 1 &
GETH_PID=$!

# 前台启动Node应用（保证容器不退出）
node watcher.js

# 等待geth进程，避免Node退出后容器直接关闭
wait $GETH_PID

然后修改Dockerfile：

FROM quorumengineering/quorum:latest
RUN apk add nodejs npm
# 合并npm安装命令，减少镜像层
RUN cd ~ && npm i axios
COPY watcher.js .
COPY start.sh .
# 给脚本添加执行权限
RUN chmod +x start.sh
# 用启动脚本作为ENTRYPOINT
ENTRYPOINT [ "./start.sh" ]

方案2：使用进程管理工具（适合多进程复杂场景）

用supervisor来统一管理两个进程，支持自动重启、日志聚合等功能：

1. 创建supervisord.conf配置文件：

[supervisord]
nodaemon=true  # 让supervisor前台运行，保持容器存活

[program:geth]
command=geth --raft --raftjoinexisting 1
autostart=true
autorestart=true

[program:watcher]
command=node watcher.js
autostart=true
autorestart=true

2. 修改Dockerfile：

FROM quorumengineering/quorum:latest
RUN apk add nodejs npm supervisor
RUN cd ~ && npm i axios
COPY watcher.js .
COPY supervisord.conf /etc/supervisord.conf
ENTRYPOINT [ "supervisord", "-c", "/etc/supervisord.conf" ]

方案3：直接用shell命令合并（快速简单，适合测试场景）

把两个命令合并到ENTRYPOINT中，用&后台运行geth，再通过wait保持容器存活：

FROM quorumengineering/quorum:latest
RUN apk add nodejs npm
RUN cd ~ && npm i axios
COPY watcher.js .
ENTRYPOINT [ "/bin/sh", "-c", "geth --raft --raftjoinexisting 1 & node watcher.js; wait" ]

关键提醒 #

Docker容器会在前台进程退出时立刻停止，所以无论用哪种方案，都要保证至少有一个进程处于前台运行状态，否则容器会启动后马上退出。

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