如何在nginx中为不同环境配置对应入站端口的流量转发规则?
实现结论
完全可以实现上述流量转发规则,不需要改动后端Puma、Rails的任何运行逻辑,仅通过调整Nginx的入站端口匹配规则就能完成。
核心实现逻辑
- Nginx支持通过独立
server块绑定不同的入站监听端口,每个块的流量转发规则完全隔离,不会互相干扰 - 两个环境的后端服务都可以指向本地
127.0.0.1:3000的Puma进程,只要保证每个环境的服务器节点上只开启对应场景的监听端口,就能做到“仅对应环境做对应端口转发”的要求 - 从安全角度考虑,更推荐将生产、Staging环境部署在独立的服务器节点上,每个节点仅开放必要的监听端口,避免不必要的攻击面暴露
适配的Nginx配置
先提个原配置的常见坑:原配置给X-Forwarded-Host的取值加了单引号,Nginx碰到被单引号包裹的内容会直接当成纯字符串传递,不会解析里面的内置变量,Rails收到的转发头会是字面量$forwarded_host:$forwarded_port,导致路由生成、资源引用全部出错,必须把这层单引号去掉。
生产环境配置(入站8080端口规则)
保留原逻辑,仅修正上述语法问题,完整结构如下:
http { include mime.types; default_type application/octet-stream; keepalive_timeout 65; proxy_pass_request_headers on; server { listen 8080; # 可补充对应生产域名做匹配,避免错放其他域名的流量 # server_name prod.example.com; location / { proxy_set_header X-Real-IP $remote_addr; # 移除外层单引号,保证变量正常解析 proxy_set_header X-Forwarded-Host $forwarded_host:$forwarded_port; proxy_pass http://127.0.0.1:3000; proxy_redirect default; } # 保留原有的监控路径拦截规则 location /healthcheck { return 404; } location /metrics { return 404; } location /ping { return 404; } } }
Staging环境配置(入站443端口规则)
443是HTTPS协议的默认端口,需要补充SSL证书配置,同样将流量转发到本地3000端口的Puma服务,配置结构参考:
http { include mime.types; default_type application/octet-stream; keepalive_timeout 65; proxy_pass_request_headers on; server { # 绑定443端口并开启HTTPS支持 listen 443 ssl; # 可补充对应Staging域名做匹配 # server_name staging.example.com; # 替换为实际的Staging证书路径 ssl_certificate /etc/nginx/ssl/staging/cert.pem; ssl_certificate_key /etc/nginx/ssl/staging/key.pem; location / { proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-Host $forwarded_host:$forwarded_port; proxy_pass http://127.0.0.1:3000; proxy_redirect default; } # 保持和生产环境一致的监控路径拦截规则 location /healthcheck { return 404; } location /metrics { return 404; } location /ping { return 404; } } }
配置注意事项
- 443端口的HTTPS配置必须搭配有效、未过期的SSL证书,否则Nginx会直接启动失败
- 两个环境节点的防火墙、云安全组规则需要和监听端口严格匹配:生产节点仅开放8080入站规则,Staging节点仅开放443入站规则,避免端口错配导致流量异常
- 如果尝试在同一台服务器上同时运行生产、Staging环境,不能直接将两个环境的后端都指向3000端口,需要为不同环境的Puma进程分配独立的本地端口(比如生产Puma绑3000,Staging Puma绑3001),再通过Nginx对应端口转发到不同后端,否则会出现两个环境的流量互相抢占的问题
- 配置修改完成后,先执行
nginx -t校验语法正确性,确认无误后再通过重载命令让配置生效
内容的提问来源于stack exchange,提问作者BrotherShamus
相关产品推荐
相关产品推荐

