<!-- review: finished -->

<a id="http-geoip"></a>

# GeoIP

Создает переменные, значения которых зависят от IP-адреса клиента, используя
готовые базы данных [MaxMind](http://www.maxmind.com/)
или их аналоги.

При использовании баз данных с поддержкой IPv6
IPv4-адреса ищутся отображенными на IPv6.

При [сборке из исходного кода](https://angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) модуль не собирается по умолчанию; его необходимо
включить с помощью [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#configure)
`‑‑with‑http_geoip_module`.

#### NOTE
Для этого модуля нужна база данных MaxMind [MaxMind GeoIP](https://www.maxmind.com/en/geoip-databases)
или ее аналог,
например [MaxMind GeoLite2](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data)
или [ЦМУ ССОП](https://geoip.noc.gov.ru/).

<a id="configuration-example-17"></a>

## Пример конфигурации

```nginx
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;
    ...
```

<a id="directives-18"></a>

## Директивы

<a id="index-0"></a>

<a id="geoip-country"></a>

### geoip_country

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_country` файл;   |
|------------------------------------------------------------------------------------------|-------------------------|
| По умолчанию                                                                             | —                       |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http                    |

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

| `$geoip_country_code`   | двухбуквенный код страны, например, "RU", "US".                   |
|-------------------------|-------------------------------------------------------------------|
| `$geoip_country_code3`  | трехбуквенный код страны, например, "RUS", "USA".                 |
| `$geoip_country_name`   | название страны, например, "Russian Federation", "United States". |

<a id="index-1"></a>

<a id="geoip-city"></a>

### geoip_city

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_city` файл;   |
|------------------------------------------------------------------------------------------|----------------------|
| По умолчанию                                                                             | —                    |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http                 |

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

| `$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-код региона в США (также известный как "код агломерации"), согласно [геотаргетингу](https://developers.google.com/adwords/api/docs/appendix/cities-DMAregions) 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`           | почтовый индекс.                                                                                                                                                                       |

<a id="index-2"></a>

<a id="geoip-org"></a>

### geoip_org

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_org` файл;   |
|------------------------------------------------------------------------------------------|---------------------|
| По умолчанию                                                                             | —                   |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http                |

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

| `$geoip_org`   | название организации, например, "The University of Melbourne".   |
|----------------|------------------------------------------------------------------|

<a id="index-3"></a>

<a id="geoip-proxy"></a>

### geoip_proxy

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_proxy` файл;   |
|------------------------------------------------------------------------------------------|-----------------------|
| По умолчанию                                                                             | —                     |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http                  |

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

<a id="index-4"></a>

<a id="geoip-proxy-recursive"></a>

### geoip_proxy_recursive

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_proxy_recursive` `on` | `off`;   |
|------------------------------------------------------------------------------------------|-----------------------------------------|
| По умолчанию                                                                             | `geoip_proxy_recursive off;`            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http                                    |

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