基于Nginx反向代理，按X-ROUTE请求头指定URL转发请求

要实现根据请求头X-ROUTE指定的地址动态转发请求，核心是利用Nginx的变量特性提取头信息并拼接目标URL，以下是完整配置方案：

基础配置 #

server {
    listen 80;
    server_name localhost;

    location / {
        # 从请求头提取目标路由
        set $target_route $http_x_route;
        # 拼接目标地址：X-ROUTE值 + 原始请求URI
        proxy_pass $target_route$request_uri;

        # 传递客户端相关信息到上游
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

关键配置说明 #

• $http_x_route：Nginx会自动将请求头X-ROUTE转换为该变量（规则：请求头名称转小写，横线替换为下划线）
• $request_uri：保留客户端请求的完整URI（包括参数），确保转发后路径与原请求一致
• proxy_pass直接使用变量拼接后的地址，实现动态路由转发

增强配置（可选） #

1. 缺失X-ROUTE头时返回错误 #

如果请求没有携带X-ROUTE头，直接返回400错误：

location / {
    set $target_route $http_x_route;

    if ($target_route = "") {
        return 400 "X-ROUTE header is required";
    }

    proxy_pass $target_route$request_uri;
    # 其他proxy_set_header配置...
}

2. 限制允许的目标域名 #

为避免恶意使用，可限制X-ROUTE只能指向指定域名：

location / {
    set $target_route $http_x_route;

    if ($target_route !~* "^http(s)?://(backend\.com|demo\.service\.com)") {
        return 403 "Target route is not allowed";
    }

    proxy_pass $target_route$request_uri;
    # 其他proxy_set_header配置...
}

3. 处理HTTPS上游 #

如果目标地址是HTTPS，需添加SSL相关配置确保转发正常：

location / {
    set $target_route $http_x_route;

    proxy_pass $target_route$request_uri;
    proxy_ssl_server_name on;
    proxy_ssl_protocols TLSv1.2 TLSv1.3;
    
    # 其他proxy_set_header配置...
}

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