Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ivopetiz/network-scanner
TCP Network Port Scanner written in Go, nmap style.
https://github.com/ivopetiz/network-scanner
go golang ip-scanner network network-analysis network-machine network-monitoring network-security network-visualization nmap nmap-style port-scanner portscanner tcp-port tcp-ports
Last synced: about 5 hours ago
JSON representation
TCP Network Port Scanner written in Go, nmap style.
- Host: GitHub
- URL: https://github.com/ivopetiz/network-scanner
- Owner: ivopetiz
- License: unlicense
- Created: 2017-10-22T20:13:23.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-03-07T09:24:56.000Z (over 4 years ago)
- Last Synced: 2023-03-21T20:46:50.037Z (over 1 year ago)
- Topics: go, golang, ip-scanner, network, network-analysis, network-machine, network-monitoring, network-security, network-visualization, nmap, nmap-style, port-scanner, portscanner, tcp-port, tcp-ports
- Language: Go
- Size: 1.06 MB
- Stars: 16
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://app.codacy.com/app/ivopetiz/portscanner?utm_source=github.com&utm_medium=referral&utm_content=ivopetiz/portscanner&utm_campaign=Badge_Grade_Dashboard)
[](https://travis-ci.com/ivopetiz/network-scanner)
[](https://coveralls.io/github/ivopetiz/portscanner?branch=master)
# Go-Portscanner
TCP Network Port Scanner written in Go, nmap style.
## Lib
### Usage examples
#### Scan specific ports from an IP address
```go
package main
// imports fmt lib and portscanner lib.
import "fmt"
import "github.com/ivopetiz/portscanner"
// Main function.
func main() {
// ports is an slice of strings corresponding to ports we want
// to scan.
ports := []string{"21", "22", "80"}
// ip_t is a slice of strings containing an IP address.
ip_t := []string{"192.168.1.100"}
// open_ports has the results from PortScanner.
open_ports := portscanner.PortScanner(ip, ports)
fmt.Println(open_ports)
}
```
#### Scan port 80 in a range of IP addresses
```go
package main
// imports fmt lib and portscanner lib.
import "github.com/ivopetiz/portscanner"
// Main function.
func main() {
// ports is a slice of ports to test.
ports := []string{"80"}
// IP sequence is defined by a '-' between first and last IP address .
ips_sequence := []string{"192.168.1.1-254"}
// results returns a map with open ports for each IP address.
results := portscanner.IPScanner(ips_list, ports, true)
// Once IPScanner has true for print_results, lib will present
// results in CL with a nice presentation.
}
```
## App
### Installation
```sh
go install https://github.com/ivopetiz/portscanner
git clone https://github.com/ivopetiz/portscanner.git portscanner
cd portscanner
go build cmd/portscanner/portscanner.go
```
## Usage examples
Different ways to use Go-Portscanner.
### Get help
```sh
portscanner -h
Usage of portscanner:
-A Scans all ports from port 1 to 1024
-p Port or ports to scan (default "80")
```
Shows the output above, presenting the available options.
### Localhost Portscanner
```sh
$ portscanner
```
Scans all local machine ports, from 1 to 1024.
### Network Machine Full Port Scan
```sh
$ portscanner -p 1-65535 210.67.210.76
```
Scan all TCP ports from a network machine.
### Network Discovery
```sh
$ portscanner -p 21,80 192.168.0.1-192.168.0.254
```
Looks for HTTP and FTP servers on 192.168.0.0/24.
### Ping Servers
```sh
$ portscanner -p 22 113.213.200.101 4.0.75.4 84.188.238.94 11.2.224.214 153.194.246.247
```
Checks if SSH servers are up.
## TODO
- [ ] Improve performance.
- [ ] Improve presentation.
- [ ] Read IP:Port pair from file.
- [x] Tests
- [ ] Docker