Модуль ngx_http_geoip_module

Модуль ngx_http_geoip_module (0.8.6+) создаёт переменные, значения которых зависят от IP-адреса клиента, используя готовые базы данных MaxMind. Начиная с версии 1.31.7, модуль поддерживает базы данных в формате MaxMind DB (MMDB).

По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра --with-http_geoip_module.

Для сборки и работы модуля необходима библиотека libmaxminddb для баз данных в формате MMDB (1.31.7) или библиотека GeoIP Legacy C для баз данных в формате DAT.

При использовании баз данных в формате DAT с поддержкой IPv6 (1.3.12, 1.2.7) IPv4-адреса ищутся отображёнными на IPv6. При использовании баз данных в формате MMDB IPv6-адреса, в которые отображены IPv4-адреса, ищутся как IPv4-адреса.

http {
    geoip_country         GeoLite2-Country.mmdb;
    geoip_city            GeoLite2-City.mmdb;
    geoip_org             GeoLite2-ASN.mmdb;
    geoip_proxy           192.168.100.0/24;
    geoip_proxy           2001:0db8::/32;
    geoip_proxy_recursive on;
    ...

Задаёт базу данных для определения страны в зависимости от значения IP-адреса клиента. При использовании этой базы данных доступны следующие переменные:

$geoip_country_code

двухбуквенный код страны, например, “RU”, “US”.

$geoip_country_code3

трёхбуквенный код страны, например, “RUS”, “USA”.

$geoip_country_name

название страны, например, “Russian Federation”, “United States”.

Задаёт базу данных для определения страны, региона и города в зависимости от значения IP-адреса клиента. При использовании этой базы данных доступны следующие переменные:

$geoip_area_code

телефонный код области (только для США).

Данная переменная может содержать неактуальную информацию, т.к. соответствующее поле базы данных объявлено устаревшим.

$geoip_city_continent_code

двухбуквенный код континента, например, “EU”, “NA”.

$geoip_city_country_code

двухбуквенный код страны, например, “RU”, “US”.

$geoip_city_country_code3

трёхбуквенный код страны, например, “RUS”, “USA”.

$geoip_city_country_name

название страны, например, “Russian Federation”, “United States”.

$geoip_dma_code

DMA-код региона в США (также известный как “код агломерации”), согласно геотаргетингу Google AdWords API.

Данная переменная может содержать неактуальную информацию, т.к. соответствующее поле базы данных объявлено устаревшим.

$geoip_latitude

широта.

$geoip_longitude

долгота.

$geoip_region

код региона страны (область, край, штат, провинция, федеральная земля и тому подобное).

$geoip_region_name

название региона страны (область, край, штат, провинция, федеральная земля и тому подобное), например, “Moscow City”, “District of Columbia”.

$geoip_city

название города, например, “Moscow”, “Washington”.

$geoip_postal_code

почтовый индекс.

Задаёт базу данных для определения названия организации в зависимости от значения IP-адреса клиента. При использовании этой базы данных доступна следующая переменная:

$geoip_org

название организации, например, “The University of Melbourne”.

Задаёт доверенные адреса, при запросе с которых будет использоваться адрес в переданном поле заголовка запроса “X-Forwarded-For”.

geoip_proxy_recursive off;

При выключенном рекурсивном поиске вместо исходного адреса клиента, совпадающего с одним из доверенных адресов, будет использоваться последний адрес, переданный в “X-Forwarded-For”. При включённом рекурсивном поиске вместо исходного адреса клиента, совпадающего с одним из доверенных адресов, будет использоваться последний не доверенный адрес, переданный в “X-Forwarded-For”.