如何在Nginx中通过环境变量实现上游配置的条件选择

核心需求场景：启动Nginx服务时传入NGINX_SERVICE自定义环境变量（可选取值为DEV、QA），自动匹配生成对应的upstream配置规则：

• 当变量值为DEV时，upstream backend指向本地localhost:2222服务
• 当变量值为QA时，upstream backend指向两台QA环境节点的2223端口服务

方案一：envsubst 模板渲染（容器化部署场景首选，Nginx官方镜像原生支持） #

• 实现逻辑：将固定的Nginx配置文件改造为带占位符的模板，启动时通过内置的envsubst工具读取传入的环境变量值，替换模板占位符生成最终生效的配置后，再拉起Nginx进程
• 操作流程：
  1. 准备配置模板nginx.conf.template，将原固定写死的upstream server部分替换为占位符：

     upstream backend {
         ${BACKEND_SERVER_BLOCK}
     }
     

  2. 配置启动前置逻辑，根据NGINX_SERVICE的取值给BACKEND_SERVER_BLOCK变量赋值：
     • 取值为DEV时，赋值为server localhost:2222;
     • 取值为QA时，赋值为server qa-server1:2223; server qa-server2:2223;
  3. 触发模板渲染生成最终配置，校验配置语法无误后启动Nginx
• 补充说明：如果是用官方Nginx镜像部署，不需要自己写渲染逻辑，镜像内置的启动脚本会自动识别模板文件完成替换，只要提前把变量值传对就行；非容器化的传统部署场景，也可以在启动shell脚本中手动调用envsubst完成模板替换，效果完全一致。

方案二：按环境拆分独立配置，启动时动态加载 #

• 实现逻辑：提前将不同环境的upstream配置拆分为独立文件，主配置统一引用固定文件名的配置文件，启动前根据环境变量切换加载的具体文件
• 操作流程：
  1. 在Nginx配置目录下提前存放两份独立的upstream配置片段：
     • upstream-dev.conf：写入DEV环境的upstream规则
     • upstream-qa.conf：写入QA环境的upstream规则
  2. 在主配置nginx.conf中写统一的引用逻辑：

     upstream backend {
         include /etc/nginx/conf.d/active-upstream.conf;
     }
     

  3. 在启动脚本中读取NGINX_SERVICE变量值，通过软链接或文件拷贝的方式，把对应环境的配置文件替换为active-upstream.conf，完成配置切换后再启动Nginx。
• 补充说明：这种方式不依赖额外的模板渲染工具，传统虚拟机/物理机部署场景下改造成本极低。

方案三：OpenResty Lua 动态路由配置 #

• 实现逻辑：如果已部署带Lua扩展的Nginx（OpenResty），可以完全跳过静态upstream配置的条件分支，在请求处理阶段读取环境变量值，动态匹配对应的后端服务地址
• 适用场景：已经引入Lua生态做业务定制的Nginx部署场景，灵活度最高
• 注意事项：对没有扩展Lua模块的纯原生Nginx部署场景，这种方案的改造成本远高于前两种。

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