hololu/hnetwork repository overview

⁠hNetwork - Gelişmiş Ağ & Port Tarayıcı

hNetwork, yerel ağdaki cihazları keşfetmek, 802.1Q destekli çoklu VLAN'ları taramak ve girdiğiniz herhangi bir IP (iç LAN veya dış WAN) ya da alan adındaki tüm portları (1-65535) saniyeler içinde tarayıp derinlemesine analiz eden, modern Glassmorphism arayüzlü yüksek performanslı Ağ ve Port Analiz Platformudur.

⁠🚀 Öne Çıkan Özellikler

⁠🎯 1. Gelişmiş Hedef IP & Port Tarayıcı (Deep Port Scanner)

• Her Türlü Hedef Desteği: İç ağ (LAN: 192.168.1.1, 10.0.0.1), Dış ağ (WAN: 8.8.8.8, 1.1.1.1) veya Alan Adı (example.com, scanme.nmap.org) fark etmeksizin tüm hedefleri tarar.
• Esnek Port Şablonları & Tam Aralık:
  • ⚡ Hızlı Top 100 Port (1 saniyede biter)
  • 🚀 Popüler Top 1000 Port
  • 🌐 Web & Bulut Portları (80, 443, 8080, 8443, 3000, 5000, 8000...)
  • 🗄️ Veritabanı Portları (MySQL, PostgreSQL, MSSQL, Oracle, Redis, MongoDB, Cassandra, ElasticSearch...)
  • 🛡️ Uzak Erişim Portları (SSH, RDP, VNC, Telnet, WinRM, cPanel...)
  • 🔥 Eksiksiz Tüm Portlar (1 - 65535)
  • ✏️ Özel Port Listesi / Aralığı (Örn: 80,443,8000-8080,3306)
• Ultra Hızlı Eşzamanlı Tarama: Çok iş parçacıklı (100 - 800 Threads) optimize soket motoru sayesinde harici bağımlılık gerektirmeden tam performans çalışır.
• Canlı Gerçek Zamanlı İlerleme (SSE Stream): İlerleme çubuğu (% yüzdesi), taranan port sayacı, canlı hız (port/saniye), geçen süre ve bulunan açık portları anlık olarak ekrana basar.
• Derinlemesine Banner & Servis Analizi:
  • HTTP/HTTPS: Web sunucu başlığı (nginx, Apache, IIS, LiteSpeed, Kestrel), X-Powered-By, sayfa <title> başlığı ve HTTP durum kodu (200 OK, 301, 403...).
  • SSL/TLS Sertifika İncelemesi: TLS versiyonu, şifreleme algoritması, Sertifika CN, Yayıncı (Issuer) ve geçerlilik tarihi.
  • SSH / FTP / SMTP / MySQL / Redis / Telnet: Doğrudan servis karşılama protokolü üzerinden versiyon yakalama (örn: SSH-2.0-OpenSSH_8.9p1, MySQL v8.0.35, Redis Server v7.0.11).
• Kategori & Güvenlik Riski Sınıflandırması: Portları kategorilere (Web, Veritabanı, Uzak Erişim, Dosya, Posta, Altyapı) ayırır ve güvenlik risk düzeyi (Düşük, Orta, Yüksek) atar.
• Hızlı Bağlantı & Aksiyonlar: Tek tıkla Tarayıcıda Aç (HTTP/HTTPS), SSH Komutunu Kopyala, RDP Komutunu Kopyala veya Detayları Kopyala.
• Zengin Dışa Aktarma (Export): Sonuçları CSV, JSON, TXT raporu olarak indirebilir veya tek tuşla panoya kopyalayabilirsiniz.

⁠🌐 2. Yerel Ağ & VLAN Tarayıcı (Subnet & Device Discovery)

• Çoklu Arayüz & VLAN Desteği: İstenilen fiziksel ağ bağdaştırıcısı ve "10, 20" gibi VLAN etiketleri üzerinden direkt 802.1Q (Trunk) ping süpürmesi yapabilir.
• Kilitlenmeyen Hibrit Çözümleyici (DNS & NetBIOS): Ağdaki cihaz isimleri, tek kanallı ve tıkanmaya müsait işletim sistemi Libc yöntemleri yerine; tam eşzamanlı kendi içinde DNS (UDP 53) ve doğrudan Windows NetBIOS (UDP 137) asenkron modülleri ile saniyeler içerisinde bulunur.
• Özel İsimlendirme & Hatırlama: Tablodan cihaz isimlerine tıklayarak dilediğiniz özel ismi verebilirsiniz. Cihaz tekrar ağda saptandığında bu isim kalıcı (JSON DB üzerinden) olarak korunur.
• Çevrimdışı Üretici Eşleştirme: İnternet bağlantısı olmasa dahi içerisinde barındırdığı lokal config/mac-vendor.txt eşleşme veritabanı sayesinde "OUI" tabanlı üretici (vendor) tespiti yapar.
• Wake-on-LAN (WOL): Modül içerisinden tek tuş ile uyku halindeki bir cihazı ağ üzerinden yönlendirilen Magic Packet (UDP broadcast) vasıtası ile otomatik ayağa kaldırabilir.

⁠🏗️ Mimari ve Teknolojik Altyapı

Uygulama tam modüler "Frontend <-> API <-> Backend" yapısına evrilmiştir:

• Backend: Flask (Python 3.9 REST API), Scapy (asenkron ham paket işleme), python-nmap (tcp analizi), dnspython (asenkron ters DNS çözümleme).
• Frontend: Vanilla HTML5, CSS3, JS kullanılarak sıfır harici kütüphane bağımlılığı ile pürüzsüz Glassmorphism bir UI geliştirilmiştir.
• Güvenlik Mekanizmaları: UI tarafında işlemlerin veya işlemci havuzlarının askıda kalmasını ve ardışık taramaları kitlemesini engelleyen "45 Saniye Otomatik Güvenlik Sıfırlama" protokolüne sahiptir.

⁠💻 Kurulum & Çalıştırma

⁠Docker Compose ile Çalıştırma (Önerilen)

Bu proje Çoklu Mimari (Multi-Arch) olarak inşa edilmiştir. Hem klasik x86_64 (Intel/AMD tabanlı) hem de Raspberry Pi (ARM64, ARMv7) üzerinde doğrudan çalışır.

docker-compose up -d --build

Uygulama arayüzüne http://<SUNUCU_IP>:5005 adresinden erişebilirsiniz.

⁠📡 REST API & SSE Uç Noktaları