NGINX Docker容器启动时Nginx前台运行致后续命令失效的问题

问题核心 #

nginx -g 'daemon off;'是前台运行模式，会持续占用当前Shell进程的执行流，导致后续代码永远不会被触发。要实现"Nginx启动后执行检查命令"的需求，需要调整Nginx的启动方式，同时保证容器能持续运行（Nginx需作为容器主进程）。

可行解决方案 #

方案一：后台启动Nginx，执行检查后再接管前台 #

这是轻量且直接的方案，无需额外依赖：

修改你的entrypoint.sh如下：

echo "Starting memcached"
memcached memcache -m 1024 -d
service memcached restart
echo "Starting php-fpm"
php-fpm -D

echo "Starting Nginx in background"
# 将Nginx后台启动，同时记录进程ID
nginx -g 'daemon off;' &
NGINX_PID=$!

# （可选）等待Nginx完全就绪，时间根据服务启动速度调整
sleep 3

# 执行检查逻辑
echo "Starting check robots"
check_robots=$(wp wpc check_robots) 

if [ "$check_robots" != "Robots checked successfully!" ]; then
    echo ERROR: Robots checked failed
    # 检查失败时终止Nginx，容器会随之退出
    kill $NGINX_PID
    exit 1
fi

# 将Nginx拉回前台，使其成为容器主进程，保证容器持续运行
wait $NGINX_PID

方案二：使用进程管理工具（适合多进程场景） #

如果容器需要管理多个长期运行的进程（如memcached、php-fpm、Nginx），可以用supervisord统一管理：

1. 在Dockerfile中安装supervisord：

RUN apt-get update && apt-get install -y supervisor

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

[supervisord]
nodaemon=true

[program:memcached]
command=memcached memcache -m 1024
autostart=true
autorestart=true

[program:php-fpm]
command=php-fpm
autostart=true
autorestart=true

[program:nginx]
command=nginx -g 'daemon off;'
autostart=true
autorestart=true

[program:robot-check]
command=bash -c "sleep 5 && wp wpc check_robots || exit 1"
autostart=true
autorestart=false

3. 修改entrypoint为启动supervisord：

exec supervisord -c /etc/supervisor/supervisord.conf

注意事项 #

• 若你的检查依赖Nginx完全就绪，必须添加sleep或更可靠的健康检查逻辑（比如循环curl直到成功），避免因服务未启动导致检查失败。
• 检查失败时要主动终止Nginx进程（方案一）或设置supervisord任务退出后终止容器，确保容器状态能反映服务健康情况。
• 确保wp命令已在容器中正确安装并配置好环境变量。

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