Alpine Docker容器中Nginx无法正常启动的问题求助

核心问题1：基础镜像缺少Nginx #

php:8.1-fpm-alpine官方镜像默认仅包含PHP-FPM，没有预装Nginx。你能进入容器手动执行nginx，大概率是构建镜像时通过其他临时方式安装了，但你的Dockerfile里没有明确的安装指令，这会导致镜像构建不稳定。

核心问题2：Nginx默认后台运行导致容器重启 #

当你用ENTRYPOINT [ "nginx" ]启动容器时，Nginx默认以**后台守护进程（daemon）**模式运行，启动完成后父进程会直接退出。而Docker容器依赖主进程持续运行，主进程一旦退出容器就会停止，若配置了重启策略就会出现持续重启的情况。

修复步骤 #

1. 修正Dockerfile，安装Nginx并让其前台运行

首先在镜像构建阶段安装Nginx，同时通过参数让Nginx保持前台运行，作为容器主进程：

FROM php:8.1-fpm-alpine

# 安装Nginx
RUN apk update && apk add --no-cache nginx

WORKDIR /app

COPY . .

# 添加Nginx配置文件（需要你提前编写好，示例见下方）
COPY nginx.conf /etc/nginx/conf.d/default.conf

EXPOSE 80

# 让Nginx前台运行，防止容器退出
ENTRYPOINT [ "nginx", "-g", "daemon off;" ]

2. 编写Nginx配置文件（nginx.conf）

需要配置Nginx将请求转发到PHP-FPM（默认监听9000端口），示例配置：

server {
    listen 80;
    root /app;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3. 同时运行PHP-FPM和Nginx（必要补充）

上面的配置仅启动了Nginx，但PHP-FPM并没有运行，PHP文件无法被解析。需要用进程管理工具（如supervisord）同时管理两个进程：

更新后的Dockerfile：

FROM php:8.1-fpm-alpine

# 安装Nginx和supervisord
RUN apk update && apk add --no-cache nginx supervisor

# 创建supervisord配置目录
RUN mkdir -p /etc/supervisor.d/

# 复制supervisord配置文件
COPY supervisord.ini /etc/supervisor.d/supervisord.ini

WORKDIR /app

COPY . .

# 复制Nginx配置
COPY nginx.conf /etc/nginx/conf.d/default.conf

EXPOSE 80

# 启动supervisord管理两个进程
ENTRYPOINT [ "supervisord", "-c", "/etc/supervisor.d/supervisord.ini" ]

编写supervisord.ini配置文件：

[supervisord]
nodaemon=true  # 让supervisord前台运行

[program:php-fpm]
command=php-fpm
autostart=true
autorestart=true
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

[program:nginx]
command=nginx -g "daemon off;"
autostart=true
autorestart=true
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

额外说明 #

• RUN指令是镜像构建阶段执行的命令，用来安装软件、修改系统配置等，不会影响容器启动后的运行状态。你原来的RUN nginx只是在构建时临时启动过一次Nginx，构建完成后进程就终止了，对容器启动无意义。
• 容器必须有一个持续运行的主进程，否则会立即停止。无论是让Nginx前台运行，还是用supervisord作为主进程，核心都是保证主进程不退出。

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