Entradas Mensuales

Síguenos en:

Canal Oficial Telegram de elhacker.NET Grupo Facebook elhacker.NET Twitter elhacker.NET Canal Youtube elhacker.NET Comunidad Steam: Grupo elhacker.NET Mastodon

Entradas populares

PostHeaderIcon Guía de Geolocalización con nginx: GeoIP2


 GeoIP2 NGINXofrece potentes capacidades de geolocalización para el control de acceso, la localización de contenido y la analítica. Con el repositorio, la instalación es sencilla y el módulo se integra perfectamente con los paquetes estándar de NGINX.


 

 

  •  La combinación del módulo GeoIP2 y las bases de datos de MaxMind permite un enrutamiento sofisticado basado en la ubicación sin modificar el código de la aplicación. Ya sea que necesites cumplir con normativas regionales, optimizar la entrega de contenido o reforzar la seguridad, GeoIP2 te proporciona las herramientas necesarias para implementar políticas geográficas a nivel del servidor web.

GeoIP2 NGINX : Guía de geolocalización

GetPageSpeed mantiene los servidores NGINX y Varnish rápidos y seguros: módulos y compilaciones de rendimiento, además de parches de seguridad en cuestión de días, todo mediante actualizaciones rutinarias con dnf, yum o apt. Mantiene el mayor repositorio RPM de paquetes de módulos NGINX y VMOD de Varnish, con paquetes APT para Debian y Ubuntu.

GeoIP2 NGINX permite el control de acceso basado en la ubicación geográfica, la personalización de contenido y la analítica para tus aplicaciones web. El módulo GeoIP2 lee bases de datos de MaxMind para determinar la ubicación de los visitantes a partir de sus direcciones IP, lo que te permite ofrecer contenido localizado, bloquear el tráfico de países específicos o redirigir a los usuarios a servidores regionales.

Esta guía completa te muestra cómo instalar y configurar el módulo GeoIP2 para NGINX Aprenderás a configurar las bases de datos de MaxMind, establecer el enrutamiento basado en la ubicación e implementar el bloqueo geográfico. Al finalizar, tendrás GeoIP2 NGINX realizando consultas de geolocalización en cada petición.

Por qué usar GeoIP2 con NGINX

El módulo GeoIP2 proporciona potentes capacidades de geolocalización directamente en NGINX. Estos son los principales casos de uso para GeoIP2 NGINX :

  • Localización de contenido: Ofrece contenido, monedas o idiomas específicos de cada región de forma automática
  • Control de acceso geográfico: Bloquea o permite el tráfico procedente de países o regiones específicos
  • Balanceo de carga: Redirige a los usuarios al centro de datos o servidor más cercano
  • Cumplimiento normativo: Restringe el acceso para cumplir con requisitos legales (RGPD, residencia de datos)
  • Analítica: Enriquece los registros de acceso con datos geográficos para obtener mejores métricas
  • Prevención del fraude: Marca o bloquea peticiones procedentes de regiones de alto riesgo

El módulo es compatible tanto con las bases de datos GeoIP2 como GeoLite2 de MaxMind, leyendo el formato altamente eficiente MMDB para realizar consultas rápidas con un uso mínimo de memoria.

Requisitos previos

Antes de instalar los paquetes de GeoIP2 NGINX  asegúrate de contar con:

  • Acceso root o sudo al servidor
  • NGINX instalado (o lo instalaremos en esta guía)
  • Una cuenta de MaxMind para descargar las bases de datos (registro gratuito)

El repositorio de GetPageSpeed proporciona módulos GeoIP2 precompilados que se integran perfectamente con el paquete estándar de NGINX.

Instalación

Paso 1: Configurar el repositorio de GetPageSpeed

El repositorio de GetPageSpeed ofrece módulos de NGINX de nivel empresarial, incluido GeoIP2, para distribuciones basadas en RHEL. Instala el repositorio:

sudo dnf -y install https://extras.getpagespeed.com/release-latest.rpm

Paso 2: Instalar NGINX

Si NGINX aún no está instalado, instálalo desde el repositorio:

sudo dnf -y install nginx
sudo systemctl enable --now nginx

Paso 3: Instalar el módulo GeoIP2

Instala el módulo GeoIP2 de NGINX:

sudo dnf -y install nginx-module-geoip2

La instalación proporciona dos módulos:

  • ngx_http_geoip2_module: Para la geolocalización de tráfico HTTP
  • ngx_stream_geoip2_module: Para la geolocalización de flujos TCP/UDP

Tras la instalación, verás lo siguiente:

----------------------------------------------------------------------

The nginx-module-geoip2 package has been installed.
To enable this module, add the following to /etc/nginx/nginx.conf
and reload NGINX:

    load_module modules/ngx_http_geoip2_module.so;
    load_module modules/ngx_stream_geoip2_module.so;

----------------------------------------------------------------------

Paso 4: Instalar la biblioteca MaxMind

La biblioteca libmaxminddb es necesaria para leer los archivos de bases de datos MMDB:

sudo dnf -y install libmaxminddb

Paso 5: Obtener las bases de datos de MaxMind

