https://github.com/whitehatboy005/port-scanner

This Python-based port scanner helps you identify open ports and the services associated with them on a given target (IP address or domain). It supports scanning a range of ports concurrently using threads, making it faster and efficient.
https://github.com/whitehatboy005/port-scanner

port-scanner port-scanner-in-python port-scanning

Last synced: 9 days ago
JSON representation

This Python-based port scanner helps you identify open ports and the services associated with them on a given target (IP address or domain). It supports scanning a range of ports concurrently using threads, making it faster and efficient.

• Host: GitHub
• URL: https://github.com/whitehatboy005/port-scanner
• Owner: whitehatboy005
• License: mit
• Created: 2024-12-28T15:10:47.000Z (13 days ago)
• Default Branch: main
• Last Pushed: 2024-12-28T15:39:11.000Z (13 days ago)
• Last Synced: 2024-12-28T16:23:58.908Z (13 days ago)
• Topics: port-scanner, port-scanner-in-python, port-scanning
• Language: Python
• Homepage:
• Size: 7.81 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Port Scanner

[![License](https://img.shields.io/github/license/whitehatboy005/Blockchain-Based-Voting-System)](LICENSE.md)

This project is a simple command-line tool written in Go that scans ports on a target domain or IP address. It can scan a range of ports, check which ports are open, and record the results to an output file. It also supports scanning a list of domains from a file.

## Features

- **Port Scanning**: Scan a specific range of ports on a target domain or IP address.

- **Service Detection**: Identifies common services running on open ports such as FTP, HTTP, SSH, etc.

- **Domain List Scanning**: Scan multiple domains from a list stored in a file.

- **Output to File**: Save results to a file in a readable format.

- **Parallel Scanning**: Uses goroutines to scan multiple ports concurrently for faster results.

## Requirements

- Go 1.18 or higher

## Installation

1. Clone the repository to your local machine:

   ```bash

   git clone https://github.com/whitehatboy005/Port-Scanner.git

   ```

2. Navigate to the project directory:

   ```bash

   cd Port-Scanner

   ```

3. Build the project:

   ```bash

   go build -o portscan portscan.go

   ```

4. Make it executable

   ```bash

    sudo chmod +x portscan

   ```

5. Move the binary to /usr/local/bin for global access

   ```bash

   sudo mv portscan /usr/local/bin/

   ```

## Usage

You can run the port scanner using the following command-line flags:

### Flags

- `-t `: Target domain or IP address to scan.

- `-s `: Start port number (default: 1).

- `-e `: End port number (default: 10000).

- `-o `: Output file to save the results (default: `results.txt`).

- `-l `: File with a list of domains to scan.

- `-h`: Display help menu.

#

![Screenshot 2024-12-29 110115](https://github.com/user-attachments/assets/cb8093eb-18f3-4612-8032-f5c953d87f4d)

## Examples

1. **Scan a single target (example: google.com) from port 1 to 1000 and save the results to `results.txt`:**

   ```bash

   portscan -t google.com -s 1 -e 1000 -o results.txt

   ```

2. **Scan a list of domains from domains.txt file from port 1 to 1000 and save the results to results.txt:**

   ```bash

   portscan -l domains.txt -s 1 -e 1000 -o results.txt

   ```

## Example output

  ```

     Results for google.com:

     Port 80 - HTTP

     Port 443 - HTTPS

     Scanning completed in 1.02 seconds

  ```

#

## License

This project is licensed under the terms of the [MIT license](LICENSE.md).