________ _________
/ _____/ ____ / _____/ ____ _____ ____
/ \ ___ / _ \\_____ \_/ ___\\__ \ / \
\ \_\ ( <_> / \ \___ / __ \| | \
\______ /\____/_______ /\___ (____ |___| /
\/ \/ \/ \/ \/
Golang network scanner and service detection tool.
- Multiplatform support (Windows, Linux, Mac)
- Support only TCP scans
- Service and application version detection function, the built-in fingerprint probe adopts: [ nmap-service-probes ] (https://raw.githubusercontent.com/nmap/nmap/master/nmap-service-probes)
- Custom modules functionality (you can do whatever you want with the scan results)
Generally because my goal was to get some knowledge of Golang programming. Honestly, I think it's not the right language for this kind of project, but I still happy that I used Golang.
Usage of ./scanner:
-all
scan for all mathces
-csv
Output as CSV
[BOOL] default false
-e string
Exclude the following field from the output.
CSV mode only
-e Banner,RawBanner,Hostname
-h string
Host to be scanned, supports four formats:
192.168.1.1
192.168.1.1-10
192.168.1.*
192.168.1.0/24.
-i string
Include only the following field from the output.
CSV mode only
Overrides exclude filer
-i IP,Name,Port
-o string
Output the scanning information to file.
CSV mode only
-p string
Customize port list, separate with ',' example: 21,22,80-99,8000-8080 ... (default "80-99,7000-9000,9001-9999,4430,1433,1521,3306,5000,5432,6379,21,22,100-500,873,4440,6082,3389,5560,5900-5909,1080,1900,10809,50030,50050,50070")
-t int
Setting scaner connection timeouts,Maxtime 30 Second. (default 2)The scanner uses nmap probes to scan the targets - So there are a lot of services that can be recognized by this tool.
The most interesting part of this project is the Modules option.
I wanted to provide a functionality of modules so every user can add his own code to work with the scan result. (Take a look on the Modules folder and package)
As an example, SMB module is provided.
The Module should implement just one function, with the following signature
func module(result *(Types.Result)) {}
Then it should register itself into the modules list. For example -
data.PortModules[<port>] = append(data.PortModules[<port>], <module function>)
You can always refer to the demo SMB module. You can find there all you need to know.
This project is based on ServerScan. I fixed a lot of bugs, documented the code and added some more functionality.
- iprange - IPv4 address parser for the nmap format
- ServerScan - Network Scanner in go, this project is based on ServerScan.
- vscan-go - Golang version for nmap service and application version detection