# GeoIP2
Модуль GeoIP2 реализует поиск в базах MaxMind GeoIP2 по IP-адресу клиента (по
умолчанию) или по значению определенной переменной. Поддерживает как IPv4, так и
IPv6.
## Установка
Для [установки](https://angie.software//angie/docs/installation/index.md#install-packages) модуля используйте один из
следующих пакетов:
- Angie: `angie-module-geoip2`;
- Angie PRO: `angie-pro-module-geoip2`.
## Загрузка модуля
Для работы с модулем необходимо загрузить его в контексте `main{}`:
```nginx
load_module modules/ngx_http_geoip2_module.so; # для использования в блоке http{}
load_module modules/ngx_stream_geoip2_module.so; # для использования в контексте stream{}
```
В приведённом ниже примере конфигурации, помимо директив самого модуля,
используются также директивы модуля [echo](https://angie.software//angie/docs/installation/external-modules/echo.md#external-echo):
```nginx
load_module modules/ngx_http_echo_module.so;
```
## Пример конфигурации
```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";
}
}
}
```
## Примеры выполнения запросов
```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 = США
```
```console
$ curl -H'X-Forwarded-For: 77.88.44.242' http://127.0.0.1
ip = 77.88.44.242
code = RU
name = Россия
```
## Дополнительная информация
Подробная документация и исходный код доступны по ссылке:
[https://github.com/leev/ngx_http_geoip2_module](https://github.com/leev/ngx_http_geoip2_module)