Nginx进阶：使用map指令实现灵活的变量映射与条件重定向

欢迎来到8455线路检测中心技术小课堂，每天分享一个技术小知识。

Nginx的map指令允许你创建一个变量映射，根据一个变量的值动态地设置另一个变量的值。这一功能非常强大，常用于实现条件重定向、基于请求头的访问控制、以及动态配置等高级场景。本文将深入讲解map指令的用法，并通过两个实际案例展示其灵活性。

1. 理解map指令的基本语法

map指令只能在http块中使用，它定义了一个映射关系，将源变量映射到结果变量。其基本语法如下：

http {

    map $source_variable $target_variable {

        value1   result1;

        value2   result2;

        default  default_result;

    }

}

· $source_variable：输入变量，可以是Nginx内置变量（如$http_user_agent, $args, $remote_addr等）或自定义变量。

· $target_variable：输出变量，根据映射规则，将源变量的值映射为新的值。

· 花括号内是映射表，每一行表示一个映射关系，以分号结尾。

· default：当源变量的值没有匹配到任何映射时，将使用默认值。

注意：map指令的执行顺序是按照映射表从上到下进行匹配，直到找到第一个匹配的值。因此，更具体的匹配应该放在前面。

2. 实战案例一：基于用户代理（User-Agent）的重定向

假设我们想要将使用旧版Internet Explorer（比如IE 8及以下）的用户重定向到一个提示页面，告知他们升级浏览器。

首先，我们在http块中定义一个映射，将用户代理映射为一个标志变量：

http {

    map $http_user_agent $redirect_to_upgrade {

        default         0;

        "~*MSIE [1-8]\\." 1;  # 正则表达式匹配IE 1-8

    }

    server {

        listen 80;

        server_name example.com;

        # 如果映射结果为1，则重定向到升级浏览器提示页面

        if ($redirect_to_upgrade) {

            return 302 /upgrade.html;

        }

        location / {

            root /usr/share/nginx/html;

        }

        location = /upgrade.html {

            root /usr/share/nginx/html;

        }

    }

}

解析：

· 我们使用$http_user_agent作为输入变量，输出变量为$redirect_to_upgrade。

· 映射表中，使用正则表达式"~*MSIE [1-8]\\."匹配IE 1-8版本，如果匹配，则$redirect_to_upgrade的值为1，否则为默认值0。

· 在server块中，通过判断$redirect_to_upgrade的值，决定是否重定向。

3. 实战案例二：基于查询参数（query string）的动态代理

假设我们有一个应用，根据查询参数version的值，将请求代理到不同的后端服务器。例如，version=v1代理到后端1，version=v2代理到后端2，若无参数或参数错误，则代理到默认后端。

使用map指令，我们可以将查询参数映射为一个后端服务器地址变量。

http {

    map $arg_version $backend {

        v1      backend1.example.com;

        v2      backend2.example.com;

        default default-backend.example.com;

    }

    upstream backend1 {

        server backend1.example.com:8080;

    }

    upstream backend2 {

        server backend2.example.com:8080;

    }

    upstream default-backend {

        server default-backend.example.com:8080;

    }

    server {

        listen 80;

        server_name myapp.com;

        location / {

            # 根据$backend变量的值，选择对应的上游组

            proxy_pass http://$backend;

            proxy_set_header Host $host;

            proxy_set_header X-Real-IP $remote_addr;

        }

    }

}

解析：

· $arg_version是Nginx内置变量，表示查询参数version的值。

· 根据version的值，映射到不同的后端服务器域名（或上游组名）。

· 在location块中，我们使用proxy_pass指令，并将$backend变量作为代理目标。注意，这里我们使用了上游组（upstream）来定义后端服务器，但在map中我们映射为域名，然后通过代理到对应的上游组。实际上，我们可以直接映射为上游组名，但注意map指令不能直接使用上游组，所以这里我们映射为域名，然后在proxy_pass中通过变量选择上游组。但是，这样写需要上游组名与域名一致，或者我们可以直接映射为上游组名（字符串），然后在proxy_pass中使用变量。但注意，proxy_pass后面如果使用变量，则不会使用upstream配置，而是直接代理到该变量表示的地址。因此，我们可以调整一下，将map映射为上游组名，然后在proxy_pass中通过变量引用上游组。

修正方案：

我们可以将map映射为上游组名，然后在proxy_pass中通过变量构造一个上游组引用。但是，Nginx的proxy_pass指令不支持变量作为上游组名。因此，我们可以使用一个技巧：使用多个location块，或者使用if指令进行条件判断。但这样不够优雅。

另一种方法是使用动态上游模块（如ngx_http_upstream_dynamic_module），但这不是标准模块。因此，我们这里采用一个更通用的方法：在map中映射为端口号，然后通过变量构造代理地址。

假设我们的后端服务器都在同一个域名下，但端口不同：

http {

    map $arg_version $backend_port {

        v1      8081;

        v2      8082;

        default 8080;

    }

    server {

        listen 80;

        server_name myapp.com;

        location / {

            proxy_pass http://www.landui.com:$backend_port;

            proxy_set_header Host $host;

            proxy_set_header X-Real-IP $remote_addr;

        }

    }

}

这样，根据version参数，请求会被代理到backend.example.com的不同端口上。

4. 注意事项

· map指令只能放在http块中，但可以在http块内的任何位置，只要在使用变量之前定义即可。

· 映射表是按照顺序匹配的，因此应该将更具体的匹配放在前面。

· 使用正则表达式时，可以以~（区分大小写）或~*（不区分大小写）开头。

· map指令定义的变量在配置的其余部分都可以使用，例如在server、location块中。

总结

Nginx的map指令是一个强大的工具，它允许你根据变量值进行动态配置。通过创建灵活的映射关系，你可以实现条件重定向、动态代理、访问控制等多种高级功能。掌握map指令，能够让你的Nginx配置更加简洁、高效和可维护。

在实际使用中，请注意映射的顺序和默认值的设置，确保在未匹配的情况下有合理的回退方案。同时，由于map指令在Nginx启动时加载，所以对于频繁变化的映射，可能需要考虑其他动态方案。

8455线路检测中心官网上拥有完善的技术支持库可供参考，大家可自行查阅，更多技术问题，可以直接咨询。同时，8455线路检测中心整理了运维必备的工具包免费分享给大家使用，需要的朋友可以直接咨询。

更多技术知识，8455线路检测中心期待与你一起探索。