如何基于上游服务器VERSION响应头在Nginx中分发不同HTML文件？

核心错误点 #

1. 内置变量误用：$upstream_http_version是Nginx的内置变量，代表上游响应的HTTP协议版本（比如1.1、2.0），完全不是你自定义的VERSION响应头。即使上游返回VERSION头，这个变量也不会指向它——内置变量优先级远高于自定义头生成的变量。
2. 缺少上游请求逻辑：你的配置里没有发起任何上游请求，$upstream_http_*系列变量根本没有被赋值，自然无法解析出有效内容。

可行解决方案 #

方案1：修改上游头名+原生Nginx子请求（无额外依赖）

先让上游服务器把自定义头改成X-VERSION（避免和内置变量冲突），再用Nginx子请求获取版本信息，最后返回对应目录的文件：

# 定义上游服务器地址
upstream version_server {
    server your-upstream-ip:port;
}

location / {
    # 定义变量存储版本号，设置默认值防止上游无响应
    set $app_version "default";

    # 发起内部子请求，获取上游的X-VERSION头
    rewrite_by_lua_block {
        local res = ngx.location.capture('/__get_version')
        if res.status == 200 and res.headers['X-VERSION'] then
            ngx.var.app_version = res.headers['X-VERSION']
        end
    }

    # 根据版本号匹配对应目录的静态文件
    try_files /releases/$app_version$uri $uri =404;
}

# 用于获取版本信息的内部location（外部无法直接访问）
location = /__get_version {
    internal;
    proxy_pass http://version_server;
    # 只请求响应头，减少数据传输开销
    proxy_method HEAD;
    proxy_set_header Host $host;
    # 关闭请求体传递，适配HEAD请求
    proxy_pass_request_body off;
    proxy_set_header Content-Length "";
}

方案2：保留原VERSION头+Lua模块（兼容上游现有配置）

如果无法修改上游的头名，必须使用VERSION，则只能通过Lua模块绕过内置变量限制——Lua可以直接读取原始响应头表，不受Nginx内置变量的干扰：

upstream version_server {
    server your-upstream-ip:port;
}

location / {
    set $app_version "default";

    rewrite_by_lua_block {
        local res = ngx.location.capture('/__get_version')
        if res.status == 200 then
            # 直接读取上游返回的VERSION头，不受内置变量影响
            ngx.var.app_version = res.headers['VERSION'] or ngx.var.app_version
        end
    }

    try_files /releases/$app_version$uri $uri =404;
}

location = /__get_version {
    internal;
    proxy_pass http://version_server;
    proxy_method HEAD;
    proxy_set_header Host $host;
    proxy_pass_request_body off;
    proxy_set_header Content-Length "";
}

优化建议

• 如果版本信息不会频繁变更，可以给/__get_version配置添加proxy_cache规则，减少上游请求压力。
• 确保/releases/目录下的各版本文件权限正确，Nginx进程拥有读取权限。

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