【Nginx基础】Map模块的使用案例（nginx 模块化原理）

Nginx的map模块可以将一个变量映射为另一个变量或值，常用于请求重写、转发等场景。以下是一些使用案例：

1. 请求重写

假设有一个旧的URL，需要将其重定向到一个新的URL，可以使用map模块将旧URL映射为新URL，然后使用rewrite指令进行重写。例如：

map $request_uri $new_url {
    /old-url /new-url;
}
server {
    ...
    rewrite ^ $new_url? permanent;
    ...
}

这个例子中，$request_uri变量代表请求的URI，当它等于/old-url时，将被映射为/new-url。然后使用rewrite指令将请求重写为新的URL。

2. 根据请求参数转发到不同的后端服务器

假设有一个Web应用程序，可以处理多个业务功能，根据请求参数的不同，需要将请求转发到不同的后端服务器。可以使用map模块将请求参数映射为后端服务器的地址，然后使用proxy_pass指令进行转发。例如：

map $arg_func $backend_server {
    "func1"  backend1.example.com;
    "func2"  backend2.example.com;
    default  backend3.example.com;
}
server {
    ...
    location /api/ {
        proxy_pass http://$backend_server:8080;
    }
    ...
}

这个例子中，$arg_func变量代表请求参数中的func参数，当它的值为func1时，将被映射为backend1.example.com，以此类推。然后使用proxy_pass指令将请求转发到对应的后端服务器。

3. 根据客户端IP地址限制访问

假设需要根据客户端IP地址限制访问某个URL，可以使用map模块将IP地址映射为允许或禁止访问的标志位，然后使用deny或allow指令进行限制。

map $remote_addr $allowed {
    192.168.1.0/24  1;
    10.0.0.0/8      1;
    default         0;
}

server {
    ...
    location / {
        if ($allowed = 0) {
            return 403;
        }
        ...
    }
    ...
}

这个例子中，$remote_addr变量代表客户端的IP地址。通过map模块，将IP地址映射为是否允许访问的标识，例如，192.168.1.0/24表示以192.168.1为前缀的IP地址段，将被映射为1，表示允许访问；10.0.0.0/8表示以10为前缀的IP地址段，也将被映射为1；default代表默认情况下不允许访问，将被映射为0。然后在location中使用if指令判断是否允许访问，如果不允许，则返回403状态码，拒绝访问。这种方式仅仅是限制访问，并不能保证安全性，建议使用更安全的方式限制访问，例如使用HTTP Basic认证或者SSL证书等方式。

4. 动态设置HTTP响应头

假设需要根据某些条件动态设置HTTP响应头，可以使用map模块将条件映射为需要设置的HTTP头部信息，然后使用add_header指令设置HTTP头部信息。例如：

map $sent_http_content_type $custom_header {
    "text/html" "X-Content-Type-Options: nosniff";
    default "";
}
server {
    ...
    add_header $custom_header;
    ...
}

这个例子中，$sent_http_content_type变量代表当前响应的Content-Type头部信息，当它等于text/html时，将被映射为X-Content-Type-Options: nosniff，表示需要设置X-Content-Type-Options头部信息。其他情况下，将被映射为空字符串，不需要设置头部信息。然后使用add_header指令将自定义的HTTP头部信息添加到响应中。

5. 动态设置缓存有效期

假设需要根据某些条件动态设置缓存的有效期，可以使用map模块将条件映射为需要设置的缓存有效期，然后使用expires指令设置缓存有效期。例如：

map $request_uri $cache_time {
    /api/data  1h;
    default    10m;
}
server {
    ...
    location / {
        expires $cache_time;
        ...
    }
    ...
}

这个例子中，$request_uri变量代表请求的URI，当它等于/api/data时，将被映射为1小时，表示需要设置1小时的缓存有效期。其他情况下，将被映射为10分钟，表示需要设置10分钟的缓存有效期。然后使用expires指令将缓存有效期设置为自定义的时间。