منصوبے کے بارے میں

BitCurrents Log Analyzer ایک ریئل ٹائم Nginx لاگ تجزیہ ٹول ہے جو Python/Flask بیک اینڈ اور ڈائنامک جاوااسکرپٹ فرنٹ اینڈ کے ساتھ سنگل پیج ویب ایپلی کیشن کے طور پر تیار کیا گیا ہے۔ یہ خام Nginx رسائی اور خرابی کے لاگز کو سیکورٹی انٹیلی جنس، کارکردگی کی نگرانی اور ڈیٹا ویژولائزیشن پر مرکوز انٹرایکٹو ڈیش بورڈز میں تبدیل کرتا ہے۔ ایپلی کیشن تین الگ تجزیہ موڈز پیش کرتی ہے: **جنرل موڈ** — کل ہٹس، منفرد آئی پیز، انکساری اور مشکوک گنتی جیسے KPI کارڈز کے ساتھ فوری ٹریفک کا جائزہ فراہم کرتا ہے، انسانوں بمقابلہ بٹس بمقابلہ کرالرز، ڈیوائس اقسام، آپریٹنگ سسٹم اور براؤزر تقسیم، HTTP سٹیٹس کوڈز، سر فہرست ممالک اور زیادہ تر رسائی شدہ صفحات کے لیے ٹریفک کی تفصیل کے چارٹس شامل ہیں۔ شور آلے آئی پیز کو چھپانے اور منفرد آئی پیز اور تمام ہٹس کے مناظر کے درمیان ٹوگل کرنے کے لیے فلٹرنگ شامل ہے۔ **سیکورٹی موڈ** — `security_patterns.json` کو کنفیگر کرنے کے قابل استعمال کرتے ہوئے ڈائنامک خطرے کی زمروں (config exposure, webshells, WordPress probes) کے ساتھ فعال خطرات کی تلاش کو فعال کرتا ہے۔ سر فہرست حملہ آور زمروں اور حملہ آور آئی پیز کے لیے ہدف یافتہ ویژولائزیشنز کے ساتھ ساتھ خودکار بٹ انکساری کی شناخت بھی فراہم کرتا ہے جو وہ ٹریفک کو نشاندہی کرتا ہے جو قانونی کرالرز ہونے کا دعویٰ کرتا ہے لیکن غیر تصدیق شدہ آئی پی رینجز سے نکلتا ہے۔ **ایرر موڈ** — عام Nginx `error.log` پیغامات (مثلاً "Backend Unreachable," "Index Forbidden") کو ذہینی سے پارس کرکے سرور کے مسائل کی تشخیص کرتا ہے۔ خرابی کی اقسام اور شدت کی سطحوں کو ویژولائز کرتا ہے، جس کے ساتھ عام خرابیوں کے لیے ایپلی کیشن کے اندر ٹربل شوٹنگ گائیڈ بھی شامل ہے۔ پروجیکٹ IP2Location.io API کو بلند معیار کی جغرافیائی مقام (ملک، شہر، آئی ایس پی ڈیٹا) اور صرف صارف ایجنٹ سٹرنگ میچنگ سے آگے بڑھ کر اعلیٰ درجے کی بٹ شناخت کے لیے استعمال کرتا ہے۔ یہ API کریڈٹس کی بچت کے لیے ایک آئی پی کیش فائل کو برقرار رکھتا ہے۔ ### سیٹ اپ اور استعمال ضروریات میں pyenv اور Python 3.13.0 شامل ہیں۔ ریپوزیٹری کو کلون کریں، ورچوئل ماحول سیٹ اپ کریں، اور `requirements.txt` سے انحصاریات انسٹال کریں۔ ایک مفت IP2Location API کلید کو `.env` فائل کے ذریعے کنفیگر کرنا ضروری ہے۔ بیک اینڈ `python app.py` کے ساتھ چلتا ہے، اور فرنٹ اینڈ کو براہ راست براؤزر میں مقامی فائل کے طور پر کھولا جاتا ہے۔ صارفین ایپ کو اپنی لاگ ڈائریکٹری کی طرف اشارہ کرتے ہیں، دستیاب فائلوں کی فہرست بناتے ہیں، اختیاری طور پر ٹریک کرنے کے لیے راستے مقرر کرتے ہیں، اور تجزیہ پر کلک کرتے ہیں۔ ### Nginx کنفیگریشن بہترین نتائج کے لیے، Nginx رسائی لاگ فارمیٹ میں `$http_referer` اور `$http_user_agent` متغیرات شامل ہونے چاہئیں۔ نمونہ کنفیگریشن README میں فراہم کی گئی ہے۔ خیال Ray Kooyenga (@deadflowers @rkooyenga) کا ہے۔ IP2Location 2025 ہیکیتھون پروگرامنگ مقابلے کے لیے تخلیق کیا گیا۔