Initial Commit

Initial first commit to Github

Author: Know1

.gitignore

@@ -0,0 +1,3 @@
+venv/
+iplookup/__pycache__/
+instance/.geoipupdate.lock

GeoIP.conf.sample

@@ -0,0 +1,10 @@
+# The following AccountID and LicenseKey are required placeholders.
+# For geoipupdate versions earlier than 2.5.0, use UserId here instead of AccountID.
+AccountID 0
+LicenseKey 000000000000
+
+# Include one or more of the following edition IDs:
+# * GeoLite2-City - GeoLite 2 City
+# * GeoLite2-Country - GeoLite2 Country
+# For geoipupdate versions earlier than 2.5.0, use ProductIds here instead of EditionIDs.
+EditionIDs GeoLite2-City GeoLite2-Country GeoLite2-ASN

INSTALL.md

@@ -0,0 +1,35 @@
+1. Install the GeoIP2 Python libraries
+  pip3 install geoip2
+
+2. Install the Python flask framework
+  pip3 install flask
+
+3. Install Gunicorn to run flask as a service
+  pip3 install gunicorn
+
+4. Clone the Git to target directory
+  git clone <repo_url> /opt/geoip2
+
+5. Run it Interactively as a test
+  cd /opt/geoip2
+  gunicorn --pid /run/geoip2.pid -b localhost:5001 iplookup
+
+You should now be able to connect to http://localhost:5001
+
+Optional setup:
+1. Set IPLookup to run as a service
+  cp /opt/geoip2/geoip2.service.sample /etc/systemd/system/geoip2.service
+  systemctl daemon-reload
+  systemctl enable geoip2.service
+  systemctl start geoip2.service
+
+2. Configure Apache2 as a reverse proxy to the service
+  cp /opt/geoip2/iplookup.conf.sample /etc/apache2/sites-available/iplookup.conf
+  a2ensite iplookup
+  systemctl reload apache2
+
+3. Refresh the Maxmind GeoIP DBs regularly
+  apt install geoipupdate
+  cp /opt/geoip2/GeoIP.conf.sample /etc/GeoIP.conf
+  cp /opt/geoip2/geoipupdate.crond.sample /etc/cron.d/geoipupdate
+

README.md

@@ -0,0 +1,7 @@
+# IPLookup
+
+This code runs an API that when called with and IPv4 or IPv6 address will return the GeoLocation details
+e.g
+
+  http://localhost:5001/128.184.1.1
+    {"response":{"city":{"geoname_id":2169236,"names":{"en":"Deakin"}}}}}

geoip2.service.sample

@@ -0,0 +1,16 @@
+[Unit]
+Description = Gunicorn instance to serve GeoIP2 Lookup
+After = network.target
+
+[Service]
+user = www-data
+group = www-data
+WorkingDirectory = /opt/geoip2
+PIDFile=/run/geoip2.pid
+ExecStart = /usr/local/bin/gunicorn --pid /run/geoip2.pid -b localhost:5001 iplookup
+ExecReload=/bin/kill -s HUP $MAINPID
+ExecStop=/bin/kill -s TERM $MAINPID
+
+[Install]
+WantedBy = multi-user.target
+

geoipupdate.crond.sample

@@ -0,0 +1,4 @@
+# Sample cron file to update Maxmind GeoIP2 DB files regularly
+45 12 * * 3 root /usr/bin/geoipupdate -d /opt/geoip2/instance
+
+

iplookup.conf.sample

@@ -0,0 +1,20 @@
+<VirtualHost *:80>
+    ProxyPreserveHost On
+
+    ServerName iplookup.mydomain
+
+    Alias /static /opt/geoip2/iplookup/static
+
+    <Directory /opt/geoip2/iplookup/static>
+        Options Indexes FollowSymLinks MultiViews
+        AllowOverride None
+        Require all granted
+    </Directory>
+
+    <Location /static>
+        ProxyPass !
+    </Location>
+
+    ProxyPass / http://127.0.0.1:5001/
+    ProxyPassReverse / http://127.0.0.1:5001/
+</VirtualHost>