快捷導(dǎo)航

Nginx中map指令的具體使用

更新時(shí)間：2024年07月15日 09:48:26 作者：白--茶

Nginx的map指令是一個(gè)強(qiáng)大的工具,用于根據(jù)變量的值來(lái)設(shè)置另一個(gè)變量的值,本文就來(lái)介紹一下Nginx中map指令的具體使用,感興趣的可以了解一下

map指令簡(jiǎn)單介紹

當(dāng)然這里寫(xiě)的都是官方文檔是已經(jīng)寫(xiě)過(guò)的，我簡(jiǎn)單抄一下哈。

map指令來(lái)自于 ngx_http_map_module 模塊，提供的核心能力是基于一個(gè)變量創(chuàng)建一個(gè)新變量，大概是這意思。

語(yǔ)法: 只能配置在http塊內(nèi)
map string $variable {...}

直接看這個(gè)語(yǔ)法好像看不出來(lái)它能干什么，所以官方文檔上給了幾個(gè)例子:

map $http_host $name {
    hostnames;

    default       0;

    example.com   1;
    *.example.com 1;
    example.org   2;
    *.example.org 2;
    .example.net  3;
    wap.*         4;
}

解析一下上面??這個(gè)例子的意思??:

map: 關(guān)鍵字，開(kāi)辟一段內(nèi)存空間聲明一個(gè)map

$http_host: 獲取host請(qǐng)求頭：eg: www.baidu.com
$name: 新變量，具體取值是什么取決于結(jié)構(gòu)體內(nèi)的映射關(guān)系

結(jié)構(gòu)體內(nèi)的數(shù)據(jù)解析:

hostnames:官方文檔給出的解釋是：允許用前綴或者后綴掩碼指定域名作為源變量值。這個(gè)參數(shù)必須寫(xiě)在值映射列表的最前面。

讀都能讀的懂，字也都認(rèn)識(shí)，但是怎么感覺(jué)好像還是不太懂呢，又沒(méi)有同感？于是我測(cè)試了一下，其實(shí)就是你想用下面那種泛域名來(lái)匹配host的話(huà)就加一下這個(gè)參數(shù)，否則是達(dá)不到預(yù)期效果的。

default 0; :匹配不到符合條件的數(shù)據(jù)時(shí) 則$name 這個(gè)變量就取默認(rèn)值 0

知道了這之后我能用它來(lái)做什么呢？看實(shí)際應(yīng)用的例子

map指令的實(shí)踐使用

1. 基于cookie做多環(huán)境分流

一般中大型公司都會(huì)有多套測(cè)試環(huán)境，對(duì)于多環(huán)境的訪(fǎng)問(wèn)可能最容易想到的就是對(duì)應(yīng)多個(gè)域名，這方法當(dāng)然可以，但是不優(yōu)雅，維護(hù)多個(gè)域名太累。為了偷懶，我們用了一個(gè)域名，使用不同的cookie來(lái)轉(zhuǎn)發(fā)相應(yīng)的流量到相應(yīng)的環(huán)境。

如何實(shí)現(xiàn)？

    map $cookie_cl_env_num $cl_backend_map {
        default   1.1.1.1:80;
        dev-01    upstream_dev-01;
        dev-02    upstream_dev-02;
        dev-03    upstream_dev-03;
        test-01   upstream_test-01;
        test-02   upstream_test-02;
        test-03   upstream_test-03;
        test-04   upstream_test-04;
        test-05   upstream_test-05;
        test-06   upstream_test-06;
        test-07   upstream_test-07;
        test-08   upstream_test-08;
        test-09   upstream_test-09;
        test-10   upstream_test-10;
        test-11   upstream_test-11;
        test-12   upstream_test-12;
        test-13   upstream_test-13;
        test-14   upstream_test-14;
        test-15   upstream_test-15;
    }

    # 隨便寫(xiě)一個(gè)
    upstream upstream_test-14 {
        server 2.2.2.2:80;
    }

    # 局部實(shí)現(xiàn)寫(xiě)一下
    location / {
        pass_pass http://$cl_backend_map;
    }

    # 請(qǐng)求
    curl --cookie "cl_env_num=test-15" a.test.com/api/v1/hahaha

這不就實(shí)現(xiàn)了嘛，很方便哈。僅提供思路！當(dāng)然也可以使用其他變量來(lái)分流 UA|args ...

2. 做安全的多域名跨域訪(fǎng)問(wèn)

跨域訪(fǎng)問(wèn)一般情況下我們都會(huì)直接設(shè)置 * 允許所有跨域訪(fǎng)問(wèn)。但是難免會(huì)有一些對(duì)安全性要求較高的業(yè)務(wù)不允許這樣，那么對(duì)于域名比較多的安全跨域配置，也可以使用map來(lái)實(shí)現(xiàn)。

map $http_origin $allow_origin {
    ~http://www.baidu.com http://www.baidu.com;
    ~http://m.baidu.com   http://m.baidu.com;
    ~http://a.baidu.com   http://a.baidu.com;
    default               deny;
}

server {
    listen 80;
    server_name www.baidu.com;

    location / {
        ...
        add_header Access-Control-Allow-Origin $allow_origin;
        ...
    }
}

僅提供思路哈，具體情況可以再優(yōu)化