18 releases (11 breaking)
new 0.20.0 | May 9, 2024 |
---|---|
0.18.0 | Dec 24, 2023 |
0.16.0 | Oct 24, 2023 |
0.10.3 | Jul 16, 2023 |
0.6.0 |
|
#283 in Network programming
206 downloads per month
755KB
17K
SLoC
nscan
Cross-platform network scan tool for host and service discovery.
Aims to be simple, fast, and efficient in performance.
Features
- Port scan
- Host scan
- Service detection
- OS family detection
Installation
From Releases
You can download archives of precompiled binaries from the releases .
Using Cargo
cargo install nscan
Or you can use binstall for install nscan from github release.
cargo binstall nscan
Basic Usage
Default Port Scan
To scan the default ports on a target, simply specify the target:
nscan --target scanme.nmap.org
Sub-commands and Options
Usage: nscan.exe [OPTIONS] [COMMAND]
Commands:
port Scan port. nscan port --help for more information
host Scan host in specified network or host-list. nscan host --help for more information
subdomain Find subdomains. nscan subdomain --help for more information
interfaces Show network interfaces
interface Show default network interface
check Check dependencies (Windows only)
help Print this message or the help of the given subcommand(s)
Options:
-t, --target <target> Specify the target host. IP address or Hostname
-i, --interface <interface_name> Specify the network interface
--noping Disable initial ping
-F, --full Scan all ports (1-65535)
-j, --json Displays results in JSON format.
-o, --save <file_path> Save scan result in JSON format - Example: -o result.json
-h, --help Print help
-V, --version Print version
Supported platforms
- Linux
- macOS
- Windows
Privileges
nscan
uses raw sockets, which require elevated privileges. Execute with administrator rights.
Notes for Windows Users
When using nscan on Windows, please consider the following:
- Npcap/WinPcap Installation:
- Ensure that Npcap or WinPcap is installed on your system.
- If using Npcap, install it with the "Install Npcap in WinPcap API-compatible Mode" option.
- Build Dependencies:
- Place the Packet.lib file from the Npcap SDK or WinPcap Developers pack in a directory named lib at the root of this repository.
- The file can be found in the %LIB% or $Env:LIB environment variables.
- Locate Packet.lib in /Lib/x64/Packet.lib for the 64-bit toolchain or /Lib/Packet.lib for the 32-bit toolchain.
My related projects
This tool also serves as a test for my following projects.
Dependencies
~26–63MB
~1M SLoC