# GeoIP2
El módulo GeoIP2 implementa búsquedas en bases de datos MaxMind GeoIP2 por la dirección IP del cliente (por defecto) o por el valor de una variable específica. Soporta tanto IPv4 como IPv6.
## Instalación
Para [instalar](https://es.angie.software//angie/docs/installation/index.md#install-packages) el módulo, utiliza uno de los siguientes paquetes:
- Angie: `angie-module-geoip2`
- Angie PRO: `angie-pro-module-geoip2`
## Carga del Módulo
Para trabajar con el módulo, es necesario cargarlo en el contexto `main{}`:
```nginx
load_module modules/ngx_http_geoip2_module.so; # para usar en el bloque http{}
load_module modules/ngx_stream_geoip2_module.so; # para usar en el contexto stream{}
```
En el ejemplo de configuración a continuación, además de las directivas del módulo en sí, también se utilizan las directivas del módulo [echo](https://es.angie.software//angie/docs/installation/external-modules/echo.md#external-echo):
```nginx
load_module modules/ngx_http_echo_module.so;
```
## Ejemplo de Configuración
```nginx
http {
geoip2 /var/lib/GeoIP/GeoLite2-Country.mmdb {
auto_reload 1h;
$geoip2_country_code default=RU source=$http_x_forwarded_for country iso_code;
$geoip2_country_name source=$http_x_forwarded_for country names ru;
}
log_format with_geoip '$server_port $remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for" "$http_host" '
'country="$geoip2_country_code"';
map $geoip2_country_code $denied {
PL "1";
QA "1";
}
server {
listen 80;
root /usr/share/angie/html;
index index.html index.htm;
access_log /var/log/angie/geoip_access.log with_geoip;
if ($denied) {
return 403;
}
location / {
echo "ip = $http_x_forwarded_for";
echo "code = $geoip2_country_code";
echo "name = $geoip2_country_name";
}
}
}
```
## Ejemplos de Ejecución de Peticiones
```console
$ curl -H'X-Forwarded-For: 51.68.138.153' http://127.0.0.1
403 Forbidden
403 Forbidden
Angie/|angie_version|
```
```console
$ curl -H'X-Forwarded-For: 8.8.8.8' http://127.0.0.1
ip = 8.8.8.8
code = US
name = United States
```
```console
$ curl -H'X-Forwarded-For: 77.88.44.242' http://127.0.0.1
ip = 77.88.44.242
code = RU
name = Russia
```
## Información Adicional
La documentación detallada y el código fuente están disponibles en:
[https://github.com/leev/ngx_http_geoip2_module](https://github.com/leev/ngx_http_geoip2_module)