uwsgi-nginx Docker镜像自定义Nginx配置未生效问题咨询

问题根因 #

你使用的tiangolo/uwsgi-nginx基础镜像内置了启动自动生成Nginx配置的逻辑，容器启动时entrypoint脚本会自动生成默认的uwsgi转发配置，覆盖你在构建阶段复制到/etc/nginx/conf.d/下的自定义配置。

解决方案 #

方案1：禁用镜像的自动配置生成（最适配当前场景）

直接在Dockerfile中添加环境变量关闭自动配置生成功能即可，修改后的Dockerfile对应部分如下：

ENV UWSGI_INI /app/deployment/$env/uwsgi.ini
# 新增这行，关闭Nginx自动配置生成
ENV DISABLE_NGINX_UWSGI_CONFIG true

RUN rm /etc/nginx/conf.d/default.conf

COPY deployment/$env/supervisor.conf /etc/supervisor.d/app.ini
COPY deployment/$env/nginx.conf /etc/nginx/conf.d/nginx.conf

重新构建镜像后启动，自定义配置就会正常生效。

方案2：调整配置优先级确认生效顺序

如果你需要保留镜像的自动配置逻辑，仅新增/覆盖部分配置，可以将你的自定义配置文件命名为z-custom.conf这类字母排序靠后的文件名，Nginx会按文件名顺序加载配置，后加载的同端口/server规则会覆盖先加载的规则。
要确认实际生效的配置，直接在运行的容器中执行以下命令：

nginx -T

该命令会输出所有加载的Nginx配置的完整内容和加载顺序，同时会检查配置语法是否合法，可以直接定位到生效的配置文件。

方案3：完全替换Nginx主配置

如果需要完全自定义整个Nginx运行配置，不需要镜像内置的任何配置逻辑，可以直接将你的自定义nginx.conf复制到主配置路径：

COPY deployment/$env/nginx.conf /etc/nginx/nginx.conf

额外排查项 #

如果修改后还是不生效，先排查构建参数是否正确：构建镜像时是否传入了正确的env参数，比如docker build --build-arg env=prod .，避免因$env变量为空导致复制了错误路径下的配置文件，可以在COPY配置后加一行RUN cat /etc/nginx/conf.d/nginx.conf，构建时就能确认复制的配置内容是否符合预期。

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