telize

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

説明

Telize は Go に組み込まれた REST API で、訪問者の IP アドレスを取得し、任意の IP アドレスから位置情報をクエリできます。 JSON エンコードされた IP 地理位置情報データを出力し、JSON と JSONP の両方をサポートします。

地理位置情報操作は、データベースを RAM にキャッシュする MaxMind DB Reader for Go を使用して実行されます。したがって、Telize のオーバーヘッドは非常に最小限であり、非常に高速であるはずです。

要件

Telize には次の Go ライブラリが必要です。

• chi: 軽量で慣用的で構成可能なルーター - https://github.com/go-chi/chi
• maxminddb-golang: Go 用 MaxMind DB リーダー - https://github.com/oschwald/maxminddb-golang

GeoIP2 データベース

Telize には、MaxMind の無料の GeoLite2 データベースが必要です。

Telize は、デフォルトで/var/db/GeoIPでGeoLite2 CityおよびGeoLite2 ASNデータベースを検索します。

インストール

goツールを使用してビルドしてインストールすると、すべての依存関係が自動的にフェッチされてコンパイルされます。

 go build
go install telize

使用法

デフォルトでは、Telize はローカルホストのポート 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 を実行する

Systemdユニットファイル

Telize は systemd ユニット ファイルにバンドルされています。systemd systemd/telize.serviceを参照してください。

systemd/telize.serviceファイルを/etc/systemd/systemにコピーし、Telize バイナリを/usr/local/sbinにコピーします。

起動時にデーモンを起動するには、次のコマンドを実行します。

 systemctl enable telize

クエリの作成

完全な API ドキュメントと使用例については、プロジェクト サイトを確認してください。

Telize は JSONP コールバックをサポートしています。

IPアドレスをプレーンテキスト形式で取得する

• 例: http://127.0.0.1:8080/ip

IPアドレスをJSON形式で取得する

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

IP アドレスの場所を JSON 形式で取得する

パラメータを指定せずに API エンドポイントを呼び出すと、訪問者の IP アドレスが返されます。

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

IP アドレスをパラメータとして追加すると、指定されたアドレスの位置情報が返されます。

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

クライアントエラー

間違ったユーザー入力が入力されると、サーバーは JSON でエンコードされたエラー メッセージとともに HTTP 400 エラー (不正なリクエスト) を返します。

• コード 401: 入力文字列は有効な IP アドレスではありません

Telize とプロキシ

Telize は、「X-Forwarded-For」HTTP ヘッダーが存在する場合はそれを処理し、リストの最初の IP アドレスのデータを返します。

CORS サポート (クロスオリジン リソース共有)

Telize では、次のポリシーで CORS がデフォルトで有効になっています。

 Access-Control-Allow-Origin: *

タイムゾーンオフセット

バージョン 3.0.0 以降、Telize はタイムゾーン オフセット (UTC 時間オフセット) を動的に計算し、ペイロードにデータを追加するようになりました。

ライセンス

Telize は BSD 2 条項ライセンスに基づいてリリースされています。詳細については、 LICENSEファイルを参照してください。

著者

Telize は Frederic Cambus によって開発されました。

• サイト: https://www.cambus.net

リソース

プロジェクトホームページ：https://www.telize.com

最新の tarball リリース: https://www.statdns.com/telize/telize-3.1.1.tar.gz

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