Geolocalizacion IP con MaxMind e ipapi¶

Estado verificado al 28 de marzo de 2026. Nota de runtime: FastFN auto-instala dependencias locales por función desde requirements.txt / package.json; en fastfn dev --native necesitas runtimes instalados en host, mientras que fastfn dev depende de Docker daemon activo. Este articulo muestra una implementacion practica de ip -> country con dos ejemplos de FastFN:

/ip-intel/maxmind: lookup local usando MMDB tipo MaxMind (GeoLite2-Country.mmdb).
/ip-intel/remote: lookup remoto con un servicio HTTP estilo ipapi.

Ejecutar ejemplos¶

bin/fastfn dev examples/functions

1) Lookup local con MaxMind¶

Prueba deterministica (sin archivo MMDB):

curl -s "http://127.0.0.1:8080/ip-intel/maxmind?ip=8.8.8.8&mock=1"

Lookup real con MMDB:

# Instala dependencia Python una vez en la carpeta de la funcion:
#   echo "maxminddb>=2.6.2" > examples/functions/ip-intel/requirements.txt
# Luego reinicia fastfn dev para que el runtime la instale.
MAXMIND_DB_PATH=/ruta/absoluta/GeoLite2-Country.mmdb \
curl -s "http://127.0.0.1:8080/ip-intel/maxmind?ip=8.8.8.8"

Forma de respuesta:

{
  "ok": true,
  "provider": "maxmind",
  "ip": "8.8.8.8",
  "country_code": "US",
  "country_name": "United States"
}

2) Lookup remoto estilo ipapi¶

Modo deterministico para pruebas:

curl -s "http://127.0.0.1:8080/ip-intel/remote?ip=8.8.8.8&mock=1"

Lookup real remoto:

IPAPI_BASE_URL=https://ipapi.co \
curl -s "http://127.0.0.1:8080/ip-intel/remote?ip=8.8.8.8"

El handler espera endpoints con patron /{ip}/json/ y normaliza campos comunes: country_code, country_name, city, region.

Pruebas incluidas¶

Unitarias:

python3 tests/unit/test-python-handlers.py
node tests/unit/test-node-handler.js

Integracion (incluye ambas rutas de geolocalizacion):

bash tests/integration/test-api.sh

Idea clave¶

Este artículo te deja dos caminos funcionales para el mismo problema: lookup local con base de datos cuando querés latencia estable y más control, y lookup remoto cuando querés la puesta en marcha más corta posible. Ambos devuelven el mismo formato normalizado, así que el cliente no depende del proveedor.

Qué conviene tener en cuenta¶

Probá primero con mock=1 para tener tests repetibles antes de conectar el proveedor real.
Si usás MaxMind local, renová la base de datos en forma periódica.
Mantené estable la forma de la respuesta aunque el proveedor agregue más campos.

Cuándo elegir la otra opción¶

Elegí MMDB local cuando importan la privacidad, la latencia predecible o el modo offline.
Elegí un proveedor remoto cuando no querés descargar ni refrescar bases de datos.
Evitá hacer geolocalización inline en cada request caliente si podés cachear el resultado antes.

Ver también¶

Última revisión: 28 de marzo de 2026 · Docs en fastfn.dev