Skip to content

A FAST network scanner that identifies security vulnerabilities in your network and alerts you to new ones as they arise.

License

Notifications You must be signed in to change notification settings

royrusso/probus

Repository files navigation

Probus - Network Scanner

codecov Tests License

This project is in early development!

A network scanner with an attractive UI, that identifies security vulnerabilities in your network and alerts you to new ones as they arise. Scans are performed on a schedule or on-demand.

Introduction * Key Features * Quickstart * Development * Contributing * Contact

🎯 Key Features:

  • Network Scanner: Asynchronously scans your network for hosts and open ports.
  • Scheduled Scans: Scans your network on a schedule.
  • Vulnerability Scanner: Identifies security vulnerabilities in your network on a per-device basis.
  • Scan and Vulnerability History: Keeps a history of scans and vulnerabilities identified.
  • Alerting: Alerts you to new vulnerabilities as they arise, new devices added to your network, given a network range.
  • Platform agnostic: Avilable as a docker container.

⚡ Quickstart

In order to run the commands described below, you need:

Running

  1. Linux Installs: Run docker compose up to start the application.
  2. Mac and Windows Installs: Run NETWORK_MODE=bridge docker compose up to start the application.

UI: http://localhost:8080

API: http://localhost:8000/docs

Note: The NETWORK_MODE=bridge environment variable is required for Mac and Windows. This is because the default network mode for Docker Compose is host, which is not supported on Mac and Windows and Probus requires access to the host network to scan the network.

Alternatively, you can create a .env file in the root of the project with the following content:

NETWORK_MODE=bridge

💫 Development

Please read the DEVELOPMENT.md file for more information on how to run this project locally and contribute.

👍 Contributing

Please read the CONTRIBUTING.md file for more information on how to contribute to this project.

📨 Contact

  • Use GitHub Issues for code-related issues.

🗄️ License

Probus is licensed under the Apache License 2.0.

About

A FAST network scanner that identifies security vulnerabilities in your network and alerts you to new ones as they arise.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published