Модуль ngx_http_geoip_module
Пример конфигурации Директивы geoip_country geoip_city geoip_org geoip_proxy geoip_proxy_recursive |
Модуль ngx_http_geoip_module
(0.8.6+) создаёт переменные,
значения которых зависят от IP-адреса клиента, используя готовые базы данных
MaxMind.
При использовании баз данных с поддержкой IPv6 (1.3.12, 1.2.7) IPv4-адреса ищутся отображёнными на IPv6.
По умолчанию этот модуль не собирается, его сборку необходимо
разрешить с помощью конфигурационного параметра
--with-http_geoip_module
.
Для сборки и работы этого модуля нужна библиотека MaxMind GeoIP.
Пример конфигурации
http { geoip_country GeoIP.dat; geoip_city GeoLiteCity.dat; geoip_proxy 192.168.100.0/24; geoip_proxy 2001:0db8::/32; geoip_proxy_recursive on; ...
Директивы
Синтаксис: |
geoip_country |
---|---|
Умолчание: | — |
Контекст: |
http |
Задаёт базу данных для определения страны в зависимости от значения IP-адреса клиента. При использовании этой базы данных доступны следующие переменные:
$geoip_country_code
-
двухбуквенный код страны, например,
“
RU
”, “US
”. $geoip_country_code3
-
трёхбуквенный код страны, например,
“
RUS
”, “USA
”. $geoip_country_name
-
название страны, например,
“
Russian Federation
”, “United States
”.
Синтаксис: |
geoip_city |
---|---|
Умолчание: | — |
Контекст: |
http |
Задаёт базу данных для определения страны, региона и города в зависимости от значения 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
-
двухсимвольный код региона страны (область, край, штат,
провинция, федеральная земля и тому подобное), например,
“
48
”, “DC
”. $geoip_region_name
-
название региона страны (область, край, штат,
провинция, федеральная земля и тому подобное), например,
“
Moscow City
”, “District of Columbia
”. $geoip_city
-
название города, например,
“
Moscow
”, “Washington
”. $geoip_postal_code
- почтовый индекс.
Синтаксис: |
geoip_org |
---|---|
Умолчание: | — |
Контекст: |
http |
Эта директива появилась в версии 1.0.3.
Задаёт базу данных для определения названия организации в зависимости от значения IP-адреса клиента. При использовании этой базы данных доступна следующая переменная:
$geoip_org
- название организации, например, “The University of Melbourne”.
Синтаксис: |
geoip_proxy |
---|---|
Умолчание: | — |
Контекст: |
http |
Эта директива появилась в версиях 1.3.0 и 1.2.1.
Задаёт доверенные адреса, при запросе с которых будет использоваться адрес в переданном поле заголовка запроса “X-Forwarded-For”.
Синтаксис: |
geoip_proxy_recursive |
---|---|
Умолчание: |
geoip_proxy_recursive off; |
Контекст: |
http |
Эта директива появилась в версиях 1.3.0 и 1.2.1.
При выключенном рекурсивном поиске вместо исходного адреса клиента, совпадающего с одним из доверенных адресов, будет использоваться последний адрес, переданный в “X-Forwarded-For”. При включённом рекурсивном поиске вместо исходного адреса клиента, совпадающего с одним из доверенных адресов, будет использоваться последний не доверенный адрес, переданный в “X-Forwarded-For”.