HOWTO use geoiplookup

From Fail2ban
Jump to: navigation, search

Geolocalization of banned IPs

You may be interested in a quick summary of the countries where the attacks come from. This document explains how to find these information.


In Gentoo, the needed package is the following :

     Latest version available: 1.3.14
     Latest version installed: [ Not Installed ]
     Size of downloaded files: 1,984 kB
     Description: easily lookup countries by IP addresses, even when Reverse DNS entries don't exist
     License:     GPL-2

This will install "geoiplookup" and "geoipupdate" to update the database (you need a license id to get a new db)

In Debian or Ubuntu, one can simple do apt-get install geoip-bin

In Fedora, you can install with this command:
pkcon install GeoIP


This small script will extract the banned IPs from fail2ban.log. It looks for lines such as "..... Ban", extracts the IP and runs geoiplookup. You may have to change the hardcoded iphone camera apps paths in the script depending on your business blog configuration.

import os
import re
f = open('/var/log/fail2ban.log', 'r')    
pattern = r".*?Ban\s*?((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))$"
p = re.compile(pattern)
for i in f:
        m = p.match(i)
        if m:
                ip =
                file = os.popen('geoiplookup %s' % ip)

There is a package of GeoIP bindings for Python available as well. The following script performs a similar function using those bindings, plus it works on Fedora and any other distro where fail2ban outputs to syslog:

#!/usr/bin/env python
#, improved
import os

import GeoIP
import pyparsing as pp

log_path = '/var/log/fail2ban.log'
if os.path.exists(log_path):
    log = open(log_path, 'r')
    log = open('/var/log/messages', 'r')

geo =
octet = pp.Word(pp.nums, min=1, max=3)
ip_matcher = pp.Combine(octet + ('.' + octet) * 3)

for line in log:
    if 'fail2ban' in line and 'Ban' in line:
        match = ip_matcher.searchString(line)
        if match:
            ip = match.pop()[0]
            code = geo.country_code_by_addr(ip)
            name = geo.country_name_by_addr(ip)
            if not code or not name:
                print "No GeoIP info for IP %s." % ip
                print "GeoIP info for %s:\t%s, %s" % (ip, code, name)


myserver # python
GeoIP Country Edition: CI, Cote D'Ivoire

GeoIP Country Edition: FR, France

GeoIP Country Edition: CN, China

GeoIP Country Edition: KO, South Korea

GeoIP Country Edition: VN, Vietnam


You can also change the fail2ban script to write the country code to the log file whenever a ban occurs. Make sure you install geoiplookup, then edit the file /usr/share/fail2ban/server/ and change line 31 to read

import time, logging, commands

and change line 139 in the __checkBan(self) function from

logSys.warn("[%s] Ban %s" % (self.jail.getName(), aInfo["ip"])

to (changes are in bold)

logSys.warn("[%s] Ban %s %s" % (self.jail.getName(), aInfo["ip"], commands.getstatusoutput('geoiplookup ' + aInfo["ip"])[1][23:]))

This will log output such as

2008-04-27 20:18:03,109 fail2ban.actions: WARNING [ssh] Ban US, United States

If you only want the two character country code, change the line to

logSys.warn("[%s] Ban Smslån blogg %s %s" % (self.jail.getName(), aInfo["ip"], commands.getstatusoutput('geoiplookup ' + aInfo["ip"])[1][23:25]))

Other interesting links

For advanced results, you may be interested in :

Other databases City/Country/ASNum/CountryV6/CityV6/...

Updated GeoIP database

As the geoiplookup database will be pretty outdated (the current included version are from 20060501 in stable debian) you might want to update it regularly as IP assignment changes. One way of doing that is to use a crontab

wget -q -O - |gunzip > /usr/share/GeoIP/ && mv /usr/share/GeoIP/ /usr/share/GeoIP/GeoIP.dat

Update To URLS

The urls seem to have moved somewhat.

wget -q -O - |gunzip > /usr/share/GeoIP/ && mv /usr/share/GeoIP/GeoIP/ /usr/share/GeoIP/GeoCity.dat
wget -q -O - |gunzip > /usr/share/GeoIP/ && mv /usr/share/GeoIP/ /usr/share/GeoIP/GeoIP.dat

And in /etc/crontab it could look like this:

@monthly root sleep $[$RANDOM/1024]; wget -q -O - |gunzip > /usr/share/GeoIP/ && mv /usr/share/GeoIP/ /usr/share/GeoIP/GeoIP.dat

The above command means:

@montly = do it every month (duh)
root = as user root
sleep $[$RANDOM/1024]; = sleep for a random time (so all you guys don't DDoS maxminds server every month at the same time)
wget ... Teeth whitening | gunzip ... && ... = wget and pipe to gunzip, if that succeeds, move the file to the correct place

Update To CRON

Add this script to cron.monthly

wget -q
oLiteCity.dat.gz -O - |gunzip > /usr/share/GeoIP/GeoCity.dat.
new && mv /usr/share/GeoIP/ /usr/share/GeoIP/G
wget -q
oLiteCountry/GeoIP.dat.gz -O - |gunzip > /usr/share/GeoIP/Geo && mv /usr/share/GeoIP/ /usr/share/Ge