Skip to content

GoMapper is a fast, cross-platform port scanner written in Go for discovering open services on remote hosts.

License

Notifications You must be signed in to change notification settings

3rr0r-505/GoMapper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GoMapper - Simple Go-based Port Scanner

Go Version License Release Version Issues Pull Requests Stars Forks Last Commit

    ________     ______  ___                                   
  __  ____/________   |/  /_____ _____________________________
  _  / __ _  __ \_  /|_/ /_  __ `/__  __ \__  __ \  _ \_  ___/
  / /_/ / / /_/ /  /  / / / /_/ /__  /_/ /_  /_/ /  __/  /    
  \____/  \____//_/  /_/  \__,_/ _  .___/_  .___/\___//_/     
                                 /_/     /_/             _ 

GoMapper is a fast and efficient tool for scanning ports on a target system, similar to Nmap. It allows you to scan specific ports or a range of ports to gather information about open services.

Features

  • Scan specific ports or port ranges.
  • Support for different platforms (Windows, Linux).
  • Banner grabbing for open ports.
  • Fast and easy to use.
  • Written in Go (No need for Go installation on user machines).

Installation

Install with Go

If you have Go installed, you can easily install GoMapper using the following command:

go install github.com/3rr0r-505/GoMapper@latest

This will download and install GoMapper into your $GOPATH/bin (or $GOBIN) directory. Once installed, you can run GoMapper from anywhere in your terminal.

Alternatively, if you want to install a specific version, you can do so like this:

go install github.com/3rr0r-505/GoMapper@<release tag>

Update with Go

rm -rf $(go env GOPATH)/pkg/mod/github.com/3rr0r-505
rm -f $(go env GOPATH)/bin/GoMapper
go clean -cache && go clean -modcache
go install github.com/3rr0r-505/GoMapper@<release tag>

Install from Release (✅ Recommended)

You can also download pre-built executables for different platforms directly from the releases page.

Windows 64-bit: GoMapper-windows-amd64.exe

Windows 32-bit: GoMapper-windows-x86.exe

Linux 64-bit: GoMapper-linux-amd64

Linux 32-bit: GoMapper-linux-x86

Download the appropriate binary for your platform, make it executable, and run it directly.

Usage

After installation, you can run GoMapper from your terminal using the following command:

GoMapper --help

Command Options

--host: Specify the target host or IP address (default: 127.0.0.1).

--ports: Specify a comma-separated list of ports or a range of ports (default: the top 1000 ports from Nmap).

--output: Optionally, store the result in a text file.

Examples

Scan a specific host and ports:

GoMapper --host 192.168.1.1 --ports 80,443

Scan a range of ports on a host:

GoMapper --host example.com --ports 20-25

Scan all ports and save the output to a file:

GoMapper --host example.com --ports * --output "scan.txt"

⚠️Note: While installing via go install is quick and easy, it might encounter issues related to dependencies or updates in the future. If you face any update issues, consider downloading the pre-built executables from the releases page for a smoother experience.


Contributing

Contributions are welcome! Feel free to open issues or pull requests for any improvements or bug fixes. For more info, visit CONTRIBUTING.md

Legal Disclaimer

The use of code contained in this repository, either in part or in its totality, for engaging targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state and federal laws.

Developers assume no liability and are not responsible for misuses or damages caused by any code contained in this repository in any event that, accidentally or otherwise, it comes to be utilized by a threat agent or unauthorized entity as a means to compromise the security, privacy, confidentiality, integrity, and/or availability of systems and their associated resources. In this context the term "compromise" is henceforth understood as the leverage of exploitation of known or unknown vulnerabilities present in said systems, including, but not limited to, the implementation of security controls, human- or electronically-enabled.

The use of this code is only endorsed by the developers in those circumstances directly related to educational environments or authorized penetration testing engagements whose declared purpose is that of finding and mitigating vulnerabilities in systems, limiting their exposure to compromises and exploits employed by malicious agents as defined in their respective threat models.

License

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

About

GoMapper is a fast, cross-platform port scanner written in Go for discovering open services on remote hosts.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages