Skip to content

Load/Convert multiple GEOIP CSV databases into Redis via IP2Location format.

License

Notifications You must be signed in to change notification settings

ConsulTent/geoip2redis

Repository files navigation

GeoIP2Redis

Go

Loader of Multiple GeoIP providers to Redis. Now with LIVE MIGRATION!

geoip-docker2

The goal of GeoIP2Redis is to standardise all GeoIP formats into a standard CSV format (based on Ip2Location) that can be queried using Redis via subkeys.

Why GeoIP via Redis?

  • It's FAST!
  • Much faster than a REST API.
  • Low Latency:
    • Local vs Internet traffic
    • Much less overhead via Redis protocol vs HTTP

We currently fully support the following providers:


  • GeoIP2Redis primarily supports DB1 & DB3 DB formats from IP2Location. Through conversion, we also fully support MaxMind's Block and Location databases. We also provide a tool to convert MaxMind's Blocks and Location tables to a unified IP2Location format.
  • It can also load Software77's database either in it's native format, or convert it on the fly to IP2Location format, making them interchangeable. * Software77 is gone, and support is now deprecated.

Please see the Wiki for usage and additional MaxMind support.


Basic Telemetry is included. Please see the Wiki.

Coming Soon

Examples:

Use example1

Redis output

Please check out the the Wiki for more info.

TODO

  1. Testing - need to add golang tests
  2. ASN support for ip2location.
  3. Add more GEOIP sources. Suggestions welcome!

Disclaimer

IP2Location, Maxmind, Software77 and Redis are trademarks of their respective owners.

(c) 2021 ConsulTent Pte. Ltd. https://consultent.ltd

Leading IP Geolocation solution provider to pinpoint the location of an IP address