Docker容器中后台Nginx未启动排查：非root用户前台运行sleep

当前配置的核心问题 #

• RUN阶段启动Nginx完全无效：Docker的RUN指令仅在镜像构建过程中执行命令，构建完成后该进程会直接终止，不会被保留到容器运行阶段。你在RUN里启动Nginx，只是在构建镜像的临时容器中短暂运行，最终生成的镜像里根本没有这个后台进程，容器启动后自然看不到。
• 非root用户权限不足：普通Nginx镜像默认监听80端口（属于1024以下的特权端口），Linux系统中非root用户无法绑定这类端口，这就是为什么你进入容器后用sudo能启动Nginx，直接启动却失败的原因。
• 容器启动流程错误：容器启动时的PID 1进程是sleep，如果不在启动阶段主动触发Nginx启动，容器内不会自动运行该服务。

基于普通Nginx镜像的实现方法 #

要满足需求，需要解决权限问题，并在容器启动时正确启动Nginx后台进程，具体步骤如下：

1. 修改Nginx监听端口 #

将Nginx默认监听的80端口改为1024以上的非特权端口（比如8080），可以通过sed直接修改默认配置：

RUN sed -i 's/listen 80;/listen 8080;/g' /etc/nginx/conf.d/default.conf

2. 创建自定义用户并调整目录权限 #

Nginx需要读写日志目录、运行时目录（如/var/log/nginx、/var/run/nginx），因此需要给自定义用户赋予这些目录的权限：

RUN useradd -m myuser && \
    chown -R myuser:myuser /var/log/nginx /var/run/nginx /usr/share/nginx/html

3. 在容器启动时启动Nginx后台并运行sleep #

不能用RUN启动Nginx，必须在容器启动阶段（CMD或ENTRYPOINT）执行启动命令。可以直接用shell命令串联两个操作：

USER myuser
CMD ["sh", "-c", "nginx -g 'daemon on;' && sleep infinity"]

完整Dockerfile示例 #

FROM nginx:latest

# 修改Nginx监听端口为8080
RUN sed -i 's/listen 80;/listen 8080;/g' /etc/nginx/conf.d/default.conf

# 创建自定义非root用户并调整权限
RUN useradd -m myuser && \
    chown -R myuser:myuser /var/log/nginx /var/run/nginx /usr/share/nginx/html

# 切换到自定义用户，启动Nginx后台并前台运行sleep
USER myuser
CMD ["sh", "-c", "nginx -g 'daemon on;' && sleep infinity"]

验证方法 #

启动容器后，执行docker exec <容器ID> ps aux，就能看到Nginx的后台进程和前台运行的sleep进程了。

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