caddy-geoip

Overview

geoip is a Caddy plugin that allow to determine user Geolocation by IP address using MaxMind database.

Headers

geoip set this headers:

  X-Geoip-Country-Code - Country ISO code, example CY for Cyprus
  X-Geoip-Location-Lat - Latitude, example 34.684100
  X-Geoip-Location-Lon - Longitude, example 33.037900
  X-Geoip-Location-Tz - Time zone, example Asia/Nicosia
  X-Geoip-Country-Eu - Return 'true' if country in Europen Union
  X-Geoip-Country-Name - Full country name
  X-Geoip-City-Name - City name

Examples

(1) Set database path:

geoip {
  database /path/to/db/GeoLite2-City.mmdb
}

(2) Set custom header names.

geoip {
  database path/to/maxmind/db
  set_header_country_code Code
  set_header_country_name CountryName
  set_header_country_eu Eu
  set_header_city_name CityName
  set_header_location_lat Lat
  set_header_location_lon Lon
  set_header_location_tz TZ
}