prowler

项目说明

Prowler is a Network Scanner implemented on a Raspberry Pi Cluster, first de during Singapore Infosec Community Hackathon - HackSmith v1.0.

![Black Hat Aresenal 2018]() ![License: MIT]()

!dashboard

Capabilities

Scan a network (a particular subnet or a list of IP addresses) for all IP addresses associated with acti devices

Determine the type of devices using fingerprinting

Determine if there are any open ports on the device

Associate the ports with common services

Test devices against a dictionary of factory default and common credentials

Notify users of security through an dashboard. Dashboard tour

Planned Capabilities

Greater of assessment capabilities (webapp etc.)

Select wordlist based on fingerprint

Hardware

Raspberry Pi Cluster HAT (with 4 \* Pi Zero W)

Raspberry Pi 3

Networking device

!cluster

Software Stack

Raspbian Stretch (Controller Pi)

Raspbian Stretch Lite (Worker Pi Zero)

Note: For ease of setup, use the images provided by Cluster Hat! Instructions

Python 3 (not tested on Python 2)

Python packages see requirements.txt

Ansible for managing the cluster as a whole (/playbooks)

Key Python Packages:

dispy (website) is the star of the show. It allows allows us to create a job queue that will be processed by the worker nodes.

python-libnmap is the python wrapper around nmap, an open source network scanner. It allows us to scan for open ports on devices.

paramiko is a python wrapper around SSH. We use it to probe SSH on devices to test for common credentials.

eel is used for the web dashboard (seperate repository, here)

rabbitmq (website) is used to pass the results from the cluster to the eel server that is serving the dashboard page.

Ansible Playbooks

For the playbooks to work, ansible must be installed (sudo pip3 install ansible). Configure the IP addresses of the nodes at /etc/ansible/hosts.
WARNING: Your mileage may vary as these were only tested on my setup

shutdown.yml and reboot.yml self-explanatory

clone_repos.yml clone prowler and dispy repositories (required!) on the worker nodes

setup_node.yml installs all required packages on the worker nodes. Does not clone the repositories!

Deploying Prowler

1. Clone the git repository: git clone
2. Install dependencies by running sudo pip3 install -r requirements.txt on the controller Pi
3. Run ansible-playbook playbooks/setup_node.yml to install the required packages on worker nodes.
4. Clone the prowler and dispy repositories to the worker nodes using ansible-playbook playbooks/clone_repos.yml
5. Run clusterhat on on the controller Pi to ensure that all Pi Zeros are powered up.
6. Run python3 cluster.py on the controller Pi to start Prowler

To edit the range of IP addresses being scanned, edit the following lines in cluster.py:

Old Demos

Cluster Scan Demonstration Jupyter Notebook

Single Scan Demonstration Jupyter Notebook

Try out the web dashboard here

Useful Snippets

To run ssh command on multiple devices, install pssh and pssh -h pssh-hosts -l username -A -i


    "command"

To create the cluster (in compute.py): cluster =


    dispy.JobCluster(compute, nodes='pi0_ip', ip_addr='pi3_ip')

Check connectivity: ansible all -m ping or ping p1.local -c 1 && ping p2.local -c 1 && ping p3.local -c 1 && ping p4.local -c 1

Temperature Check: /opt/vc/bin/ measure_temp && pssh -h workers -l


    pi -A -i "/opt/vc/bin/ measure_temp" | grep temp

rpimonitor (how to install):

!more random graphs

#### Contributors:

Faith See

Wong Chi Seng

Timothy Liu

ABSOLUTELY NO WARRANTY WHATSOEVER! Feel free to submit issues though.

项目信息

开发语言：Python

Star 数：124

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Distributed Network Vulnerability Scanner展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。

登录后才能参与讨论

下载链接

会员才能下载

登录后开通会员

同分类推荐

暂无同类资源

资源标题	prowler - Distributed Network Vulnerability Scanner
所属分类	安全软件
发布作者	admin
发布时间	2026-10-05 22:42:00
下载权限	免费下载
附件数量	2 个下载链接
浏览次数	332
讨论数量	0
主题状态	正常讨论中

prowler - Distributed Network Vulnerability Scanner