https://github.com/vokomarov/netshark

One more port and host scanner in Golang
https://github.com/vokomarov/netshark

arp cli golang golang-package golang-tools host-scanner linux network-analysis networking open-source port-scanner tcp windows

Last synced: about 1 month ago
JSON representation

One more port and host scanner in Golang

• Host: GitHub
• URL: https://github.com/vokomarov/netshark
• Owner: vokomarov
• License: mit
• Created: 2020-03-07T19:35:44.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-03-09T12:25:15.000Z (over 6 years ago)
• Last Synced: 2024-06-20T03:36:37.332Z (almost 2 years ago)
• Topics: arp, cli, golang, golang-package, golang-tools, host-scanner, linux, network-analysis, networking, open-source, port-scanner, tcp, windows
• Language: Go
• Homepage:
• Size: 50.8 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# netshark

[![Build Status](https://travis-ci.com/vokomarov/netshark.svg?branch=master)](https://travis-ci.com/vokomarov/netshark)

[![Coverage Status](https://coveralls.io/repos/github/vokomarov/netshark/badge.svg?branch=master)](https://coveralls.io/github/vokomarov/netshark?branch=master)

[![GoDoc](https://godoc.org/github.com/vokomarov/netshark?status.svg)](https://godoc.org/github.com/vokomarov/netshark)

[![Go Report Card](https://goreportcard.com/badge/github.com/vokomarov/netshark)](https://goreportcard.com/report/github.com/vokomarov/netshark)

## Overview

`netshark` is a simple command line tool to scan your local network to available hosts and his opened ports.

Features:

- Scan local network neighbor hosts

- Display client MAC address

Coming soon:

- Scan opened TCP ports

- Specify scanning port ranges

- Use predefined port ranges to scan

- Multithreaded scan

- Shadow scan

- Use STDIN as source of hosts to support Unix pipes

## Installation

#### Installing from Source

```

go get -u github.com/vokomarov/netshark

```

#### Download

Download binary for your system [here](https://github.com/vokomarov/netshark/releases).

## Usage

### As a command line tool

```shell script

# Scan local network for neighbor hosts

$ netshark scan hosts [--timeout 15]

# Scan given host for opened ports of all port range

$ netshark scan ports --host 192.168.1.1 # scan specific

# Specify TCP port range from lower to higher number of ports

$ netshark scan ports --range 1,65535

$ netshark scan ports --range-min 1024 # check registered ports and private ports range

$ netshark scan ports --range-max 1023 # check only well-known port range

# Or use predefined port ranges

$ netshark scan ports --range known   # scan ports from 0 to 1023

$ netshark scan ports --range reg     # scan ports from 1024 to 49151

$ netshark scan ports --range private # scan ports from 49152 to 65535

```

### Programmatically in your code

`netshark` can be used programmatically. You can visit [godoc](https://godoc.org/github.com/vokomarov/netshark) to check API documentation.

## License

`netshark` is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).