telize

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

描述

Telize 是 Go 中內建的 REST API，允許取得訪客 IP 位址並從任何 IP 位址查詢位置資訊。它輸出 JSON 編碼的 IP 地理位置數據，並支援 JSON 和 JSONP。

地理定位操作是使用 MaxMind DB Reader for Go 執行的，它將資料庫快取在 RAM 中。因此，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/telize.service

複製/etc/systemd/system中的systemd/telize.service檔案和/usr/local/sbin中的 Telize 二進位。

若要在啟動時啟動守護進程，請執行：

 systemctl enable telize

進行查詢

如需完整的 API 文件和使用範例，請查看專案網站。

Telize 支援 JSONP 回呼。

取得純文字格式的 IP 位址

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

取得 JSON 格式的 IP 位址

• 範例（JSON）：http://127.0.0.1:8080/jsonip
• 範例（JSONP）：http://127.0.0.1:8080/jsonip?callback=getip

取得 JSON 格式的 IP 位址位置

呼叫不帶任何參數的 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

客戶端錯誤

當輸入不正確的使用者輸入時，伺服器會傳回 HTTP 400 錯誤（錯誤請求）以及 JSON 編碼的錯誤訊息。

• 代碼 4​​01：輸入字串不是有效的 IP 位址

Telize 和代理

Telize 處理「X-Forwarded-For」HTTP 標頭（如果存在），並傳回清單中第一個 IP 位址的資料。

CORS支援（跨源資源共享）

Telize 預設啟用 CORS，並採用以下策略：

 Access-Control-Allow-Origin: *

時區偏移

從版本 3.0.0 開始，Telize 現在動態計算時區偏移（UTC 時間偏移）並將資料新增至有效負載。

執照

Telize 是根據 BSD 2-Clause 許可證發布的。有關詳細信息，請參閱LICENSE文件。

作者

由 Frederic Cambus 開發 Telize。

• 網址：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