Skip to content
/ Luminet Public

Luminet, Open-source platform that gathers comprehensive IP and domain information (WHOIS, DNS, RDAP, BGP, geolocation, ping, ports) using only free and public APIs.

Notifications You must be signed in to change notification settings

koesan/Luminet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌐 Luminet - Open Source Network Analysis Tool

🌟 Star this repo if you find it useful!

Docker Hub Hugging Face Python License

video_.mp4

Luminet Demo Video

📎 Live Demo - Canlı Demo

Hugging Face


🇬🇧English | 🇹🇷Türkçe


English

🇬🇧

📖 Overview

Luminet is a comprehensive open-source network analysis tool designed for cybersecurity professionals, network administrators, and researchers. It provides detailed reconnaissance capabilities for IP addresses and domain names using only public, free data sources.

✨ Key Features

  • 🔍 RDAP/WHOIS Analysis - Comprehensive registry data lookup
  • 🌐 DNS Records Enumeration - A, AAAA, MX, NS, TXT, CNAME, SOA records
  • 🗺️ Geographic Location Mapping - IP geolocation and ISP information
  • 🛡️ Security Assessment - DNSBL checks, anonymity service detection
  • 🔒 SSL/TLS Certificate Analysis - Certificate chain and security validation
  • 📊 Network Routing Analysis - Traceroute and BGP information
  • ⚡ Real-time Ping Statistics - Latency and connectivity testing
  • 🔌 Port Scanning - Open port detection and service identification

🚀 Installation & Run

# 1) Install system packages # ------------------------------ # Debian/Ubuntu # ------------------------------ sudo apt update sudo apt install -y python3 python3-venv python3-pip mtr nmap # ------------------------------ # Fedora # ------------------------------ sudo dnf install -y python3 python3-venv python3-pip mtr nmap # ------------------------------ # Arch Linux / Manjaro # ------------------------------ sudo pacman -Syu --noconfirm python python-virtualenv python-pip mtr nmap # 2) Create virtual environment python3 -m venv .venv source .venv/bin/activate # 3) Install Python dependencies pip install -r requirements.txt # 4) Run the app sudo python3 main.py # 5) Open in browser # http://localhost:5000

Note: Some network tools (e.g., scapy, nmap) require root privileges. Therefore, you need to run them with sudo. For production environments, gunicorn + systemd + nginx is recommended.


📋 System Requirements

  • Python: 3.11 or higher
  • traceroute - Network path tracing
  • nmap - Port scanning capabilities
  • mtr - Enhanced network diagnostics
  • dig/nslookup - DNS utilities

🛠️ Technology Stack

Backend

  • Framework: Flask 2.3.3
  • Language: Python 3.11+
  • Networking: dnspython, requests, python-whois
  • Security: pyOpenSSL, scapy

🔍 Usage Examples

1) Web Interface

  1. Open http://localhost:7860 in your browser
  2. Enter an IP address or domain name
  3. Click "Analyze" to get comprehensive results

2) API Usage

# Analyze an IP address curl -X POST http://localhost:7860/api/analyze \ -H "Content-Type: application/json" \ -d '{"ip": "8.8.8.8"}' # Example response { "ip": "8.8.8.8", "ipinfo": { "city": "Mountain View", "country": "US", "org": "AS15169 Google LLC" }, "ping": { "min": "10.2 ms", "avg": "12.5 ms", "max": "15.1 ms" } }

Türkçe

🇹🇷

📖 Genel Bakış

Luminet, siber güvenlik uzmanları, ağ yöneticileri ve araştırmacılar için tasarlanmış kapsamlı bir açık kaynak ağ analiz aracıdır. Yalnızca halka açık, ücretsiz veri kaynaklarını kullanarak IP adresleri ve alan adları için detaylı keşif yetenekleri sağlar.

✨ Temel Özellikler

  • 🔍 RDAP/WHOIS Analizi - Kapsamlı kayıt veri arama
  • 🌐 DNS Kayıt Numaralandırması - A, AAAA, MX, NS, TXT, CNAME, SOA kayıtları
  • 🗺️ Coğrafi Konum Haritalaması - IP coğrafi konum ve ISS bilgileri
  • 🛡️ Güvenlik Değerlendirmesi - DNSBL kontrolleri, anonimlik hizmeti tespiti
  • 🔒 SSL/TLS Sertifika Analizi - Sertifika zinciri ve güvenlik doğrulaması
  • 📊 Ağ Yönlendirme Analizi - Traceroute ve BGP bilgileri
  • ⚡ Gerçek Zamanlı Ping İstatistikleri - Gecikme ve bağlanabilirlik testi
  • 🔌 Port Tarama - Açık port tespiti ve servis tanımlama

🚀 Kurulum & Çalıştırma

# 1) Sistem paketlerini kur # ------------------------------ # Debian/Ubuntu # ------------------------------ sudo apt update sudo apt install -y python3 python3-venv python3-pip mtr nmap # ------------------------------ # Fedora # ------------------------------ sudo dnf install -y python3 python3-venv python3-pip mtr nmap # ------------------------------ # Arch Linux / Manjaro # ------------------------------ sudo pacman -Syu --noconfirm python python-virtualenv python-pip mtr nmap # 2) Sanal ortam oluştur python3 -m venv .venv source .venv/bin/activate # 3) Python bağımlılıklarını kur pip install -r requirements.txt # 4) Uygulamayı çalıştır sudo python3 main.py # 5) Tarayıcıda aç # http://localhost:5000

Not: Bazı network araçları (örn. scapy, nmap) root yetkisi ister. Bu nedenle sudo ile çalıştırmanız gerekirr. Production ortamı için gunicorn + systemd + nginx tavsiye edilir.

📋 Sistem Gereksinimleri

  • Python: 3.11 veya üzeri
  • traceroute - Ağ yolu izleme
  • nmap - Port tarama yetenekleri
  • mtr - Gelişmiş ağ tanılama
  • dig/nslookup - DNS araçları

🛠️ Teknoloji Yığını

Arka Uç

  • Framework: Flask 2.3.3
  • Dil: Python 3.11+
  • Ağ İletişimi: dnspython, requests, python-whois
  • Güvenlik: pyOpenSSL, scapy

🔍 Kullanım Örnekleri

1) Web Arayüzü

  1. Tarayıcınızda http://localhost:7860 adresini açın
  2. Bir IP adresi veya alan adı girin
  3. Kapsamlı sonuçlar için "Analiz Et" düğmesine tıklayın

2) API Kullanımı

# Bir IP adresini analiz etme curl -X POST http://localhost:7860/api/analyze \ -H "Content-Type: application/json" \ -d '{"ip": "8.8.8.8"}' # Örnek cevap { "ip": "8.8.8.8", "ipinfo": { "city": "Mountain View", "country": "US", "org": "AS15169 Google LLC" }, "ping": { "min": "10.2 ms", "avg": "12.5 ms", "max": "15.1 ms" } }

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Luminet, Open-source platform that gathers comprehensive IP and domain information (WHOIS, DNS, RDAP, BGP, geolocation, ping, ports) using only free and public APIs.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published