nessus-cli 0.1.1

CLI for launching Nessus scans using the nessus-launcher library.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

# nessus-cli

[![Crates.io](https://img.shields.io/crates/v/nessus-cli.svg)](https://crates.io/crates/nessus-cli)
[![Docs.rs](https://docs.rs/nessus-cli/badge.svg)](https://docs.rs/nessus-cli)
![License](https://img.shields.io/badge/license-MIT-blue.svg)

A fast, reliable command‑line interface for launching Nessus scans using the
[`nessus-launcher`](https://crates.io/crates/nessus-launcher) Rust library.

This CLI is designed for automation, CI pipelines, and operational workflows where
you need a clean, scriptable interface to Nessus.

---

## ✨ Features

- 🚀 Launch one or many Nessus scans
- 🔄 Automatic retry with exponential backoff
- ⚡ Parallel execution
- 🧩 `.env` configuration support
- 📊 Structured logging (`tracing`)
- 🛠 Built on the `nessus-launcher` async Rust library
- 🧪 Fully scriptable for CI/CD

---

## 📦 Installation

Install from crates.io:

```bash
cargo install nessus-cli


Verify installation:

nessus-cli --help


🚀 Quick Start
Launch scans directly

nessus-cli --scan 5 --scan 8



Or configure via .env
Create a .env file:
NESSUS_HOST=https://nessus.example.com
NESSUS_USERNAME=admin
NESSUS_PASSWORD=secret
DEFAULT_SCAN_IDS=5,8,11


Then simply run:

nessus-cli


🔧 Command-Line Options

nessus-cli [OPTIONS]



Common flags
Flag	Description
--scan	Launch a specific scan (repeatable)
--parallel	Override parallelism level
--retries	Override retry count
--delay	Override retry backoff delay
-v, --verbose	Increase log verbosity
-h, --help	Show help message

🧩 Example: Launch Multiple Scans

nessus-cli \
  --scan 12 \
  --scan 15 \
  --scan 22 \
  --parallel 3 \
  --retries 5


🛠 Configuration

The CLI automatically loads environment variables from:

.env file (if present)

system environment variables

Supported variables:

NESSUS_HOST=
NESSUS_USERNAME=
NESSUS_PASSWORD=
DEFAULT_SCAN_IDS=
PARALLELISM=
RETRY_COUNT=
RETRY_DELAY_MS=


🏗 Project Structure

nessus-cli/
├── Cargo.toml
└── src/
    └── main.rs


The CLI is a separate crate built on top of the nessus-launcher library.

📚 Documentation

Full CLI documentation:

https://docs.rs/nessus-cli

Library documentation:

https://docs.rs/nessus-launcher (docs.rs in Bing)


📄 License
This project is licensed under the MIT License.
See LICENSE for details.