This is the geoipd tool. It's intention is to provide a simple HTTP server which uses the MaxMind GeoLite2 Database to:
- translate between IPs to geo locations
- render IPs on a map
All the usages of this software have to comply with maxmind's end user license agreement. I distance myself from usages that do not comply with the aforementioned end user license agreement.
This is the example rendering that was rendered by locating the ip adress 1.1.1.1
:
Pick one of the release tarballs.
If you have linux machine with amd64, you can use this oneliner instead:
curl -s https://api.github.com/repos/4thel00z/geoipd/releases/latest |grep "browser_download_url"| cut -d '"' -f 4| grep linux| grep amd64| wget -qi -
You need to enter a your MaxMind License key which you can obtain from here: https://www.maxmind.com/en/accounts/<user-id>/license-key
In an .env file like so:
MAX_MIND_KEY=<enter you key>
then you can update/download the database from inside this repository.
Run make run
afterwards to have a new working geoipd instance under build/geoipd
.
After creating a new project like above you can simply run:
make run
or
just run
if you have just installed.
Running make help
will show you the rest of the targets.
This project is licensed under the GPL-3 license.