telize

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

وصف

Telize عبارة عن واجهة برمجة تطبيقات REST مدمجة في Go مما يسمح بالحصول على عنوان IP للزائر والاستعلام عن معلومات الموقع من أي عنوان IP. يقوم بإخراج بيانات تحديد الموقع الجغرافي IP المشفرة بـ JSON، ويدعم كلاً من JSON وJSONP.

يتم تنفيذ عمليات تحديد الموقع الجغرافي باستخدام MaxMind DB Reader for Go الذي يقوم بتخزين قاعدة البيانات مؤقتًا في ذاكرة الوصول العشوائي (RAM). لذلك، لدى Telize حد أدنى من النفقات العامة ويجب أن تكون سريعة للغاية.

متطلبات

يتطلب Telize مكتبات Go التالية:

• تشي: جهاز توجيه خفيف الوزن واصطلاحي وقابل للتركيب - https://github.com/go-chi/chi
• maxminddb-golang: قارئ MaxMind DB لـ Go - https://github.com/oschwald/maxminddb-golang

قواعد بيانات GeoIP2

يتطلب Telize قواعد بيانات GeoLite2 المجانية من MaxMind.

سوف تبحث Telize عن قواعد بيانات GeoLite2 City و GeoLite2 ASN في /var/db/GeoIP بشكل افتراضي.

تثبيت

قم بالإنشاء والتثبيت باستخدام أداة 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

انسخ ملف 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

أخطاء العميل

عندما يتم إدخال إدخال مستخدم غير صحيح، يقوم الخادم بإرجاع خطأ HTTP 400 (طلب غير صالح)، بالإضافة إلى رسالة خطأ بترميز JSON.

• الرمز 401: سلسلة الإدخال ليست عنوان IP صالحًا

Telize والوكلاء

يعالج Telize رأس HTTP "X-Forwarded-For" إذا كان موجودًا، ويقوم بإرجاع البيانات الخاصة بعنوان IP الأول من القائمة.

دعم CORS (مشاركة الموارد عبر الأصل)

تم تمكين CORS في Telize بشكل افتراضي مع السياسة التالية:

 Access-Control-Allow-Origin: *

تعويضات المنطقة الزمنية

منذ الإصدار 3.0.0، يقوم Telize الآن بحساب إزاحات المنطقة الزمنية (إزاحة التوقيت العالمي الموحد) ديناميكيًا وإضافة البيانات إلى الحمولة.

رخصة

يتم إصدار Telize بموجب ترخيص BSD 2-Clause. راجع ملف LICENSE للحصول على التفاصيل.

مؤلف

تم تطوير Telize بواسطة فريدريك كامبوس.

• الموقع: https://www.cambus.net

موارد

الصفحة الرئيسية للمشروع: https://www.telize.com

أحدث إصدار من كرة القطران: https://www.statdns.com/telize/telize-3.1.1.tar.gz

جيثب: https://github.com/fcambus/telize