ngx_stream_geo_module 模組

ngx_stream_geo_module 模組 (1.11.3) 會根據用戶端 IP 位址建立變數及其值。

設定範例

geo $geo {
    default        0;

    127.0.0.1      2;
    192.168.1.0/24 1;
    10.1.0.0/16    1;

    ::1            2;
    2001:0db8::/32 1;
}

指令

語法	`geo [$address] $variable { ... }`
預設值	—
內容	`stream`

描述指定變數的值與用戶端 IP 位址的關聯性。預設情況下，位址取自 $remote_addr 變數，但也可以取自其他變數，例如：

geo $arg_remote_addr $geo {
    ...;
}

由於變數僅在使用時才會被評估，因此即使宣告大量 “geo” 變數，也不會對連線處理造成額外成本。

如果變數的值不代表有效的 IP 位址，則會使用 “255.255.255.255” 位址。

位址可以指定為 CIDR 表示法中的前綴（包括個別位址）或範圍。

也支援以下特殊參數：

delete: 刪除指定的網路。
default: 如果用戶端位址與任何指定的位址都不匹配，則會將該值設定給變數。當位址以 CIDR 表示法指定時，可以使用 “0.0.0.0/0” 和 “::/0” 來代替 default。如果未指定 default，則預設值將為空字串。
include: 包含帶有位址和值的文件。可以有多個包含。
ranges: 表示位址指定為範圍。此參數應為第一個。為了加快地理基礎的載入速度，應將位址依遞增順序排列。

範例

geo $country {
    default        ZZ;
    include        conf/geo.conf;
    delete         127.0.0.0/16;

    127.0.0.0/24   US;
    127.0.0.1/32   RU;
    10.1.0.0/16    RU;
    192.168.1.0/24 UK;
}

conf/geo.conf 檔案可能包含以下幾行：

10.2.0.0/16    RU;
192.168.2.0/24 RU;

會使用最精確匹配的值。例如，對於 127.0.0.1 位址，將會選擇 “RU” 值，而不是 “US”。

包含範圍的範例

geo $country {
    ranges;
    default                   ZZ;
    127.0.0.0-127.0.0.0       US;
    127.0.0.1-127.0.0.1       RU;
    127.0.0.1-127.0.0.255     US;
    10.1.0.0-10.1.255.255     RU;
    192.168.1.0-192.168.1.255 UK;
}