vmod_geoip

important note: this vmod is now obsolete (as libgeoip itself is) and won't receive updates.

Varnish GeoIP Lookup Module

Author:	Hauke Lampe
Date:	2011-09-26
Version:	1.0.3
Manual section:	3

SYNOPSIS

import geoip;

DESCRIPTION

This Varnish module exports functions to look up GeoIP country codes. Requires GeoIP library (on Debian install libgeoip-dev)

Inspired by https://vrobert.fr/2010/07/another-way-to-link-varnish-and-maxmind-geoip/

FUNCTIONS

ip_country_code (not exported yet)

Prototype

ip_country_code(IP I)

Return value

STRING

Description

Returns two-letter country code string from IP address

Example

set req.http.X-Country-Code = geoip.ip_country_code(client.ip);

country_code

Prototype

country_code(STRING S)

Return value

STRING

Description

Returns two-letter country code string

Example

set req.http.X-Country-Code = geoip.country_code("127.0.0.1");

ip_country_name (not exported yet)

Prototype

ip_country_name(IP I)

Return value

STRING

Description

Returns country name string from IP address

Example

set req.http.X-Country-Name = geoip.ip_country_name(client.ip);

country_name

Prototype

country_name(STRING S)

Return value

STRING

Description

Returns country name string

Example

set req.http.X-Country-Name = geoip.country_name("127.0.0.1");

ip_region_name (not exported yet)

Prototype

ip_region_name(IP I)

Return value

STRING

Description

Returns region name string from IP address

Example

set req.http.X-Region-Name = geoip.ip_region_name(client.ip);

region_name (not exported yet)

Prototype

region_name(STRING S)

Return value

STRING

Description

Returns region name string

Example

set req.http.X-Region-Name = geoip.region_name("127.0.0.1");

INSTALLATION

The source tree is based on autotools to configure the building, and does also have the necessary bits in place to do functional unit tests using the varnishtest tool.

It is a prerequisite that you have the varnish-dev package installed as well as varnish:

apt-get install varnish-dev

Install the GeoIP library headers:

apt-get install libgeoip-dev

To check out the current development source:

git clone git://github.com/varnish/libvmod-geoip.git
cd libvmod-geoip; ./autogen.sh

Usage:

./configure

Make targets:

• make - builds the vmod
• sudo make install - installs your vmod
• make check - runs the unit tests in src/tests/*.vtc

KNOWN ISSUES

Certain versions of the GeoIP library will fail if the GeoIP database file is updated by overwriting the old file directly.

This could impact varnish stability, and it is therefore recommended to download the update as a new file, and then mv the new file onto the old active database.