NGINX中使用变量指定proxy_pass的scheme失效问题求助

云上老周

2026-7-30

NGINX动态设置proxy_pass的Scheme问题解答

问题本质与行为说明

你遇到的现象在NGINX 1.10.3版本中是正常的，核心原因在于NGINX对proxy_pass指令的解析逻辑存在差异：

当proxy_pass使用「硬编码scheme+变量地址」（如https://$upstream）时，NGINX会明确识别https://为固定通信协议，仅将$upstream作为后端地址解析，因此能正常工作。
当proxy_pass使用「全变量拼接的完整URI」（如$myscheme://$upstream）时，老版本NGINX会将整个字符串当作单一的后端地址处理，而非拆分scheme和地址部分，导致它尝试解析$myscheme://$upstream为域名/IP，自然会失败。

动态设置Scheme的可行方案

针对NGINX 1.10.3版本，有两种可靠的实现方式：

1. map指令+if判断（推荐）

先通过map根据$host映射出对应的scheme，再用if指令匹配并选择对应的proxy_pass规则：

# 在http块中定义map规则
map $host $proxy_scheme {
    default       http;
    example.com   https;
    sub.example.cn https;
}

server {
    listen 80;
    server_name _;

    set $upstream backend.example.com;

    if ($proxy_scheme = https) {
        proxy_pass https://$upstream;
    }
    if ($proxy_scheme = http) {
        proxy_pass http://$upstream;
    }

    # 补充必要的proxy配置
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

注：NGINX的if指令需谨慎使用，但这种简单的相等判断属于安全场景，不会触发意外行为。