mirror of
https://github.com/jokob-sk/NetAlertX.git
synced 2025-12-07 09:36:05 -08:00
update Readme
This commit is contained in:
23
README.md
23
README.md
@@ -10,19 +10,20 @@ unknown devices. It also warns the disconnection of "always connected" devices.
|
|||||||
*(Apologies for my English and my limited knowledge of Python, php and
|
*(Apologies for my English and my limited knowledge of Python, php and
|
||||||
JavaScript)*
|
JavaScript)*
|
||||||
|
|
||||||
# Docker image :whale:
|
# Docker image 🐳
|
||||||
[](https://github.com/jokob-sk/Pi.Alert/actions/workflows/docker.yml)
|
[](https://github.com/jokob-sk/Pi.Alert/actions/workflows/docker.yml)
|
||||||
[](https://hub.docker.com/r/jokobsk/pi.alert)
|
[](https://hub.docker.com/r/jokobsk/pi.alert)
|
||||||
<a href="https://hub.docker.com/r/jokobsk/pi.alert">
|
<a href="https://hub.docker.com/r/jokobsk/pi.alert">
|
||||||
<img src="https://img.shields.io/docker/pulls/jokobsk/pi.alert?logo=docker&color=0aa8d2&logoColor=fff" alt="Docker Pulls">
|
<img src="https://img.shields.io/docker/pulls/jokobsk/pi.alert?logo=docker&color=0aa8d2&logoColor=fff" alt="Docker Pulls">
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
All credit for Pi.Alert goes to: [pucherot/Pi.Alert](https://github.com/pucherot/Pi.Alert).
|
🥇 Pi.Alert credit goes to [pucherot/Pi.Alert](https://github.com/pucherot/Pi.Alert). <br/>
|
||||||
A pre-built image is available on :whale: Docker Hub: [jokobsk/Pi.Alert](https://registry.hub.docker.com/r/jokobsk/pi.alert).
|
🐳 Docker Image: [jokobsk/Pi.Alert](https://registry.hub.docker.com/r/jokobsk/pi.alert). <br/>
|
||||||
The source :page_facing_up: Dockerfile is available [here](https://github.com/jokob-sk/Pi.Alert/blob/main/Dockerfile) with a detailed :books: [readme](https://github.com/jokob-sk/Pi.Alert/blob/main//dockerfiles/README.md) included.
|
📄 [Dockerfile](https://github.com/jokob-sk/Pi.Alert/blob/main/Dockerfile) <br/>
|
||||||
|
📚 [Dockerfile instructions](https://github.com/jokob-sk/Pi.Alert/blob/main//dockerfiles/README.md).
|
||||||
|
|
||||||
![Main screen dark][main_dark]
|
![Main screen dark][main_dark]
|
||||||
Optional Darkmode (and 12H activity chart) within this fork courtesy of [leiweibau](https://github.com/leiweibau/Pi.Alert)
|
Dark mode (and Activity over the last x scans) within this fork courtesy of [leiweibau](https://github.com/leiweibau/Pi.Alert)
|
||||||
|
|
||||||
## How it works
|
## How it works
|
||||||
The system continuously scans the network for:
|
The system continuously scans the network for:
|
||||||
@@ -61,7 +62,7 @@ In charge of:
|
|||||||
| -------------------- | -------------------- |
|
| -------------------- | -------------------- |
|
||||||
|
|
||||||
### Front
|
### Front
|
||||||
A web frontal that allows:
|
A web front that allows:
|
||||||
- Manage the devices inventory and the characteristics
|
- Manage the devices inventory and the characteristics
|
||||||
- Display in a visual way all the information collected by the back
|
- Display in a visual way all the information collected by the back
|
||||||
- Sessions
|
- Sessions
|
||||||
@@ -72,7 +73,7 @@ A web frontal that allows:
|
|||||||
- Concurrent devices
|
- Concurrent devices
|
||||||
- Down alerts
|
- Down alerts
|
||||||
- IP's
|
- IP's
|
||||||
- manuel nmap scans
|
- Manual Nmap scans
|
||||||
- Optional speedtest for Device "Internet"
|
- Optional speedtest for Device "Internet"
|
||||||
- ...
|
- ...
|
||||||
|
|
||||||
@@ -159,6 +160,14 @@ Linux distributions.
|
|||||||
|
|
||||||
***Suggestions and comments are welcome***
|
***Suggestions and comments are welcome***
|
||||||
|
|
||||||
|
### Special thanks 🥇
|
||||||
|
|
||||||
|
This code is a collaborative body of work, with special thanks to:
|
||||||
|
|
||||||
|
- [leiweibau](https://github.com/leiweibau/Pi.Alert): Dark mode (and Last X scans activity chart)
|
||||||
|
- [Macleykun](https://github.com/Macleykun): Help with Dockerfile clean-up
|
||||||
|
- [Final-Hawk](https://github.com/Final-Hawk): Help with NTFY, styling and other fixes
|
||||||
|
- Please see the [Git commit history](https://github.com/jokob-sk/Pi.Alert/commits/main) for a full list of people and their contributions to the project
|
||||||
|
|
||||||
<!--- --------------------------------------------------------------------- --->
|
<!--- --------------------------------------------------------------------- --->
|
||||||
[main]: ./docs/img/1_devices.jpg "Main screen"
|
[main]: ./docs/img/1_devices.jpg "Main screen"
|
||||||
|
|||||||
@@ -4,11 +4,12 @@
|
|||||||
<img src="https://img.shields.io/docker/pulls/jokobsk/pi.alert?logo=docker&color=0aa8d2&logoColor=fff" alt="Docker Pulls">
|
<img src="https://img.shields.io/docker/pulls/jokobsk/pi.alert?logo=docker&color=0aa8d2&logoColor=fff" alt="Docker Pulls">
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
# :whale: A docker image for Pi.Alert
|
# 🐳 A docker image for Pi.Alert
|
||||||
|
|
||||||
All credit for Pi.Alert goes to: [pucherot/Pi.Alert](https://github.com/pucherot/Pi.Alert).
|
🥇 Pi.Alert credit goes to [pucherot/Pi.Alert](https://github.com/pucherot/Pi.Alert). <br/>
|
||||||
A pre-built image is available on :whale: Docker Hub: [jokobsk/Pi.Alert](https://registry.hub.docker.com/r/jokobsk/pi.alert).
|
🐳 Docker Image: [jokobsk/Pi.Alert](https://registry.hub.docker.com/r/jokobsk/pi.alert). <br/>
|
||||||
The source :page_facing_up: Dockerfile is available [here](https://github.com/jokob-sk/Pi.Alert/blob/main/Dockerfile) with a detailed :books: [readme](https://github.com/jokob-sk/Pi.Alert/blob/main//dockerfiles/README.md) included.
|
📄 [Dockerfile](https://github.com/jokob-sk/Pi.Alert/blob/main/Dockerfile) <br/>
|
||||||
|
📚 [Dockerfile instructions](https://github.com/jokob-sk/Pi.Alert/blob/main//dockerfiles/README.md).
|
||||||
|
|
||||||
Big thanks to <a href="https://github.com/Macleykun">@Macleykun</a> for help and tips&tricks for Dockerfile(s):
|
Big thanks to <a href="https://github.com/Macleykun">@Macleykun</a> for help and tips&tricks for Dockerfile(s):
|
||||||
|
|
||||||
@@ -16,7 +17,7 @@ Big thanks to <a href="https://github.com/Macleykun">@Macleykun</a> for help and
|
|||||||
<img src="https://avatars.githubusercontent.com/u/26381427?size=50">
|
<img src="https://avatars.githubusercontent.com/u/26381427?size=50">
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
## :information_source: Usage
|
## ℹ Usage
|
||||||
|
|
||||||
Network
|
Network
|
||||||
- You will have to probably run the container on the host network, e.g: `sudo docker run --rm --net=host jokobsk/pi.alert`
|
- You will have to probably run the container on the host network, e.g: `sudo docker run --rm --net=host jokobsk/pi.alert`
|
||||||
@@ -26,10 +27,10 @@ Default Port
|
|||||||
|
|
||||||
> Please note - the cronjob is executed every 1, 5 and 15 minutes so wait that long for all of the scans to run.
|
> Please note - the cronjob is executed every 1, 5 and 15 minutes so wait that long for all of the scans to run.
|
||||||
|
|
||||||
## :floppy_disk: Setup and Backups
|
## 💾 Setup and Backups
|
||||||
|
|
||||||
1. (**required**) Download `pialert.conf` and `version.conf` from [here](https://github.com/jokob-sk/Pi.Alert/tree/main/config).
|
1. (**required**) Download `pialert.conf` and `version.conf` from [here](https://github.com/jokob-sk/Pi.Alert/tree/main/config).
|
||||||
2. (**required**) In `pialert.config` specify your network adapter (will probably be `eth0` or `eth1`) and the network filter (which **significantly** speeds up the scan process), e.g. if your DHCP server assigns IPs in the 192.168.1.0 to 192.168.1.255 range specify it the following way:
|
2. (**required**) In `pialert.conf` specify your network adapter (will probably be `eth0` or `eth1`) and the network filter (which **significantly** speeds up the scan process), e.g. if your DHCP server assigns IPs in the 192.168.1.0 to 192.168.1.255 range specify it the following way:
|
||||||
* `SCAN_SUBNETS = '192.168.1.0/24 --interface=eth0'`
|
* `SCAN_SUBNETS = '192.168.1.0/24 --interface=eth0'`
|
||||||
3. (**required**) Use your configuration by:
|
3. (**required**) Use your configuration by:
|
||||||
* Mapping the container folder `/home/pi/pialert/config` to a persistent folder containing `pialert.conf` and `version.conf`,
|
* Mapping the container folder `/home/pi/pialert/config` to a persistent folder containing `pialert.conf` and `version.conf`,
|
||||||
@@ -44,7 +45,7 @@ Default Port
|
|||||||
|
|
||||||
Config examples can be found below.
|
Config examples can be found below.
|
||||||
|
|
||||||
## :page_facing_up: Examples
|
## 📄 Examples
|
||||||
|
|
||||||
### Example 1
|
### Example 1
|
||||||
|
|
||||||
@@ -102,7 +103,7 @@ Courtesy of [pbek](https://github.com/pbek). The volume `pialert_db` is used by
|
|||||||
- ./pialert/version.conf:/home/pi/pialert/config/version.conf
|
- ./pialert/version.conf:/home/pi/pialert/config/version.conf
|
||||||
```
|
```
|
||||||
|
|
||||||
## :coffee: Support
|
## ☕ Support
|
||||||
|
|
||||||
> Disclaimer: This is my second container and I might have used unconventional hacks so if anyone is more experienced, feel free to fork/create pull requests. Also, please only donate if you don't have any debt yourself. Support yourself first, then others.
|
> Disclaimer: This is my second container and I might have used unconventional hacks so if anyone is more experienced, feel free to fork/create pull requests. Also, please only donate if you don't have any debt yourself. Support yourself first, then others.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user