MaxMind ofrece dos tipos de bases de datos:

  • GeoLite2: Bases de datos gratuitas con datos de países y ciudades
  • GeoIP2: Bases de datos comerciales con mayor precisión

Para descargar las bases de datos GeoLite2, regístrate para obtener una cuenta gratuita en maxmind.com y, a continuación, ejecuta:

# Crear el directorio de bases de datos
sudo mkdir -p /usr/share/GeoIP

# Descargar usando tu clave de licencia de MaxMind
cd /usr/share/GeoIP
sudo curl -O "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-Country&license_key=YOUR_LICENSE_KEY&suffix=tar.gz"
sudo curl -O "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=YOUR_LICENSE_KEY&suffix=tar.gz"

# Extraer las bases de datos
sudo tar -xzf GeoLite2-Country*.tar.gz --strip-components=1
sudo tar -xzf GeoLite2-City*.tar.gz --strip-components=1

Como alternativa, utiliza la herramienta oficial de actualización de GeoIP:

sudo dnf -y install geoipupdate

# Configurar /etc/GeoIP.conf con tus credenciales
sudo geoipupdate

Paso 6: Habilitar el módulo

Añade la directiva de carga del módulo al principio de tu configuración de NGINX:

# /etc/nginx/nginx.conf
load_module modules/ngx_http_geoip2_module.so;

user nginx;
worker_processes auto;
# ... resto de la configuración

Configuración básica

Definir la base de datos GeoIP2

Configura la ruta de la base de datos y define las variables en el bloque http:

http {
    # Cargar la base de datos GeoIP2
    geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
        auto_reload 60m;
        $geoip2_metadata_country_build metadata build_epoch;
        $geoip2_data_country_code default=XX source=$remote_addr country iso_code;
        $geoip2_data_country_name country names en;
    }

    # ... resto de la configuración
}

Explicación de las directivas de configuración

geoip2 define una base de datos y sus variables:

geoip2 /path/to/database.mmdb {
    $variable_name path to data;
}

auto_reload habilita la recarga automática de la base de datos:

auto_reload 60m;  # Recargar cada 60 minutos

source especifica el origen de la dirección IP (útil para peticiones a través de proxy):

$geoip2_data_country_code source=$http_x_forwarded_for country iso_code;

default establece un valor alternativo cuando falla la consulta:

$geoip2_data_country_code default=US country iso_code;

Campos de datos disponibles

Para la base de datos GeoLite2-Country:

  • country iso_code – Código de país de dos letras (US, GB, DE)
  • country names en – Nombre del país en inglés
  • continent code – Código de continente (NA, EU, AS)
  • registered_country iso_code – Código del país registrado

Para la base de datos GeoLite2-City (campos adicionales):

  • city names en – Nombre de la ciudad
  • subdivisions 0 iso_code – Código de estado o provincia
  • subdivisions 0 names en – Nombre de estado o provincia
  • location latitude – Latitud
  • location longitude – Longitud
  • location time_zone – Zona horaria

Ejemplos de configuración habituales

Control de acceso basado en países

Bloquea el tráfico procedente de países específicos:

http {
    geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
        $geoip2_data_country_code country iso_code;
    }

    # Mapear países bloqueados
    map $geoip2_data_country_code$blocked_country {
        default 0;
        CN 1;  # China
        RU 1;  # Rusia
        KP 1;  # Corea del Norte
    }

    server {
        listen 80;

        if ($blocked_country) {
            return 403;
        }

        location / {
            root /usr/share/nginx/html;
        }
    }
}

Permitir solo países específicos

Enfoque de lista blanca para restringir el acceso:

map $geoip2_data_country_code$allowed_country {
    default 0;
    US 1;
    CA 1;
    GB 1;
    DE 1;
}

server {
    listen 80;

    if ($allowed_country = 0) {
        return 403;
    }

    # ... resto de la configuración
}

Balanceo de carga geográfico

Redirige a los usuarios a servidores regionales:

http {
    geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
        $geoip2_data_continent_code continent code;
    }

    # Seleccionar upstream según el continente
    map $geoip2_data_continent_code$backend {
        default us_backend;
        EU eu_backend;
        AS asia_backend;
    }

    upstream us_backend {
        server us1.example.com;
        server us2.example.com;
    }

    upstream eu_backend {
        server eu1.example.com;
        server eu2.example.com;
    }

    upstream asia_backend {
        server asia1.example.com;
        server asia2.example.com;
    }

    server {
        listen 80;

        location / {
            proxy_pass http://$backend;
        }
    }
}

Añadir geolocalización a los registros (logs)

Enriquece los registros de acceso con datos geográficos:

http {
    geoip2 /usr/share/GeoIP/GeoLite2-City.mmdb {
        $geoip2_data_country_code country iso_code;
        $geoip2_data_city_name city names en;
    }

    log_format geo '$remote_addr - $remote_user [$time_local] '
                   '"$request" $status $body_bytes_sent '
                   '"$http_referer" "$http_user_agent" '
                   '$geoip2_data_country_code $geoip2_data_city_name';

    access_log /var/log/nginx/access.log geo;
}

Localización de contenido

