mirror of
https://github.com/jokob-sk/NetAlertX.git
synced 2025-12-06 17:15:38 -08:00
721a14e3706a6ab80cea20c38cf836d820637d02
Pi.Alert
WIFI / LAN intruder detector.
Check the devices connected to your WIFI / LAN and alert you the unknown devices. It also warns of the disconnection of "always connected" devices.
(Apologies for my english and my limited knowledge of Python, php and JavaScript)
How it works
Componets
The system consists of two parts:
-
Back: in charge of scanning the network searching connected devices, store the information in the DB, and reporting the changes detected by e-mail.
-
Front: a web frontal that allows to display, in a visual way, all the information collected by the back.
Installation
Initially designed to run on a Raspberry PI, it can run on many other Linux distributions.
Pending explain the installation process
- step 1
- step 2
Dependencies
- Lighttpd (probably works on other webservers / not tested)
- arp-scan (Required for Scan Method 1)
- Pi.hole (optional. Scan Method 2. Check devices doing DNS queries)
- dnsmasq (optional. Scan Method 3. Check devices using DHCP server)
- IEEE HW Vendors Database (Necessary to identified HW vendor)
Powered by:
- Python (Programming language for the Back)
- PHP (Programming language for the Front-end)
- JavaScript (Programming language for the Front-end)
- Bootstrap (Front-end framework)
- Admin.LTE (Bootstrap template)
- FullCalendar (calendar component)
- Sqlite (DB engine)
- Lighttpd (Webserver)
- arp-scan (Scan network using arp commands)
- Pi.hole (DNS Server)
- dnsmasq (DHCP Server)
License
GPL 3.0
Contact
pending...
Description
💻🔍 WIFI / LAN intruder detector. Scans for devices connected to your network and alerts you if new and unknown devices are found.
arp-scandockerintrusion-detectionipamnetwork-analysisnetworkingnetwork-securitypi-holesecurityselfhostedwifi-networkwifi-security
Readme
230 MiB
Languages
JavaScript
39.3%
Python
28.6%
PHP
15.1%
CSS
11.4%
Shell
4.6%
Other
0.9%