<!-- review: finished -->

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

# GeoIP

Cria variáveis com valores dependendo do endereço IP do cliente,
usando os bancos de dados pré-compilados [MaxMind](http://www.maxmind.com/)
ou suas contrapartes.

Ao usar os bancos de dados com suporte IPv6,
endereços IPv4 são pesquisados como endereços IPv6 mapeados para IPv4.

Ao [compilar a partir do código fonte](https://pt.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild),
este módulo não é compilado por padrão;
ele deve ser habilitado com a
`‑‑with‑http_geoip_module`
[opção de compilação](https://pt.angie.software//angie/docs/installation/sourcebuild.md#configure).

#### NOTE
Este módulo requer o banco de dados [MaxMind GeoIP](https://www.maxmind.com/en/geoip-databases)
ou uma contraparte como [MaxMind GeoLite2](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data).

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

## Exemplo de Configuração

```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>

## Diretivas

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

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

### geoip_country

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_country` arquivo;   |
|-------------------------------------------------------------------------------------------|----------------------------|
| Padrão                                                                                    | —                          |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http                       |

Especifica um banco de dados usado para determinar o país dependendo do endereço IP do cliente. As seguintes variáveis estão disponíveis ao usar este banco de dados:

| `$geoip_country_code`   | código de país de duas letras, por exemplo, "BR", "US".   |
|-------------------------|-----------------------------------------------------------|
| `$geoip_country_code3`  | código de país de três letras, por exemplo, "BRA", "USA". |
| `$geoip_country_name`   | nome do país, por exemplo, "Brazil", "United States".     |

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

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

### geoip_city

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_city` arquivo;   |
|-------------------------------------------------------------------------------------------|-------------------------|
| Padrão                                                                                    | —                       |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http                    |

Especifica um banco de dados usado para determinar o país, região e cidade dependendo do endereço IP do cliente. As seguintes variáveis estão disponíveis ao usar este banco de dados:

| `$geoip_city_continent_code`   | código de continente de duas letras, por exemplo, "SA", "NA".                                                                                                                                                      |
|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `$geoip_city_country_code`     | código de país de duas letras, por exemplo, "BR", "US".                                                                                                                                                            |
| `$geoip_city_country_code3`    | código de país de três letras, por exemplo, "BRA", "USA".                                                                                                                                                          |
| `$geoip_city_country_name`     | nome do país, por exemplo, "Brazil", "United States".                                                                                                                                                              |
| `$geoip_dma_code`              | código de região DMA nos EUA (também conhecido como "código metro"), de acordo com a [segmentação geográfica](https://developers.google.com/adwords/api/docs/appendix/cities-DMAregions) na API do Google AdWords. |
| `$geoip_latitude`              | latitude.                                                                                                                                                                                                          |
| `$geoip_longitude`             | longitude.                                                                                                                                                                                                         |
| `$geoip_region`                | código de região do país de dois símbolos (região, território, estado, província, terra federal e similares), por exemplo, "SP", "DC".                                                                             |
| `$geoip_region_name`           | nome da região do país (região, território, estado, província, terra federal e similares), por exemplo, "São Paulo", "District of Columbia".                                                                       |
| `$geoip_city`                  | nome da cidade, por exemplo, "São Paulo", "Washington".                                                                                                                                                            |
| `$geoip_postal_code`           | código postal.                                                                                                                                                                                                     |

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

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

### geoip_org

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_org` arquivo;   |
|-------------------------------------------------------------------------------------------|------------------------|
| Padrão                                                                                    | —                      |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http                   |

Especifica um banco de dados usado para determinar a organização dependendo do endereço IP do cliente. A seguinte variável está disponível ao usar este banco de dados:

| `$geoip_org`   | nome da organização, por exemplo, "Universidade de São Paulo".   |
|----------------|------------------------------------------------------------------|

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

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

### geoip_proxy

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_proxy` endereço | CIDR | unix:;   |
|-------------------------------------------------------------------------------------------|------------------------------------------|
| Padrão                                                                                    | —                                        |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http                                     |

Define endereços confiáveis. Quando uma requisição vem de um endereço confiável, um endereço do campo de cabeçalho de requisição `X-Forwarded-For` será usado em seu lugar.

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

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

### geoip_proxy_recursive

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `geoip_proxy_recursive` `on` | `off`;   |
|-------------------------------------------------------------------------------------------|-----------------------------------------|
| Padrão                                                                                    | `geoip_proxy_recursive off;`            |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http                                    |

Se a busca recursiva estiver desabilitada, então em vez do endereço original do cliente que corresponde a um dos endereços confiáveis, o último endereço enviado em `X-Forwarded-For` será usado. Se a busca recursiva estiver habilitada, então em vez do endereço original do cliente que corresponde a um dos endereços confiáveis, o último endereço não confiável enviado em `X-Forwarded-For` será usado.
