Python Nmap Scanner

English | Türkçe

---

🇬🇧 English

Python Nmap Scanner is a simple yet effective network scanning tool built with Python and the nmap library. It performs TCP SYN scans to identify open ports and detects service versions on a target IP address.

🚀 Features

• TCP SYN Scan (-sS): Performs fast and stealthy half-open scanning (requires root privileges).
• Version Detection (-sV): Identifies service names, product details, and version numbers running on open ports.
• Structured Output: clearly lists the port, state, service name, and version details.

🛠️ Installation

Before running the script, ensure you have Nmap installed on your system.

1. Install System Dependencies (Linux/Kali)

sudo apt update
sudo apt install nmap -y

2. Install Python Library
Bash

pip install python-nmap

3. Clone the Repository
Bash

git clone [https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git](https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git)
cd YOUR_REPO_NAME

💻 Usage

Since the tool uses TCP SYN Scan (-sS), it requires raw socket access. Therefore, you must run the script with sudo (root) privileges.
Bash

sudo python3 my_nmap.py

Example Output:
Plaintext

>> 192.168.1.10
192.168.1.10 : up
Open Ports : dict_keys([22, 80])
22 open ssh OpenSSH 8.2p1 Ubuntu
80 open http Apache httpd 2.4.41

⚠️ Disclaimer

This tool is designed for educational purposes and authorized security testing only. Scanning networks or systems without permission is illegal. The developer is not responsible for any misuse of this tool.

<a name="türkçe"></a>
🇹🇷 Türkçe

Python Nmap Scanner, Python ve nmap kütüphanesi kullanılarak geliştirilmiş, hedef sistem üzerinde port ve versiyon taraması yapan bir güvenlik aracıdır.
🚀 Özellikler

    TCP SYN Taraması (-sS): Hızlı ve "yarı-gizli" (half-open) tarama yapar (Root yetkisi gerektirir).

    Versiyon Tespiti (-sV): Açık portlarda çalışan servislerin isimlerini ve versiyon numaralarını tespit eder.

    Detaylı Çıktı: Port durumu, servis adı, ürün ve versiyon bilgisini düzenli bir şekilde listeler.

🛠️ Kurulum

Aracı çalıştırmadan önce sisteminizde Nmap'in kurulu olduğundan emin olun.

1. Sistem Gereksinimleri (Linux/Kali)
Bash

sudo apt update
sudo apt install nmap -y

2. Python Kütüphanesini Yükleyin
Bash

pip install python-nmap

3. Projeyi İndirin
Bash

git clone [https://github.com/KULLANICI_ADINIZ/REPO_ADINIZ.git](https://github.com/KULLANICI_ADINIZ/REPO_ADINIZ.git)
cd REPO_ADINIZ

💻 Kullanım

Kod, TCP SYN Scan yöntemini kullandığı için ağ kartına doğrudan erişim (raw socket) gerektirir. Bu yüzden scripti sudo ile çalıştırmalısınız.
Bash

sudo python3 my_nmap.py

Örnek Çıktı:
Plaintext

>> 192.168.1.10
192.168.1.10 : up
Open Ports : dict_keys([22, 80])
22 open ssh OpenSSH 8.2p1 Ubuntu
80 open http Apache httpd 2.4.41

⚠️ Yasal Uyarı

Bu araç yalnızca eğitim amaçlı ve izniniz olan ağlarda (kendi yerel ağınız veya sızma testi izni aldığınız sistemler) kullanım içindir. Yetkisiz tarama yapmak suç teşkil edebilir. Geliştirici, bu aracın yanlış kullanımından sorumlu değildir.