From 5ddb842269474f93c53547c2e66059f33dc0e1b6 Mon Sep 17 00:00:00 2001 From: bauthard <8293321+bauthard@users.noreply.github.com> Date: Sat, 4 Apr 2020 22:16:21 +0530 Subject: [PATCH] Update README.md --- README.md | 139 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 138 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b5740d09..3835b2bb 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,140 @@ + +

+ nuclei +
+

+ +[![License](https://img.shields.io/badge/license-MIT-_red.svg)](https://opensource.org/licenses/MIT) +[![Go Report Card](https://goreportcard.com/badge/github.com/projectdiscovery/nuclei)](https://goreportcard.com/report/github.com/projectdiscovery/nuclei) +[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/projectdiscovery/nuclei/issues) + # nuclei -Nuclei is a fast tool to scan for things using configurable templates +Nuceli is a fast tool to scan for things using configurable templates + +# Resources +- [Resources](#resources) +- [Features](#features) +- [Usage](#usage) +- [Installation Instructions](#installation-instructions) + - [Prerequisite](#prerequisite) + - [Direct Installation](#direct-installation) + - [From Binary](#from-binary) + - [From Source](#from-source) +- [Running nuclei](#running-nuclei) + - [1. Running nuclei with single template](#running-nuclei-with-a-single-template) + - [2. Running nuclei with multiple template](#running-nuclei-with-a-multiple-template) + + + + - [A note on nuclei](#a-note-on-nuclei) +- [License](#license) + + # Features + +

+ nuclei +
+

+ + - Simple and modular code base making it easy to contribute. + - Fast And Simple active subdomain scanning. + - Handles wildcard subdomains in a smart manner. + - Optimized for **ease of use** + - **Stdin** and **stdout** support for integrating in workflows + +# Usage + +```bash +nuclei -h +``` + +This will display help for the tool. Here are all the switches it supports. + +| Flag | Description | Example | +|----------------|---------------------------------------------------------|--------------------------------------| +| -c | Number of concurrent requests (default 10) | nuclei -c 100 | +| -l | List of urls to run templates | nuclei -l urls.txt | +| -t | Templates input file/files to check across hosts | nuclei -t git-core.yaml | +| -t | Templates input file/files to check across hosts | nuclei -t templates/*.yaml | +| -nC | Don't Use colors in output | nuclei -nC | +| -o | File to save output result (optional) | nuclei -o output.txt | +| -silent | Show only found results in output | nuclei -silent | +| -retries | Number of times to retry a failed request (default 1) | nuclei -retries 1 | +| -t | Seconds to wait before timeout (default 5) | nuclei -t 5 | +| -v | Show Verbose output | nuclei -v | +| -version | Show version of nuclei | nuclei -version | + + +# Installation Instructions + + +## Direct Installation + +### From Binary + +The installation is easy. You can download the pre-built binaries for your platform from the [Releases](https://github.com/projectdiscovery/nuclei/releases/) page. Extract them using tar, move it to your $PATH and you're ready to go. + +```bash +> tar -xzvf nuclei-linux-amd64.tar +> mv nuclei-linux-amd64 /usr/bin/nuclei +> nuclei -h +``` + +### From Source + +nuclei requires go1.13+ to install successfully. Run the following command to get the repo - + +```bash +> GO111MODULE=on go get -u -v github.com/projectdiscovery/nuclei/cmd/nuclei +``` + +In order to update the tool, you can use -u flag with `go get` command. + +# Running nuclei + +nuclei supports two types of input. + +### 1. Running nuclei with a single template. + +This will run the tool against all the hosts in `urls.txt` and returns the matched results. + +```bash +> nuclei -l urls.txt -t git-core.yaml +``` + + +You can also pass the list of hosts at standard input (STDIN). This allows for easy integration in automation pipelines. + +This will run the tool against all the hosts in `urls.txt` and returns the matched results. + + +```bash +> cat urls.txt | nuclei -t git-core.yaml +``` + +### 2. Running nuclei with a multiple template. + +This will run the tool against all the hosts in `urls.txt` and returns the matched results. + +```bash +> nuclei -l urls.txt -t "path-to-templates/*.yaml" -o results.txt +``` + + +You can also pass the list of hosts at standard input (STDIN). This allows for easy integration in automation pipelines. + +This will run the tool against all the hosts in `urls.txt` and returns the matched results. + + +```bash +> cat urls.txt | nuclei -t "path-to-templates/*.yaml" -o results.txt +``` + + +### A note on nuclei + + +# License + +nuclei 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/nuclei/blob/master/THANKS.md)** file for more details.