Skip to content

psyclox/netshark

Repository files navigation

Netshark 🦈

Netshark is a professional Network Traffic Anomaly Detector designed for security researchers and network administrators. It analyzes PCAP files or captures live traffic to detect suspicious activities.

🚀 Features

  • Port Scan Detection: Identifies potential SYN scans and port sweeping.
  • ARP Spoofing Detection: Detects IP/MAC conflicts and gratuitous ARP floods.
  • DNS Tunneling Detection: Analyzes DNS queries for suspicious lengths and entropy.
  • Suspicious IP Detection: Flags communications with suspicious or non-standard IP ranges.
  • Professional Reports: Clear, color-coded CLI output.

🛠️ Installation

Netshark is designed to be easily installed on Kali Linux and other Python-supported environments.

  1. Clone the repository:

    git clone https://github.com/yourusername/netshark.git
    cd netshark
  2. Install dependencies:

    pip install -r requirements.txt

    Note: You may need sudo for packet capturing permissions.

  3. Install system dependencies (Optional but recommended for Pyshark):

    sudo apt-get install tshark

📖 Usage

Run Netshark via the command line:

python main.py -f <path_to_pcap.pcap>

Options:

  • -f, --file: Path to the PCAP file to analyze.
  • -i, --interface: Network interface for live capture (Coming Soon).
  • -h, --help: Show help message.

🛡️ Modules

  • Port Scanning: Tracks fast connection attempts from a single source.
  • ARP Monitoring: Watches for MAC address flip-flopping.
  • DNS Analysis: High entropy domain queries.

⚠️ Disclaimer

Netshark is for educational and authorized testing purposes only. Usage for attacking targets without prior mutual consent is illegal.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages