You need to enable JavaScript to run this app. 如何在nginx中为不同环境配置对应入站端口的流量转发规则?
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 19:36:04