Перейти к содержанию

maxminddb: Библиотека Lua для чтения базы данных геолокации MaxMind

Установка

Если вы еще не настроили подписку на репозиторий RPM, зарегистрируйтесь. Затем вы можете продолжить с следующими шагами.

CentOS/RHEL 7 или Amazon Linux 2

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install lua-resty-maxminddb

CentOS/RHEL 8+, Fedora Linux, Amazon Linux 2023

dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install lua5.1-resty-maxminddb

Чтобы использовать эту библиотеку Lua с NGINX, убедитесь, что nginx-module-lua установлен.

Этот документ описывает lua-resty-maxminddb v1.3.7, выпущенную 8 декабря 2025 года.

Примечание - [maxmind/libmaxminddb][]

  • [openresty][]

  • [GeoLite2 Free Downloadable Databases][linkGeolite2FreeDownloadableDatabases]

  • [maxmind/geoipupdate][]

Новые функции

  • Поддержка нескольких баз данных: Инициализация и использование нескольких баз данных MaxMind одновременно
  • Выбор профиля: Выбор базы данных для запроса с использованием имен профилей
  • Автоматическое резервирование: Использует первую доступную базу данных, если профиль не указан

Исправленные ошибки

Справочник API

Функции: - geo.init(profiles): Инициализация баз данных с именами профилей и путями к файлам - geo.lookup(ip, lookup_path, profile): Поиск IP-адреса, опционально укажите профиль - geo.initted(): Проверка, инициализированы ли базы данных - geo.get_profiles(): Получение списка доступных имен профилей - geo.has_profile(profile): Проверка, существует ли конкретный профиль

Извинения за нарушение - https://github.com/anjia0532/lua-resty-maxminddb/issues/25

opm (ручная установка libmaxminddb и загрузка GeoLite2-City.mmdb)

образы docker openresty/openresty:alpine и apache/apisix:2.13.0-alpine требуют установки perl libmaxminddb

например, apk --no-cache add perl libmaxminddb && ln -s /usr/lib/libmaxminddb.so.0 /usr/lib/libmaxminddb.so

opm get anjia0532/lua-resty-maxminddb

образ docker openresty/openresty:alpine-fat

luarocks install lua-resty-maxminddb

