Skip to content

Latest commit

 

History

History
126 lines (85 loc) · 3.21 KB

README.md

File metadata and controls

126 lines (85 loc) · 3.21 KB

Go Port Scanner with Web UI

A simple yet powerful port scanner written in Go, featuring a web-based user interface. This tool allows you to scan open ports on a given IP address using TCP or UDP protocols. It supports custom port ranges, concurrency control, and timeout configuration.

port scanner

Features

  • Web-Based UI: Easily interact with the port scanner via a browser.
  • Custom Port Range: Scan a specific range of ports (e.g., 1-1024).
  • Protocol Support: Scan using TCP or UDP protocols.
  • Concurrency Control: Limit the number of concurrent scans to avoid overwhelming the system.
  • Timeout Configuration: Set a custom timeout for each connection attempt.
  • Detailed Results: View open ports, closed ports, and error messages in a clean table format.

Prerequisites

  • Go: Ensure Go is installed on your system. You can download it from golang.org.
  • Web Browser: Any modern web browser to access the UI.

Installation

  1. Clone the repository:

    git clone https://github.com/RohanCyberOps/go-port-scanner.git
cd go-port-scanner

  2. Build and run the application:

    go run main.go

  3. Open your browser and navigate to:

    http://localhost:8080

Usage

  1. Enter Scan Details:

    • IP Address: The target IP address to scan.
    • Protocol: Choose between TCP or UDP.
    • Start Port: The first port in the range to scan.
    • End Port: The last port in the range to scan.
    • Timeout: The connection timeout (e.g., 1s for 1 second).
    • Max Concurrency: The maximum number of concurrent scans.

  2. Start the Scan:

    • Click the Start Scan button to begin the scan.

  3. View Results:

    • The results will be displayed in a table below the form, showing the port number, status (Open/Closed), and a message.

Example

Input:

  • IP Address: 127.0.0.1
  • Protocol: TCP
  • Start Port: 1
  • End Port: 1024
  • Timeout: 1s
  • Max Concurrency: 100

Output:

Port Status Message
22 Open Success
80 Open Success
443 Open Success
... Closed Connection refused

Project Structure

go-port-scanner/
├── main.go            # Main Go application
├── index.html         # HTML template for the UI
├── static/
│   └── style.css      # CSS for styling the UI
├── README.md          # Project documentation

Customization

  • Port Range: Modify the StartPort and EndPort values in the UI to scan a different range.
  • Concurrency: Adjust the Max Concurrency value to control the number of simultaneous scans.
  • Timeout: Change the timeout value to increase or decrease the connection attempt duration.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.

Author

Rohan Naagar

Enjoy using the Go Port Scanner! 🚀