如何在ingress-nginx中基于请求参数解码实现动态proxy_pass

在Kubernetes的ingress-nginx中实现proxy_pass，将请求代理至下游服务器。核心需求如下：

• 根据入请求的forward参数值构建目标URI：解码该参数的值，拼接至基准URI（如https://example-proxy.com/）
• 完整转发请求体、请求头部
• 可添加X-Forwarded-For等额外头部
• forward参数的路径和内容均不确定

示例入请求：

curl 'https://example.com/proxy?forward=%2Fapi%2Fv1%3Fparam1%3Dval1%26param2%3Dval2' -v -X POST --data-raw '{"key": "value"}'

解码forward参数后得到/api/v1?param1=val1&param2=val2，目标请求应为：

curl 'https://example-proxy.com/api/v1?param1=val1&param2=val2' -v -X POST --data-raw '{"key": "value"}'

尝试方案1：

location /proxy {
  proxy_pass https://example-proxy.com$arg_forward;
}

问题：$arg_forward未被解码，导致目标URI包含编码后的字符。

尝试方案2：手动通过if语句替换编码字符，但需要重复大量if语句，无法覆盖所有编码场景，扩展性差：

location /proxy {
  # 替换%2F为/
  if ( $arg_forward ~ (.*)%2F(.*) ){
    set $arg_forward $1/$2;
  }
  if ( $arg_forward ~ (.*)%2F(.*) ){
    set $arg_forward $1/$2;
  }
  if ( $arg_forward ~ (.*)%2F(.*) ){
    set $arg_forward $1/$2;
  }

  # 替换%3F为?
  if ( $arg_forward ~ (.*)%3F(.*) ){
    set $arg_forward $1?$2;
  }

  # 替换%3D为=
  if ( $arg_forward ~ (.*)%3D(.*) ){
    set $arg_forward $1=$2;
  }

  # 更多替换逻辑...

  proxy_pass https://example-proxy.com$arg_forward;
}

问询：是否存在无需安装额外模块的参数解码方法？

可以利用Nginx原生的rewrite和set指令实现自动解码，无需安装任何第三方模块。原理是rewrite在处理变量时会自动解码百分号编码的字符，我们可以借此将$arg_forward解码后存入临时变量，再用于proxy_pass的URI拼接。

完整的ingress-nginx配置示例：

location /proxy {
    # 通过rewrite触发$arg_forward的解码，将结果存入$decoded_forward变量
    rewrite ^/(.*)$ $arg_forward? break;
    set $decoded_forward $uri;

    # 恢复原始请求的URI，避免干扰后续逻辑（可选）
    set $uri /proxy;

    # 拼接基准URI并代理，保留请求方法、体和头部
    proxy_pass https://example-proxy.com$decoded_forward;

    # 转发必要的请求头部
    proxy_set_header Host $host;
    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 $scheme;

    # 确保请求体和头部被完整转发
    proxy_pass_request_body on;
    proxy_pass_request_headers on;

    # 若需要保留原始请求中除forward外的其他查询参数，可改为：
    # proxy_pass https://example-proxy.com$decoded_forward$is_args$args;
}

关键说明 #

1. 解码逻辑：rewrite ^/(.*)$ $arg_forward? break;会将$arg_forward的值作为rewrite的目标，Nginx会自动解码其中的所有标准URL编码字符（如%2F→/、%3F→?、%26→&等），解码后的路径部分会被存入$uri变量。
2. 变量存储：通过set $decoded_forward $uri;将解码后的值保存到临时变量，避免后续操作覆盖$uri。
3. 请求转发：proxy_pass_request_body on和proxy_pass_request_headers on确保请求体和头部被完整转发到下游服务器；proxy_set_header配置额外的转发头部，满足需求。

这种方法无需手动维护编码字符的替换规则，能处理所有符合标准的URL编码场景，扩展性强且完全依赖Nginx原生功能。

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