ngx_http_proxy_protocol_vendor_module 模块

一、前置要求

1. 启用 PROXY 协议
   在 listen 指令中添加 proxy_protocol 参数，例如：

   server {
       listen 80   proxy_protocol;
       listen 443  ssl proxy_protocol;
       …
   }
   

2. 商业订阅
   本模块仅在 Nginx 商业版中提供。

二、示例配置

http {
    # 将 GCP 的 PSC 连接 ID 添加到上游请求头
    proxy_set_header X-Conn-ID $proxy_protocol_tlv_gcp_conn_id;

    server {
        listen 80   proxy_protocol;
        listen 443  ssl proxy_protocol;

        # 其他常规配置...
        location / {
            proxy_pass http://backend;
            # 示例：将 AWS VPC 端点 ID 透传给后端
            proxy_set_header X-AWS-VPCE-ID $proxy_protocol_tlv_aws_vpce_id;
            # 示例：将 Azure 私有端点 LinkID 透传给后端
            proxy_set_header X-AZURE-PEL-ID $proxy_protocol_tlv_azure_pel_id;
        }
    }
}

三、嵌入式变量

这些变量可直接用于 proxy_set_header、日志记录或其他需要客户端连接上下文的位置。

四、使用建议

1. 确保上游服务支持
   如果后端业务逻辑需要根据云平台连接元数据做访问控制、审计或路由，请务必在后端服务中解析并验证相应 HTTP 头。

2. 安全与合规
   云平台 TLV 信息可能包含敏感的网络拓扑标识，尽量只在可信环境或内部网络中透传，避免泄露给未授权的外部方。

3. 与 PROXY 协议配合

   • 在负载均衡器（如 AWS ALB/CLB、GCP 负载均衡、Azure 负载均衡）上启用 PROXY 协议；
   • Nginx listen … proxy_protocol 后端需配置成接收 PROXY 协议（proxy_protocol 参数）；
   • 并确保防火墙或安全组允许负载均衡器源 IP 伪装的连接。

通过 ngx_http_proxy_protocol_vendor_module，您可以在 Nginx 层面轻松获取并利用云平台提供的连接元数据，助力细粒度流量管理、审计和多云部署场景。