Features •
Installation •
Usage •
Running naabu •
Config •
NMAP integration •
CDN Exclusion •
Discord
Naabu is a port scanning tool written in Go that allows you to enumerate valid ports for hosts in a fast and reliable manner. It is a really simple tool that does fast SYN/CONNECT scans on the host/list of hosts and lists
all ports that return a reply.
# Features
- Fast And Simple SYN/CONNECT probe based scanning.
- Optimized for ease of use and **lightweight** on resources
- **Automatic handling of duplicate hosts between multiple subdomains**
- NMAP Integration for service discovery
- Piped input / output support for integrating in workflows
- Multiple Output formats supported (JSON, File, Stdout)
- Multiple input support including HOST/IP/CIDR notation.
# Usage
```sh
naabu -h
```
This will display help for the tool. Here are all the switches it supports.
👉 naabu help menu 👈
```
Usage of ./naabu:
-c int
General internal worker threads (default 25)
-config string
Config file
-debug
Enable debugging information
-exclude-cdn
Skip full port scans for CDNs (only checks for 80,443)
-exclude-file string
Specifies a newline-delimited file with targets to be excluded from the scan (ip, cidr)
-exclude-hosts string
Specifies a comma-separated list of targets to be excluded from the scan (ip, cidr)
-exclude-ports string
Ports to exclude from enumeration
-host string
Host to find ports for
-iL string
File containing list of hosts to enumerate ports
-interface string
Network Interface to use for port scan
-interface-list
List available interfaces and public ip
-json
Write output in JSON lines Format
-nmap
Invoke nmap scan on targets (nmap must be installed)
-nmap-cli string
Nmap command line (invoked as COMMAND + TARGETS)
-no-color
Don't Use colors in output
-o string
File to write output to (optional)
-p string
Ports to scan (80, 80,443, 100-200, (-p - for full port scan)
-ping
Use ping probes for verification of host
-ports-file string
File containing ports to enumerate for on hosts
-rate int
Rate of port scan probe requests (default 1000)
-retries int
Number of retries for the port scan probe (default 3)
-s string
Scan Type (s - SYN, c - CONNECT) (default "s")
-scan-all-ips
Scan all the ips
-silent
Show found ports only in output
-source-ip string
Source Ip
-stats
Display stats of the running scan
-timeout int
Millisecond to wait before timing out (default 1000)
-top-ports string
Top Ports to scan (default top 100)
-v Show Verbose output
-verify
Validate the ports again with TCP verification
-version
Show version of naabu
-warm-up-time int
Time in seconds between scan phases (default 2)
```
# Installation Instructions
Download the ready to run [binary](https://github.com/projectdiscovery/naabu/releases/) / [docker](https://hub.docker.com/r/projectdiscovery/naabu) or install with GO
Before installing naabu, make sure to install `libpcap` library with `apt install -y libpcap-dev` on Linux
```sh
GO111MODULE=on go get -v github.com/projectdiscovery/naabu/cmd/naabu
```
# Running Naabu
To run the tool on a target, just use the following command.
```sh
naabu -host hackerone.com
```
This will run the tool against hackerone.com. There are a number of configuration options that you can pass along with this command. The verbose switch `-v` can be used to display verbose information.
```sh
naabu -host hackerone.com
__
___ ___ ___ _/ / __ __
/ _ \/ _ \/ _ \/ _ \/ // /
/_//_/\_,_/\_,_/_.__/\_,_/ v2.0.3
projectdiscovery.io
[WRN] Use with caution. You are responsible for your actions
[WRN] Developers assume no liability and are not responsible for any misuse or damage.
[INF] Running SYN scan with root privileges
[INF] Found 4 ports on host hackerone.com (104.16.100.52)
hackerone.com:80
hackerone.com:443
hackerone.com:8443
hackerone.com:8080
```
The ports to scan for on the host can be specified via `-p` parameter. It takes nmap format ports and runs enumeration on them.
```sh
naabu -p 80,443,21-23 -host hackerone.com
```
By default, the Naabu checks for nmap's `Top 100` ports. It supports following in-built port lists -
- `-top-ports 100` => Scans for nmap top 100 port
- `-top-ports 1000` => Scans for nmap top 1000 port
- `-p -` => Scans for all ports from `1-65535`.
You can also specify specific ports which you would like to exclude from the scan.
```sh
naabu -p - -exclude-ports 80,443
```
The `o` flag can be used to specify an output file.
```sh
naabu -host hackerone.com -o output.txt
```
To run the naabu on a list of hosts, `-iL` option can be used.
```sh
naabu -iL hosts.txt
```
You can also get output in json format using `-json` switch. This switch saves the output in the JSON lines format.
```sh
naabu -host hackerone.com -json
{"host":"hackerone.com","ip":"104.16.99.52","port":8443}
{"host":"hackerone.com","ip":"104.16.99.52","port":80}
{"host":"hackerone.com","ip":"104.16.99.52","port":443}
{"host":"hackerone.com","ip":"104.16.99.52","port":8080}
```
The ports discovered can be piped to other tools too. For example, you can pipe the ports discovered by naabu to `naabu` which will then find running http servers on the host.
```sh
echo hackerone.com | naabu -silent | naabu -silent
http://hackerone.com:8443
http://hackerone.com:443
http://hackerone.com:8080
http://hackerone.com:80
```
If you want a second layer validation of the ports found, you can instruct the tool to make a TCP connection for every port and verify if the connection succeeded. This method is very slow, but is really reliable. This is similar to using nmap as a second layer validation
```sh
naabu -host hackerone.com -verify
```
The speed can be controlled by changing the value of `rate` flag that represent the number of packets per second. Increasing it while processing hosts may lead to increased false-positive rates. So it is recommended to keep it to a reasonable amount.
# Configuration file
We have added support for config file, it allows each and every flag to define in config file, so you don't have to write them everytime, it's optional and not used on default run, default location of config file is `$HOME/.config/naabu/naabu.conf`, custom config file can be provided using `config` flag.
👉 Example Config File 👈
```yaml
# Number of retries
# retries: 1
# Packets rate
# rate: 100
# Timeout is the seconds to wait for ports to respond
# timeout: 5
# Hosts are the host to find ports for
# host:
# - 10.10.10.10
# Ports is the ports to use for enumeration
# ports:
# - 80
# - 100
# ExcludePorts is the list of ports to exclude from enumeration
# exclude-ports:
# - 20
# - 30
# Verify is used to check if the ports found were valid using CONNECT method
# verify: false
# Ips or cidr to be excluded from the scan
# exclude-ips:
# - 1.1.1.1
# - 2.2.2.2
# Top ports list
# top-ports: 100
# Attempts to run as root
# privileged: true
# Drop root privileges
# unprivileged: true
# Excludes ip of knows CDN ranges
# exclude-cdn: true
# SourceIP to use in TCP packets
# source-ip: 10.10.10.10
# Interface to use for TCP packets
# interface: eth0
# WarmUpTime between scan phases
# warm-up-time: 2
# nmap command to invoke after scanninginvoke after scanning
# nmap: nmap -sV
```
# Nmap integration
We have integrated nmap support with `nmap` flag, in config file you can define any `nmap` command you wish to run on the result of naabu, make sure you have `nmap` installed to use this feature.
To make use of `nmap` flag, make sure to remove the comments from the config file at `$HOME/.config/naabu/naabu.conf`
We also added `nmap-cli` flag that let you run **nmap** commands directly on the results of naabu without making use of config file.
```sh
echo hackerone.com | naabu -nmap-cli 'nmap -sV -oX naabu-output'
__
___ ___ ___ _/ / __ __
/ _ \/ _ \/ _ \/ _ \/ // /
/_//_/\_,_/\_,_/_.__/\_,_/ v2.0.0
projectdiscovery.io
[WRN] Use with caution. You are responsible for your actions
[WRN] Developers assume no liability and are not responsible for any misuse or damage.
[INF] Running TCP/ICMP/SYN scan with root privileges
[INF] Found 4 ports on host hackerone.com (104.16.99.52)
hackerone.com:443
hackerone.com:80
hackerone.com:8443
hackerone.com:8080
[INF] Running nmap command: nmap -sV -p 80,8443,8080,443 104.16.99.52
Starting Nmap 7.01 ( https://nmap.org ) at 2020-09-23 05:02 UTC
Nmap scan report for 104.16.99.52
Host is up (0.0021s latency).
PORT STATE SERVICE VERSION
80/tcp open http cloudflare
443/tcp open ssl/https cloudflare
8080/tcp open http-proxy cloudflare
8443/tcp open ssl/https-alt cloudflare
```
# CDN Exclusion
Naabu also supports excluding CDN IPs being port scanned. If used, only `80` and `443` ports get scanned for those IPs. This feature can be enabled by using `exclude-cdn` flag.
Currently `cloudflare`, `akamai`, `incapsula` and `sucuri` IPs are supported for exclusions.
# 📋 Notes
- Naabu is designed to scan ports on multiple hosts / mass port scanning.
- As default naabu is configured with a assumption that you are running it from VPS.
- We suggest to tune the flags / rate if running naabu from local system.
- For best results, run naabu as **root** user.
naabu is made with 🖤 by the [projectdiscovery](https://projectdiscovery.io) team. Community contributions have made the project what it is. See the **[Thanks.md](https://github.com/projectdiscovery/naabu/blob/master/THANKS.md)** file for more details.