Ofrece contenido diferente según la ubicación:

http {
    geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
        $geoip2_data_country_code country iso_code;
    }

    server {
        listen 80;

        location / {
            root /usr/share/nginx/html/$geoip2_data_country_code;
            try_files $uri $uri/ /default$uri /default/index.html;
        }
    }
}

Gestión de peticiones a través de proxy

Cuando NGINX está detrás de un proxy inverso o balanceador de carga, utiliza la cabecera X-Forwarded-For:

geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
$geoip2_data_country_code source=$http_x_forwarded_for country iso_code;
}

Para múltiples capas de proxy, extrae la IP original del cliente:

# Get the first IP from X-Forwarded-For
map $http_x_forwarded_for $client_ip {
    default $remote_addr;
    ~^(?P<first_ip>[^,]+) $first_ip;
}

geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
    $geoip2_data_country_code source=$client_ip country iso_code;
}

Actualizaciones automáticas de las bases de datos

Configura las actualizaciones automáticas de las bases de datos GeoIP mediante geoipupdate:

# Instalar geoipupdate
sudo dnf -y install geoipupdate

# Configurar credenciales
sudo tee /etc/GeoIP.conf > /dev/null << 'EOF'
AccountID YOUR_ACCOUNT_ID
LicenseKey YOUR_LICENSE_KEY
EditionIDs GeoLite2-Country GeoLite2-City
DatabaseDirectory /usr/share/GeoIP
EOF

# Descarga inicial
sudo geoipupdate

# Añadir tarea cron semanal
echo "0 3 * * 0 root /usr/bin/geoipupdate" | sudo tee /etc/cron.d/geoipupdate

NGINX recarga la base de datos automáticamente cuando auto_reload está configurado.

Verificación

Después de configurar GeoIP2 NGINX  verifica la instalación.

Probar la configuración

sudo nginx -t

Comprobar los valores de las variables

Añade una ubicación (location) de prueba para mostrar los datos de geolocalización:

location /geotest {
    default_type text/plain;
    return 200 "Country: $geoip2_data_country_codenCity: $geoip2_data_city_namen";
}

Prueba con curl:

curl http://localhost/geotest

Probar con una IP específica

Utiliza la directiva source para realizar pruebas con una IP conocida:

# Temporary test configuration
geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
    $geoip2_test source=8.8.8.8 country iso_code;  # Google DNS (US)
}

Solución de problemas

Base de datos no encontrada

Síntoma: geoip2: cannot open database

Soluciones:

  1. Verifica que la ruta de la base de datos exista: ls -la /usr/share/GeoIP/
  2. Comprueba los permisos de los archivos: chmod 644 /usr/share/GeoIP/*.mmdb
  3. Asegúrate de que SELinux permita el acceso

La variable siempre está vacía

Síntoma: Las variables GeoIP devuelven valores vacíos

Soluciones:

  1. Verifica que la base de datos contenga información para ese rango de IP
  2. Comprueba que la ruta de la variable coincida con la estructura de la base de datos
  3. Realiza pruebas con una IP pública conocida, no con localhost

Rendimiento de las consultas

Para sitios con alto tráfico, ten en cuenta estas optimizaciones:

  1. Utiliza almacenamiento SSD para los archivos de las bases de datos
  2. Asegura suficiente memoria para el almacenamiento en caché de las bases de datos
  3. Usa la base de datos solo de países si no necesitas datos de ciudades

Compatibilidad con SELinux

El paquete nginx-module-geoip2 de GetPageSpeed funciona correctamente con SELinux. Asegúrate de que los archivos de las bases de datos tengan el contexto adecuado:

sudo restorecon -Rv /usr/share/GeoIP/

Configuración completa para producción

Aquí tienes una configuración completa de GeoIP2 NGINX :

# /etc/nginx/nginx.conf
load_module modules/ngx_http_geoip2_module.so;

user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

events {
    worker_connections 1024;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    # GeoIP2 database configuration
    geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
        auto_reload 60m;
        $geoip2_data_country_code default=XX country iso_code;
        $geoip2_data_country_name country names en;
    }

    # Geo-enhanced log format
    log_format geo_combined '$remote_addr - $remote_user [$time_local] '
                            '"$request" $status $body_bytes_sent '
                            '"$http_referer" "$http_user_agent" '
                            '$geoip2_data_country_code';

    access_log /var/log/nginx/access.log geo_combined;

    sendfile on;
    keepalive_timeout 65;

    server {
        listen 80;
        server_name example.com;

        # Add country code header for debugging
        add_header X-Country-Code $geoip2_data_country_code;

        location / {
            root /usr/share/nginx/html;
            index index.html;
        }
    }
}

Prueba y aplica los cambios:

sudo nginx -t && sudo systemctl reload nginx

Conclusión


Recuerda mantener tus bases de datos de MaxMind actualizadas periódicamente para obtener resultados de geolocalización precisos. La función auto_reload y la herramienta geoipupdate hacen que este proceso sea automático y fiable.

 

Fuentes:

https://www.getpagespeed.com/server-setup/nginx/geoip2-nginx-rocky-linux-10