Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eviltik/evilscan
NodeJS Simple Network Scanner
https://github.com/eviltik/evilscan
port-scanner scanner security-scanner security-tools
Last synced: 5 days ago
JSON representation
NodeJS Simple Network Scanner
- Host: GitHub
- URL: https://github.com/eviltik/evilscan
- Owner: eviltik
- License: mit
- Created: 2013-05-21T16:19:37.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2022-10-05T23:25:16.000Z (about 2 years ago)
- Last Synced: 2024-10-23T09:05:50.824Z (21 days ago)
- Topics: port-scanner, scanner, security-scanner, security-tools
- Language: JavaScript
- Homepage: https://github.com/eviltik/evilscan
- Size: 12.7 MB
- Stars: 546
- Watchers: 20
- Forks: 64
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
evilscan
===============
[](https://badge.fury.io/js/evilscan)
[](https://opensource.org/licenses/mit-license.php)
[](https://depfu.com/github/eviltik/evilscan?project_id=22885)
Nodejs Simple Network Scanner
Features
--------
* individual IP or IP range scan
* individual port, ports list, or ports range
* banner grabbing (not fully implemented, works with native verbose ports only)
* IAC negotiation for telnet
* reverse dns
* geolocation information
* stdout or json output
* optional progress details (event based)
Install
-------
>```
>npm install -g evilscan
>```
Usage: in your code, using events only
-------------------
```
const Evilscan = require('evilscan');
const options = {
target:'127.0.0.1',
port:'21-23',
status:'TROU', // Timeout, Refused, Open, Unreachable
banner:true
};
const evilscan = new Evilscan(options);
evilscan.on('result',data => {
// fired when item is matching options
console.log(data);
});
evilscan.on('error', err => {
throw new Error(data.toString());
});
evilscan.on('done', () => {
// finished !
});
evilscan.run();
```
Usage: in your code, using callback and events
-------------------
```
const Evilscan = require('evilscan');
const options = {
target:'127.0.0.1',
port:'21-23',
status:'TROU', // Timeout, Refused, Open, Unreachable
banner:true
};
new Evilscan(options, (err, scan) => {
if (err) {
console.log(err);
return;
}
scan.on('result', data => {
// fired when item is matching options
console.log(data);
});
scan.on('error', err => {
throw new Error(data.toString());
});
scan.on('done', () => {
// finished !
});
scan.run();
});
```
Usage: command line
-------------------
Usage: evilscan [options]
Example:
```
evilscan 192.168.0.0/24 --port=21-23,80
```
Options
-------
```
--port port(s) you want to scan, examples:
--port=80
--port=21,22
--port=21,22,23,5900-5902
--reverse display DNS reverse lookup
--reversevalid only display results having a valid reverse dns, except if
ports specified
--geo display geoip (free maxmind)
--banner display banner
--bannerlen set banner length grabing
default 512
--bannerraw display raw banner (as a JSON Buffer)
--progress display progress indicator each seconds
--status ports status wanted in results (example --status=OT)
T(timeout)
R(refused)
O(open, default)
U(unreachable)
--scan scan method
tcpconnect (full connect, default)
tcpsyn (half opened, not yet implemented)
udp (not yet implemented)
--concurrency max number of simultaneous socket opened
default 500
--timeout maximum number of milliseconds before closing the connection
default 2000
--display display result format (json,xml,console)
default console
--infile fetch fqdn/ipv4/ipv6 target from a file
--outfile dump result in a file
--json shortcut for --display=json
--xml shortcut for --display=xml
--console shortcut for --display=console
--help display help
--about display about
--version display version number
```
Samples output
----------------
* Every ports on localhost, grab banner, display only opened ports
```
eviltik@debian:~# evilscan 127.0.0.1 --port=0-65535 --banner
127.0.0.1|111||open
127.0.0.1|53||open
127.0.0.1|23|Debian GNU/Linux jessie/sid\r\ndebian login:|open
127.0.0.1|5432||open
127.0.0.1|27017||open
127.0.0.1|28017||open
127.0.0.1|35223||open
127.0.0.1|35491||open
127.0.0.1|39619||open
done, 9 result(s)
```
* Every ports on localhost, grab banner, display only opened ports, json output, progress status each seconds
```
eviltik@debian:~# evilscan 127.0.0.1 --port=0-65535 --banner --isopen --istimeout --progress --json
{"_timeStart":"N/A","_timeElapsed":"N/A","_jobsTotal":65535,"_jobsRunning":0,"_jobsDone":0,"_progress":0,"_concurrency":500,"_status":"Starting","_message":"Starting"}
{"_timeStart":1371245901876,"_timeElapsed":1031,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":7638,"_progress":11,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:8138"}
{"_timeStart":1371245901876,"_timeElapsed":2085,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":16137,"_progress":24,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:16637"}
{"ip":"127.0.0.1","port":111,"status":"open"}
{"ip":"127.0.0.1","port":53,"status":"open"}
{"ip":"127.0.0.1","port":23,"banner":"Debian GNU/Linux jessie/sid\\r\\ndebian login:","status":"open"}
{"ip":"127.0.0.1","port":5432,"status":"open"}
{"_timeStart":1371245901876,"_timeElapsed":3107,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":24656,"_progress":37,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:25156"}
{"_timeStart":1371245901876,"_timeElapsed":4166,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":33166,"_progress":50,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:33666"}
{"_timeStart":1371245901876,"_timeElapsed":5215,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":41664,"_progress":63,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:42164"}
{"ip":"127.0.0.1","port":27017,"status":"open"}
{"ip":"127.0.0.1","port":28017,"status":"open"}
{"_timeStart":1371245901876,"_timeElapsed":6217,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":49682,"_progress":75,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:50182"}
{"ip":"127.0.0.1","port":35491,"status":"open"}
{"ip":"127.0.0.1","port":35223,"status":"open"}
{"ip":"127.0.0.1","port":39619,"status":"open"}
{"_timeStart":1371245901876,"_timeElapsed":7234,"_jobsTotal":65535,"_jobsRunning":500,"_jobsDone":57732,"_progress":88,"_concurrency":500,"_status":"Running","_message":"Scanning 127.0.0.1:58232"}
{"_timeStart":1371245901876,"_timeElapsed":8182,"_jobsTotal":65535,"_jobsRunning":0,"_jobsDone":65535,"_progress":100,"_concurrency":500,"_status":"Finished","_message":"Scanning 127.0.0.1:65535"}
```
Tips :
--------
**Concurrency and fast scan**
By default, concurrency is 100. Which is slow when you are scanning large ip range or large port range. You can pass a bigger value using --concurrency option. 1000 is fast by example.
On some linux, only 1024 opened sockets are allowed in the same time. To break this limit, you have to update ulimit parameter of your linux first :
```
ulimit -u unlimited
```
In all cases, due to #25, you will not be able to scan more than 16580355 ipv4 addresses at the moment.
**Pause/unpause**
You can pause/unpause a running scan by sending SIGUSR2 signal. First time it will pause the process, second time it will unpause it.
```
kill -SIGUSR2 19859 # where 19859 is the pid of nodejs process running evilscan
```