⚡ Mini Nmap — Hızlı Çok İş Parçacıklı Port Tarayıcı

Python ile yazılmış, terminal tabanlı, Threading destekli profesyonel port tarama aracı.
Siber güvenlik analistleri için hızlı keşif (reconnaissance) amacıyla geliştirilmiştir.

---

📖 Hakkında

Mini Nmap, socket ve threading kütüphaneleri kullanılarak sıfırdan geliştirilmiş, hafif ve son derece hızlı bir port tarama aracıdır. Nmap'ın karmaşıklığına ihtiyaç duymadan; hızlı keşif, CTF çözümleri, ağ güvenliği denetimleri ve laboratuvar ortamlarında hızlı port kontrolü yapmak isteyen güvenlik analistleri için tasarlanmıştır.

⚠️ Yasal Uyarı: Bu aracı yalnızca sahibi olduğunuz veya tarama yapmak için açık izin aldığınız sistemlerde kullanın. İzinsiz port taraması birçok ülkede yasa dışıdır.

---

✨ Özellikler

• 🚀 Çoklu İş Parçacığı (Threading + Queue): Aynı anda 100+ port paralel taranır, saniyeler içinde sonuç alınır.
• 🎯 Akıllı Varsayılan Port Listesi: 21, 22, 23, 25, 53, 80, 110, 135, 139, 143, 443, 445, 1433, 1521, 3306, 3389, 5432, 8080 gibi 35+ kritik servis portu otomatik taranır.
• 🔧 Özel Port Aralığı Desteği: 1-1000 gibi aralıklar ile tam kontrol.
• 🎨 Renkli Terminal Arayüzü: colorama ile mor/yeşil temalı ASCII banner ve canlı sonuç akışı.
• 📝 Otomatik Raporlama: Tarama sonuçları nmap_scan_report.txt dosyasına düzenli log formatında kaydedilir.
• 🛡️ Sağlam Hata Yönetimi: Geçersiz IP/domain girişlerinde çökmez, Ctrl+C ile temiz çıkış yapar.
• ⚡ Optimize Timeout: Varsayılan 1.0 saniyelik bağlantı zaman aşımı ile hız/doğruluk dengesi sağlanır.

---

📂 Proje Yapısı

mini-nmap/
├── main.py              # Ana uygulama (tek dosya, bağımsız çalışır)
├── requirements.txt      # Bağımlılıklar
└── README.md              # Bu dosya

---

🔧 Kurulum

# Depoyu klonlayın
git clone https://github.com/1778911/mini-nmap.git
cd mini-nmap

# Bağımlılıkları kurun
pip install -r requirements.txt

Gereksinimler: Python 3.7 veya üzeri.

---

🚀 Kullanım

Etkileşimli Mod (parametre girmeden)

python main.py

Program sizden hedef ve isteğe bağlı özel port aralığı girmenizi ister.

Komut Satırı Argümanları ile Hızlı Kullanım

# Varsayılan popüler portları tara
python main.py target-site.com

# Belirli bir IP'yi tara
python main.py 192.168.1.1

# Özel port aralığı belirle (1'den 1000'e kadar)
python main.py target-site.com -p 1-1000

# Thread sayısını ve timeout süresini özelleştir
python main.py target-site.com -p 1-65535 -t 200 --timeout 0.5

Parametreler

Parametre	Açıklama	Varsayılan
target	Hedef IP adresi veya alan adı	—
-p, --ports	Özel port aralığı, örn: 1-1000	Popüler portlar
-t, --threads	Eş zamanlı çalışacak thread sayısı	100
--timeout	Bağlantı zaman aşımı süresi (saniye)	1.0

---

🖥️ Örnek Çıktı

   ███╗   ███╗██╗███╗   ██╗██╗   ███╗   ██╗███╗   ███╗ █████╗ ██████╗
   ████╗ ████║██║████╗  ██║██║   ████╗  ██║████╗ ████║██╔══██╗██╔══██╗
   ██╔████╔██║██║██╔██╗ ██║██║   ██╔██╗ ██║██╔████╔██║███████║██████╔╝
   ██║╚██╔╝██║██║██║╚██╗██║██║   ██║╚██╗██║██║╚██╔╝██║██╔══██║██╔═══╝
   ██║ ╚═╝ ██║██║██║ ╚████║██║   ██║ ╚████║██║ ╚═╝ ██║██║  ██║██║
   ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝   ╚═╝  ╚═══╝╚═╝     ╚═╝╚═╝  ╚═╝╚═╝
        ⚡ Hızlı Çok İş Parçacıklı Port Tarayıcı (CLI) ⚡
        Siber Güvenlik Analistleri için geliştirilmiştir.

[*] Hedef çözümleniyor: target-site.com ...
[✓] Hedef IP bulundu     : 93.184.216.34
[✓] Taranacak Port Sayısı: 35
[✓] Başlangıç Zamanı     : 2026-07-14 13:20:01
[✓] Thread Sayısı        : 100
------------------------------------------------------------
[*] Tarama başlıyor...

[+] PORT 80     [Açık]  -> HTTP
[+] PORT 443    [Açık]  -> HTTPS

============================================================
                 TARAMA ÖZETİ
============================================================
Hedef              : target-site.com (93.184.216.34)
Açık Port Sayısı   : 2
Kapalı Port Sayısı : 33
Taranan Toplam Port: 35
Geçen Süre         : 0.87 saniye
============================================================
[*] Detaylı rapor 'nmap_scan_report.txt' dosyasına kaydedildi.

---

📄 Rapor Dosyası Örneği (nmap_scan_report.txt)

============================================================
            MINI NMAP - PORT TARAMA RAPORU
============================================================
Hedef              : target-site.com
Çözümlenen IP      : 93.184.216.34
Tarama Başlangıcı  : 2026-07-14 13:20:01
Taranan Port Sayısı: 35
Geçen Süre         : 0.87 saniye
------------------------------------------------------------
Açık Port Sayısı   : 2

PORT      DURUM     SERVİS
------------------------------------------------------------
80        Açık      HTTP
443       Açık      HTTPS
------------------------------------------------------------
Kapalı/Erişilemeyen Port Sayısı: 33
============================================================
Rapor Mini Nmap tarafından otomatik oluşturulmuştur.

---

🛡️ Hata Yönetimi

• ❌ Geçersiz/ulaşılamayan domain: Program çökmez, açıklayıcı bir hata mesajı gösterip temiz şekilde sonlanır.
• ⌨️ Ctrl+C ile durdurma: Aktif thread'ler güvenli şekilde kapatılır, o ana kadarki sonuçlar rapora yazılır.
• 🔢 Geçersiz port aralığı: 1-1000 formatına uymayan girişler kullanıcıya bildirilir.

---

🧩 Kullanılan Teknolojiler

• Python 3 — Ana dil
• socket — TCP bağlantı testleri
• threading + queue — Paralel tarama motoru
• colorama — Renkli terminal çıktısı
• argparse — Komut satırı arayüzü

---

🤝 Katkıda Bulunma

Pull request'ler ve öneriler memnuniyetle karşılanır! Büyük değişiklikler için lütfen önce bir issue açarak neyi değiştirmek istediğinizi tartışalım.

📜 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır.

Geliştirici:Ali DÜZ

Made with 💜 for the Cybersecurity Community