Releases: adulau/mmdb-server
mmdb-server version 1.1 released including minor bugs fixed
mmdb-server is an open source fast API server to lookup IP addresses for their geographic location, AS number. The server can be used with any MaxMind DB File Format or file in the same format. The server includes the open and free Geo Open - IP address geolocation per country in MMDB format 🗺️.
This version fixes a small bug with the lookup of unknown countries and include an update of the free Geo Open database.
mmdb-server v1.0 released - an open source fast API server to lookup IP addresses for their geographic location.
mmdb-server v1.0 released - an open source fast API server to lookup IP addresses for their geographic location. The server reached version 1.0 as many production servers are running flawlessly with this code. mmdb-server includes the geo-open database from CIRCL.
mmdb-server (the open and free geo IP server) version 0.5 released
mmdb-server (the open and free geo IP server) version 0.5 released (2022-02-06) 🗺️
mmdb-server (the open and free geo IP server) version 0.5 released which includes the support for to load multiple MMDB files.
A new GeoOpen database included to support AS number and AS description lookup.
New
-
[multiple MMDB file support] MMDB server can now load a list of MMDB files + new GeoOpen file including ASN details added as example. [Alexandre Dulaunoy]
GeoOpen files for country only -> https://cra.circl.lu/opendata/geo-open/mmdb-country/
GeoOpen files with country and ASN/ASN description -> https://cra.circl.lu/opendata/geo-open/mmdb-country-asn/ -
[db] Country-ASN db added. [Alexandre Dulaunoy]
-
[db] GeoOpen database updated. [Alexandre Dulaunoy]
Changes
-
[doc] update the documentation and examples with the multiple sources. [Alexandre Dulaunoy]
-
[log] remove old debug. [Alexandre Dulaunoy]
-
[db] renamed. [Alexandre Dulaunoy]
-
[GeoOpen-country] updated. [Alexandre Dulaunoy]
Other
- Update README.md. [Alexandre Dulaunoy]
🗺️ mmdb-server v0.2 relase - an open source fast API server to lookup IP addresses for their geographic location
What's new in v0.2 (2022-01-24)
New
-
[server] Add additional information about the country including average location, complete name and numeric code. [Alexandre Dulaunoy]
-
[mygeolookup] Query on root of the server will give the geo location of the remote IP address doing the query. [Alexandre Dulaunoy]
Changes
-
[doc] update JSON output and CIRCL public service. [Alexandre Dulaunoy]
-
[server] display port. [Alexandre Dulaunoy]
-
[server] make port configurable. [Alexandre Dulaunoy]
🗺️ mmdb-server v0.1 - an open source fast API server to lookup IP addresses for their geographic location
mmdb-server is an open source fast API server to lookup IP addresses for their geographic location. The server can be used with any MaxMind DB File Format or file in the same
format.
mmdb-server includes a free and open GeoOpen-Country database for IPv4 and IPv6 addresses. The file GeoOpen-Country is generated on a regular basis from AS announces and their respective whois records.
Installation
Python 3.8+ is required to run the mmdb-server with some additional requirements.
pip3 install -r REQUIREMENTS
cp ./etc/server.conf.sample ./etc/server.conf
cd bin; python3 server.py
Usage
Lookup of an IP address
curl -s http://127.0.0.1:8000/geolookup/188.65.220.25 | jq .
[
{
"country": {
"iso_code": "BE"
},
"meta": {
"description": {
"en": "Geo Open MMDB database - https://github.com/adulau/mmdb-server"
},
"build_db": "2022-01-23 16:13:05",
"db_source": "GeoOpen-Country",
"nb_nodes": 1156125
}
}
]
$ curl -s http://127.0.0.1:8000/geolookup/2a02:21d0::68:69:25 | jq .
[
{
"country": {
"iso_code": "BE"
},
"meta": {
"description": {
"en": "Geo Open MMDB database - https://github.com/adulau/mmdb-server"
},
"build_db": "2022-01-23 16:13:05",
"db_source": "GeoOpen-Country",
"nb_nodes": 1156125
}
}
]
Output format
The output format is an array of JSON object (to support the ability to serve multiple geo location database). Each JSON object of the JSON array includes a meta
and a country
fields. The country
give the geo
graphic location of the IP address queried. The meta
field includes the origin of the MMDB database which the the metadata.