Python Flask GeoLite2 City service
Running
Using Flask only (development)
$ python3 app.py
Using UWSGI (example)
$ uwsgi --master --http 0.0.0.0:8888 --module app:app --processes 4
Using the Docker image
$ docker pull supermasita/geoip-flask
$ docker run -d --env GEOIP_APP_ENDPOINT=http://example.com:8888 -p 8888:8888 -t supermasita/geoip-flask
Note that the Docker image runs uWSGI in the following way:
$ /usr/local/bin/uwsgi --master --http 0.0.0.0:8888 --chdir /opt/geoip-flask/ --module app:app --processes 4 --stats 0.0.0.0:9191 --stats-http
Running behind a proxy
The app will look for the header X-Real-IP, and if its present, it will be used instead of the
remote address in the request. The header can be customized using the GEOIP_APP_PROXY_IP_HEADER
OS variable.
Usage
- Get information of your IP: https://your-endpoint.com/
- Get information of IP 63.245.208.212: https://your-endpoint.com/63.245.208.212
- Get information of your IP (JSON): https://your-endpoint.com/api/v1.0/ip/
- Get information of IP 63.245.208.212 (JSON): https://your-endpoint.com/api/v1.0/ip/63.245.208.212
Configuration via OS variables
The following OS variables can be set to override config.py:
GEOIP_DB_LOCATION("GeoLite2-City/GeoLite2-City.mmdb")GEOIP_APP_HOST("0.0.0.0")GEOIP_APP_PORT("8888")GEOIP_APP_DEBUG(False)GEOIP_APP_ENDPOINT("http://geoip.supermasita.com:8888")GEOIP_APP_TITLE("A service for MaxMind's GeoIP DB using Flask")GEOIP_APP_PROXY_IP_HEADER("X-Real-IP")
If you are running a Docker image, you can use docker run -e GEOIP_APP_ENDPOINT=http://example.com ....
Getting updated Maxmind DB
Due to changes in how Maxmind allows to download updated versions of their DBs, ATM there is no built in process to periodically update it. To do so you can either directly download the GeoIP DB and build (see Dockerfile) or use the updated Docker image from Dockerhub.
Credits
- We use GeoLite2 data created by Maxmind