Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/justintimperio/gomap
A fully self-contained Nmap like parallel port scanning module in pure Golang that supports SYN-ACK (Silent Scans)
https://github.com/justintimperio/gomap
golang gomap nmap parallel port-scanner portscan portscanner scanning service-discovery syn-ack tcp-scanner udp-scanning
Last synced: 12 days ago
JSON representation
A fully self-contained Nmap like parallel port scanning module in pure Golang that supports SYN-ACK (Silent Scans)
- Host: GitHub
- URL: https://github.com/justintimperio/gomap
- Owner: JustinTimperio
- License: mit
- Created: 2021-03-08T01:56:22.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-05-31T09:54:58.000Z (over 1 year ago)
- Last Synced: 2024-10-23T11:12:04.365Z (21 days ago)
- Topics: golang, gomap, nmap, parallel, port-scanner, portscan, portscanner, scanning, service-discovery, syn-ack, tcp-scanner, udp-scanning
- Language: Go
- Homepage:
- Size: 181 KB
- Stars: 86
- Watchers: 5
- Forks: 19
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gomap
[](https://pkg.go.dev/github.com/JustinTimperio/gomap)
[](https://goreportcard.com/report/github.com/JustinTimperio/gomap)
[](https://www.codacy.com/gh/JustinTimperio/gomap/dashboard?utm_source=github.com&utm_medium=referral&utm_content=JustinTimperio/gomap&utm_campaign=Badge_Grade)
## What is gomap?
Gomap is a fully self-contained nmap like module for Golang. Unlike other projects which provide nmap C bindings or rely on other local dependencies, gomap is a fully implemented in pure Go. Gomap imports zero non-core modules making it ideal for applications that have zero control on the clients operating system. Since this is a small library, it only focuses on providing a few core features. For the most part its API is stable with changes being applied to its unexposed internal scanning functions.
## Features
- Parallel port scanning using go routines
- Automated CIDR range scanning
- Service prediction by port number
- SYN (Silent) Scanning Mode
- UDP Scanning (Non-Stealth)
- Fast and detailed scanning for common ports
- Pure Go with zero dependencies
- Easily integrated into other projects
## Upcoming Features
- CIDR range size detection
## Example Usage - 1
Performs a fastscan for the most common ports on every IP on a local range
### Create Files
1. Create `quickscan.go`
```go
package main
import (
"fmt"
"github.com/JustinTimperio/gomap"
)
func main() {
var (
proto = "tcp"
fastscan = true
syn = false
)
scan, err := gomap.ScanRange(proto, fastscan, syn)
if err != nil {
// handle error
}
fmt.Printf(scan.String())
}
```
2. `go mod init quickscan`
3. `go mod tidy`
4. `go run quickscan.go`
### Example Output
```
Host: computer-name (192.168.1.132)
| Port Service
| ---- -------
|---- 22 ssh
Host: server-nginx (192.168.1.143)
| Port Service
| ---- -------
|---- 443 https
|---- 80 http
|---- 22 ssh
Host: server-minio (192.168.1.112)
| Port Service
| ---- -------
|---- 22 ssh
Host: some-phone (192.168.1.155)
|- No Open Ports
```
## Example Usage - 2
Performs a detailed stealth scan on a single IP
### Create Files
1. Create `stealthmap.go`
```go
package main
import (
"fmt"
"github.com/JustinTimperio/gomap"
)
func main() {
// Stealth scans MUST be run as root/admin
var (
fastscan = false
syn = true
proto = "tcp"
ip = "192.168.1.120"
)
scan, err := gomap.ScanIP(ip, proto, fastscan, syn)
if err != nil {
// handle error
}
fmt.Printf(scan.String())
}
```
2. `go mod init stealthmap`
3. `go mod tidy`
4. `sudo go run stealthmap.go`
### Example Output
```
Host: 192.168.1.120 | Ports Scanned 3236/3236
Host: Voyager (192.168.1.120)
| Port Service
| ---- -------
|---- 22 SSH Remote Login Protocol
|---- 80 World Wide Web HTTP
|---- 443 HTTP protocol over TLS/SSL
```