Muhammad-Ayyan-Hussain/Network-Scanner

# NetShield NetShield is an open-source network scanning and vulnerability reporting tool designed for cybersecurity learning, Information security projects, and authorized network assessments. ## Features - Active host discovery - Port scanning - Full port scan support - Service detection - Version detection - OS detection - Vulnerability rule matching - Risk severity classification - HTML report generation - JSON report generation - CSV report generation - SQLite scan history - Timing templates - Custom port scanning - No-ping scan mode - Keyboard interrupt handling - Error handling ## Project Structure NetShield/ │ ├── netshield/ │ ├── __init__.py │ ├── scanner.py │ ├── vulnerability.py │ ├── database.py │ └── report.py │ ├── main.py ├── history.py ├── requirements.txt ├── README.md ├── Screenshots/ ├── reports/ (created automatically) └── netshield.db (created automatically after first scan) ## Requirements - Python 3.8+ - Nmap - SQLite3 - python-nmap - rich - jinja2 ## Download Project Clone the repository: git clone https://github.com/Muhammad-Ayyan-Hussain/Network-Scanner.git cd Network-Scanner ## Environment Setup and Dependency Installation ### Step 1: Update Package Lists sudo apt update ### Step 2: Install Required Packages sudo apt install python3 python3-pip python3-venv nmap -y sudo apt install sqlite3 libsqlite3-dev sqlitebrowser -y ### Step 3: Create Virtual Environment python3 -m venv venv ### Step 4: Activate Virtual Environment source venv/bin/activate ### Step 5: Install Python Dependencies pip install -r requirements.txt The `requirements.txt` file contains: python-nmap rich jinja2 You are now ready to use NetShield. ## First Run Run a basic scan to verify the installation: python3 main.py --target 127.0.0.1 This will automatically: - Create netshield.db - Create the required database tables - Verify that Nmap is working correctly ## Usage ### Basic Scan Perform a normal scan against a target: python3 main.py --target 192.168.1.1 ### Quick Scan Scans common ports and performs service/version detection. python3 main.py --target 192.168.1.1 --scan-type quick ### Full Port Scan Scans all ports from 1 to 65535. python3 main.py --target 192.168.1.1 --scan-type full ### Active Host Discovery Discover active hosts without performing port scans. python3 main.py --target 192.168.1.0/24 --discover ### Custom Port Scan Scan specific ports only. python3 main.py --target 192.168.1.1 --ports 22,80,443 ### No Ping Scan Useful when ICMP ping is blocked. python3 main.py --target 192.168.1.1 --no-ping ### Generate Reports Generate HTML report only: python3 main.py --target 192.168.1.1 --output html Generate JSON report only: python3 main.py --target 192.168.1.1 --output json Generate CSV report only: python3 main.py --target 192.168.1.1 --output csv Generate all report formats: python3 main.py --target 192.168.1.1 --output all ## Advanced Scan Modes The following scan modes require root privileges. ### OS Detection sudo $(which python) main.py --target 192.168.1.1 --scan-type os ### Stealth Scan sudo $(which python) main.py --target 192.168.1.1 --scan-type stealth ### UDP Scan sudo $(which python) main.py --target 192.168.1.1 --scan-type udp ### Aggressive Scan sudo $(which python) main.py --target 192.168.1.1 --scan-type aggressive ## Database Usage NetShield automatically creates a SQLite database named: netshield.db The database is created automatically during the first scan execution. Example: python3 main.py --target 127.0.0.1 After the first successful scan, the file `netshield.db` will appear in the project directory. ### View Scan History python3 history.py This displays previously saved scan results. ### Open Database Using SQLite Browser Install SQLite Browser: sudo apt install sqlitebrowser -y Launch it: sqlitebrowser netshield.db Or: sqlitebrowser Then open: netshield.db ### View Database Using Terminal sqlite3 netshield.db Show tables: .tables View saved scans: SELECT * FROM scans; Exit SQLite: .quit ## Reports Generated reports are stored automatically inside: reports/ Supported report formats: * HTML * JSON * CSV ## Example Generate all reports: python3 main.py --target 192.168.1.1 --scan-type quick --output all Generated files: reports/ ├── scan_report_xxx.html ├── scan_report_xxx.json └── scan_report_xxx.csv ## Screenshots Screenshots demonstrating the tool can be found in the `Screenshots/` directory. ## Security Notice NetShield is intended for educational purposes, cybersecurity learning, and authorized security assessments only. Users are responsible for obtaining proper authorization before scanning any network, host, or system. Unauthorized scanning may violate laws, regulations, or organizational policies.

标签：后端开发