Det første release af geoip-projektet, der implementerer en service til at hente information om placeringen af IP-adresser via REST API, er blevet gennemført. Projektet fokuserer på at forenkle integrationen af GeoIP-funktionalitet i forskellige applikationer, hvilket frigør udvikleren fra behovet for selv at administrere opdateringer af databaser og arbejde med MMDB-formatet. Koden er skrevet i Rust og distribueres under MIT-licensen. Det understøtter drift på Linux og macOS samt andre UNIX-lignende systemer.
De vigtigste funktioner i tjenesten:
- Høj ydeevne og lavt hukommelsesforbrug takket være brugen af et kompilérbart sprog uden garbage collector.
- Tilvejebringelse af information om IP-adressen (land, by, postnummer, koordinater, teleoperatør mv.) via REST API baseret på data fra MaxMind GeoLite2 (gratis) og MaxMind GeoIP2 (betalt).
- Bestemmelse af den nuværende IP-adresser bruger (tilgængelig via et separat endpoint; parameteren ip i hovedendepunktet er valgfri).
- Konfigurerbare automatiske databaser opdateringer (både fra officielle MaxMind ressourcer med brug af Account ID og Licence Key, samt fra brugerdefinerede URLs med understøttelse af godkendelse; det er muligt at angive kontrolinterval for opdateringer).
- Webgrænseflade til manuel afsendelse af forespørgsler, inklusive valgfri support til visning på kortet OpenStreetMap.
- For alle resultater, der indeholder feltet timezone, genereres der automatisk et ekstra felt posix_timezone (f.eks. Europe/Paris konverteres til CET-1CEST,M3.5.0,M10.5.0/3). Dette sikrer automatisk konfiguration af tidszonen på indlejrede enheder (f.eks. ESP32 og andre targets newlib uden indbygget tzdata). Denne funktion er unik og findes ikke i lignende løsninger.
- Automatisk opdatering af tidszone databasen (interval, kilde og godkendelse kan konfigureres; som standard anvendes det officielle websted IANA). Når opdateringer er deaktiveret, anvendes systemdatabasen.
- Mulighed for at hente aktuelle databasarhiver via HTTP direkte fra tjenesten (hvilket muliggør brug af én instans som en proxy-kilde for andre og reducerer forbruget af MaxMind-kvoten).
- Support til beskyttelse af endpoints ved hjælp af en valgfri API-nøgle.
- Tilgængeligheden af OpenAPI-specifikation og indbygget Swagger UI gør integrationen med dine projekter lettere.
- Tilvejebringelse af en klar Docker-image til hurtig implementering: docker run \ -e MAXMIND_ACCOUNT_ID=XXXX \ -e MAXMIND_LICENCE_KEY=YYYY \ -e OSM_TILES_URL="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" \ # valgfrit -v geoip_data:/data \ -p 8080:8080 \ ghcr.io/quoi-dev/geoip:latest
Kilde: opennet.ru
