如何用Nginx通过中间代理实现Server A到Server B的API转发及排错

核心问题分析 #

1. Nginx启动DNS错误：原配置中proxy_pass https://example.com/api/endpoint1会让Nginx在启动时预解析example.com域名，但Server A受供应商网络限制无法解析该域名，导致启动失败。
2. 代理转发需求：所有请求必须通过指定的http://<proxyIp>:<proxyPort>代理服务器转发到Server B，同时要匹配curl命令中有效的Host头设置。

最终配置方案 #

替换原Nginx的location配置，改为以下内容（覆盖三个API端点）：

server {
    listen 8080 ssl;
    listen [::]:8080 ssl;

    server_name <Server A IP>;
    include /path/ssl.conf;

    // Other location blocks

    # 配置endpoint1转发
    location /api/endpoint1 {
        # 指向指定代理服务器
        proxy_pass http://<proxyIp>:<proxyPort>;
        
        # 设置与curl一致的Host头，确保Server B正确识别请求
        proxy_set_header Host example.in;
        
        # 告诉代理服务器目标请求的域名
        proxy_set_header X-Forwarded-Host example.com;
        
        # 传递客户端IP与协议信息
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        
        # 禁用缓存，确保请求实时转发
        proxy_cache_bypass 1;
        proxy_no_cache 1;
    }

    # 配置endpoint2转发
    location /api/endpoint2 {
        proxy_pass http://<proxyIp>:<proxyPort>;
        proxy_set_header Host example.in;
        proxy_set_header X-Forwarded-Host example.com;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_cache_bypass 1;
        proxy_no_cache 1;
    }

    # 配置endpoint3转发
    location /api/endpoint3 {
        proxy_pass http://<proxyIp>:<proxyPort>;
        proxy_set_header Host example.in;
        proxy_set_header X-Forwarded-Host example.com;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_cache_bypass 1;
        proxy_no_cache 1;
    }
}

配置说明 #

• 解决DNS错误：将proxy_pass指向代理服务器的IP和端口（无需域名解析），避免Nginx启动时预解析example.com失败。
• 匹配curl请求规则：设置Host: example.in与测试通过的curl命令一致，确保Server B的虚拟主机能正确处理请求。
• 代理转发逻辑：通过X-Forwarded-Host: example.com告知代理服务器目标请求的域名，让代理将请求转发到正确的API路径。
• 客户端信息传递：保留X-Real-IP、X-Forwarded-For等头信息，确保Server B能获取真实客户端IP。

验证步骤 #

1. 执行nginx -t测试配置，确认无语法错误。
2. 重启Nginx服务：systemctl restart nginx（红帽系统命令）。
3. 从Server A发起请求测试：curl -v -X POST https://<Server A IP>:8080/api/endpoint1 -k，检查请求是否能正常到达Server B。

内容的提问来源于stack exchange，提问作者Hariprakash Subramani