образ docker openresty/openresty:alpine требует установки luarocks (см. https://github.com/openresty/docker-openresty/blob/master/alpine/Dockerfile.fat)

специальный apache/apisix:2.xx.0-alpine luarocks install lua-resty-maxminddb UNZIP=/usr/bin/unzip

например, apk --no-cache add perl alpine-sdk && luarocks install lua-resty-maxminddb UNZIP=/usr/bin/unzip

## Синопсис

**Основное использование (одна база данных)**
```lua
local geo = require 'resty.maxminddb'
if not geo.initted() then
    geo.init("/path/to/GeoLite2-City.mmdb")
end
local res, err = geo.lookup("8.8.8.8")

Поддержка нескольких баз данных 

local geo = require 'resty.maxminddb'
if not geo.initted() then
    geo.init({
        city = "/path/to/GeoLite2-City.mmdb",
        country = "/path/to/GeoLite2-Country.mmdb",
        asn = "/path/to/GeoLite2-ASN.mmdb"
    })
end

-- Поиск с использованием профиля по умолчанию (первого)
local res, err = geo.lookup("8.8.8.8")

-- Или укажите конкретный профиль
local city_data, err = geo.lookup("8.8.8.8", nil, "city")
local country_data, err = geo.lookup("8.8.8.8", nil, "country")
local asn_data, err = geo.lookup("8.8.8.8", nil, "asn")

Полный пример Nginx 

server {
    listen 80;
    server_name localhost;
    location / {
        content_by_lua_block{
            local cjson = require 'cjson'
            local geo = require 'resty.maxminddb'
            if not geo.initted() then
                geo.init({
                    city = "/path/to/GeoLite2-City.mmdb",
                    country = "/path/to/GeoLite2-Country.mmdb"
                })
            end

            -- Поиск с использованием профиля по умолчанию (первого)
            local res,err = geo.lookup(ngx.var.arg_ip or ngx.var.remote_addr)

            -- Поддержка нескольких баз данных
            -- local res,err = geo.lookup(ngx.var.arg_ip or ngx.var.remote_addr, nil, ngx.var.arg_type or 'city')

            if not res then
                ngx.log(ngx.ERR,'не удалось найти по ip, причина:',err)
            end
            ngx.say("full :",cjson.encode(res))
            if ngx.var.arg_node then
               ngx.say("имя узла:",ngx.var.arg_node," ,значение:", cjson.encode(res[ngx.var.arg_node] or {}))
            end
        }
    }
}


  #ipv4
  $ curl "http://localhost/?ip=114.114.114.114&node=city&type=city"

  #ipv6
  #$ curl "http://localhost/?ip=2001:4860:0:1001::3004:ef68&node=country"

  full :{"city":{"geoname_id":1799962,"names":{"en":"Nanjing","ru":"Нанкин","fr":"Nankin","pt-BR":"Nanquim","zh-CN":"南京","es":"Nankín","de":"Nanjing","ja":"南京市"}},"subdivisions":[{"geoname_id":1806260,"names":{"en":"Jiangsu","fr":"Province de Jiangsu","zh-CN":"江苏省"},"iso_code":"32"}],"country":{"geoname_id":1814991,"names":{"en":"China","ru":"Китай","fr":"Chine","pt-BR":"China","zh-CN":"中国","es":"China","de":"China","ja":"中国"},"iso_code":"CN"},"registered_country":{"geoname_id":1814991,"names":{"en":"China","ru":"Китай","fr":"Chine","pt-BR":"China","zh-CN":"中国","es":"China","de":"China","ja":"中国"},"iso_code":"CN"},"location":{"time_zone":"Asia\/Shanghai","longitude":118.7778,"accuracy_radius":50,"latitude":32.0617},"continent":{"geoname_id":6255147,"names":{"en":"Asia","ru":"Азия","fr":"Asie","pt-BR":"Ásia","zh-CN":"亚洲","es":"Asia","de":"Asien","ja":"アジア"},"code":"AS"}}
  имя узла:city ,значение:{"geoname_id":1799962,"names":{"en":"Nanjing","ru":"Нанкин","fr":"Nankin","pt-BR":"Nanquim","zh-CN":"南京","es":"Nankín","de":"Nanjing","ja":"南京市"}}

prettify 

full: {
    "city": {
        "geoname_id": 1799962,
        "names": {
            "en": "Nanjing",
            "ru": "Нанкин",
            "fr": "Nankin",
            "pt-BR": "Nanquim",
            "zh-CN": "南京",
            "es": "Nankín",
            "de": "Nanjing",
            "ja": "南京市"
        }
    },
    "subdivisions": [{
            "geoname_id": 1806260,
            "names": {
                "en": "Jiangsu",
                "fr": "Province de Jiangsu",
                "zh-CN": "江苏省"
            },
            "iso_code": "32"
        }
    ],
    "country": {
        "geoname_id": 1814991,
        "names": {
            "en": "China",
            "ru": "Китай",
            "fr": "Chine",
            "pt-BR": "China",
            "zh-CN": "中国",
            "es": "China",
            "de": "China",
            "ja": "中国"
        },
        "iso_code": "CN"
    },
    "registered_country": {
        "geoname_id": 1814991,
        "names": {
            "en": "China",
            "ru": "Китай",
            "fr": "Chine",
            "pt-BR": "China",
            "zh-CN": "中国",
            "es": "China",
            "de": "China",
            "ja": "中国"
        },
        "iso_code": "CN"
    },
    "location": {
        "time_zone": "Asia\/Shanghai",
        "longitude": 118.7778,
        "accuracy_radius": 50,
        "latitude": 32.0617
    },
    "continent": {
        "geoname_id": 6255147,
        "names": {
            "en": "Asia",
            "ru": "Азия",
            "fr": "Asie",
            "pt-BR":"Ásia",
            "zh-CN": "亚洲",
            "es": "Asia",
            "de": "Asien",
            "ja": "アジア"
        },
        "code": "AS"
    }
}
имя узла: city, значение: {
    "geoname_id": 1799962,
    "names": {
        "en": "Nanjing",
        "ru": "Нанкин",
        "fr": "Nankin",
        "pt-BR": "Nanquim",
        "zh-CN": "南京",
        "es": "Nankín",
        "de": "Nanjing",
        "ja": "南京市"
    }
}

Ссылки

  • [GeoIP2 City and Country CSV Databases][linkGeoip2CityAndCountryCsvDatabases]
  • [lilien1010/lua-resty-maxminddb][]
  • [maxmind/libmaxminddb#source#lookup_and_print][]
  • [maxmind/libmaxminddb#source#dump_entry_data_list][]

Сообщения об ошибках

Пожалуйста, сообщайте об ошибках, создавая проблему в нашем трекере проблем на GitHub по адресу https://github.com/anjia0532/lua-resty-maxminddb/issues

Если ошибка вызвана libmaxminddb, создайте проблему в трекере по адресу https://github.com/maxmind/libmaxminddb/issues

GitHub

Вы можете найти дополнительные советы по конфигурации и документацию для этого модуля в репозитории GitHub для nginx-module-maxminddb.