telize

                           t  e  l  i  z  e
                       _______________________
                 ______                     /_______
                \     \           ___     //      /
           __     ____     __    /      _____/ / ____
       ___/  ____/  _//____/  ______/_____   /__/  _//____
      \__    ____  __/  __     __      ____    ____  __/  __///
        /      _   |/    _     /       /     /_/   |/    _
      \   ___/___       /____/_______/   ___/___       /
  <0(--- __/ -h7- ______/          .    __/ ---- ______/ --(0>
                             .     /.      .
                              .   //      /
                         ______\ //______/
                                  Y

Beschreibung

Telize ist eine in Go integrierte REST-API, die es ermöglicht, eine Besucher-IP-Adresse abzurufen und Standortinformationen von jeder IP-Adresse abzufragen. Es gibt JSON-codierte IP-Geolokalisierungsdaten aus und unterstützt sowohl JSON als auch JSONP.

Geolokalisierungsvorgänge werden mit dem MaxMind DB Reader für Go durchgeführt, der die Datenbank im RAM zwischenspeichert. Daher hat Telize nur einen sehr geringen Overhead und sollte blitzschnell sein.

Anforderungen

Telize erfordert die folgenden Go-Bibliotheken:

• chi: leichter, idiomatischer und zusammensetzbarer Router – https://github.com/go-chi/chi
• maxminddb-golang: MaxMind DB Reader für Go – https://github.com/oschwald/maxminddb-golang

GeoIP2-Datenbanken

Telize benötigt die kostenlosen GeoLite2-Datenbanken von MaxMind.

Telize sucht standardmäßig in /var/db/GeoIP nach den GeoLite2 City und GeoLite2 ASN Datenbanken.

Installation

Erstellen und installieren Sie mit dem go Tool. Alle Abhängigkeiten werden automatisch abgerufen und kompiliert:

 go build
go install telize

Verwendung

Standardmäßig bindet Telize an localhost, Port 8080.

 USAGE:
  -host string
    	Set the server host (default "127.0.0.1")
  -port string
    	Set the server port (default "8080")
  -version
    	Display version

Telize beim Booten ausführen

Systemd-Unit-Datei

Telize ist mit einer Systemd-Unit-Datei gebündelt, siehe: systemd/telize.service

Kopieren Sie die Datei systemd/telize.service in /etc/systemd/system und die Telize-Binärdatei in /usr/local/sbin .

Um den Daemon beim Start zu starten, führen Sie Folgendes aus:

 systemctl enable telize

Fragen stellen

Eine vollständige API-Dokumentation und Anwendungsbeispiele finden Sie auf der Projektseite.

Telize unterstützt JSONP-Rückrufe.

Rufen Sie die IP-Adresse im Nur-Text-Format ab

• Beispiel: http://127.0.0.1:8080/ip

Rufen Sie die IP-Adresse im JSON-Format ab

• Beispiel (JSON): http://127.0.0.1:8080/jsonip
• Beispiel (JSONP): http://127.0.0.1:8080/jsonip?callback=getip

Rufen Sie den Standort der IP-Adresse im JSON-Format ab

Wenn Sie den API-Endpunkt ohne Parameter aufrufen, wird die Besucher-IP-Adresse zurückgegeben:

• Beispiel (JSON): http://127.0.0.1:8080/location
• Beispiel (JSONP): http://127.0.0.1:8080/location?callback=getlocation

Durch Anhängen einer IP-Adresse als Parameter werden Standortinformationen für die angegebene Adresse zurückgegeben:

• Beispiel (JSON): http://127.0.0.1:8080/location/46.19.37.108
• Beispiel (JSONP): http://127.0.0.1:8080/location/46.19.37.108?callback=getlocation

Clientfehler

Wenn eine falsche Benutzereingabe erfolgt, gibt der Server einen HTTP 400-Fehler (Bad Request) zusammen mit einer JSON-codierten Fehlermeldung zurück.

• Code 401: Eingabezeichenfolge ist keine gültige IP-Adresse

Telize und Proxys

Telize verarbeitet den HTTP-Header „X-Forwarded-For“, sofern vorhanden, und gibt Daten für die erste IP-Adresse der Liste zurück.

CORS-Unterstützung (Cross-Origin-Ressourcenfreigabe)

Bei Telize ist CORS standardmäßig mit der folgenden Richtlinie aktiviert:

 Access-Control-Allow-Origin: *

Zeitzonenversätze

Seit Version 3.0.0 berechnet Telize nun dynamisch Zeitzonenversätze (UTC-Zeitversatz) und fügt Daten zur Nutzlast hinzu.

Lizenz

Telize wird unter der BSD 2-Clause-Lizenz veröffentlicht. Weitere Informationen finden Sie in LICENSE Datei.

Autor

Telize wurde von Frederic Cambus entwickelt.

• Website: https://www.cambus.net

Ressourcen

Projekthomepage: https://www.telize.com

Neueste Tarball-Version: https://www.statdns.com/telize/telize-3.1.1.tar.gz

GitHub: https://github.com/fcambus/telize