Nginx如何配置proxy_pass提取query2参数拼接至代理目标路径

实现思路 #

Nginx 内置了$arg_参数名变量，可以直接获取请求URL中对应参数的取值，你需要提取的query2参数可以直接通过$arg_query2拿到，不需要额外写正则做字符串截取，效率更高也更易维护。

配置示例 #

server {
    listen 80;
    server_name 你的实际域名或IP;

    # 匹配你需要处理的请求前缀，可根据实际业务调整匹配规则
    location ^~ /files/ {
        # 校验query2参数是否存在，不存在直接返回400，可按需调整为其他逻辑
        if ($arg_query2 = '') {
            return 400;
        }

        # 末尾加?的作用是清除原请求的所有查询参数，避免多余参数带到上游
        proxy_pass http://127.0.0.1:25123/stream/$arg_query2?;

        # 常规代理头配置，按需增删即可
        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_pass的目标地址末尾加上?，否则原请求的query1、query3等参数会被自动拼接到上游地址后面，不符合需求。
• 如果你需要对参数做更复杂的校验，比如要求query2必须是数字，可以搭配正则匹配实现，示例如下：

  if ($arg_query2 !~ ^[0-9]+$) {
      return 400;
  }
  

• location的匹配规则可以根据你的业务场景调整，比如如果只需要处理.mov后缀的请求，可以改成正则匹配location ~* ^/files/.*\.mov$

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