mirror of
https://github.com/SubleXBle/Fail2Ban-Report.git
synced 2026-02-08 17:58:32 -06:00
93 lines
2.2 KiB
Markdown
93 lines
2.2 KiB
Markdown
# Manual Client Installation – Fail2Ban-Report v0.5.0
|
||
|
||
> Username of the Client and Displayed Servername in Web-UI are the same.
|
||
|
||
> Wanna know more about  or  ?
|
||
|
||
# On the new Sync-Client
|
||
## Preparation
|
||
|
||
- Check Fail2Ban → must be running
|
||
- Check UFW → must be running
|
||
|
||
## Install required packages
|
||
|
||
```
|
||
apt update -qq && apt install jq gawk curl -y -qq
|
||
```
|
||
|
||
```
|
||
/opt/Fail2Ban-Report/
|
||
Backend/
|
||
Helper-Scripts/
|
||
archive/
|
||
fail2ban/
|
||
blocklists/
|
||
```
|
||
|
||
## Backend scripts
|
||
|
||
> Note: Credentials:
|
||
> Username and Servername are basically the same thing.
|
||
> The Client will show up on the Server by it's Username
|
||
> So if you have your testserver (testing.yourodmain.tld) as Client and you are using the "UserName" "TestServer" it will show up in the UI as TestServer (Case-Sensitive)
|
||
|
||
In /opt/Fail2Ban-Report/Backend/ create the following scripts:
|
||
|
||
- fail2ban_log2json.sh ← insert client login credentials
|
||
- download-checker.sh ← insert client login credentials
|
||
- firewall-update.sh ← insert client login credentials
|
||
- syncback.sh ← insert client login credentials
|
||
|
||
Make all .sh files executable:
|
||
|
||
```
|
||
chmod +x /opt/Fail2Ban-Report/Backend/*.sh
|
||
```
|
||
|
||
## Helper scripts
|
||
|
||
in `/opt/Fail2Ban-Report/Helper-Scripts/` create:
|
||
|
||
- `create-client-uuid.sh`
|
||
|
||
Make it executable:
|
||
```
|
||
chmod +x /opt/Fail2Ban-Report/Helper-Scripts/create-client-uuid.sh
|
||
```
|
||
|
||
Run it once to generate client-uuid.json inside
|
||
/opt/Fail2Ban-Report/Settings/
|
||
```
|
||
./create-client-uuid.sh
|
||
```
|
||
The client UUID will be displayed – copy it.
|
||
|
||
|
||
## Cron jobs
|
||
```muss ich noch ändern
|
||
/path/to/fail2ban_log2json.sh
|
||
/path/to/download-checker.sh && /path/to/firewall-update.sh && /path/to/syncback.sh
|
||
```
|
||
---
|
||
|
||
# On the UI-Server
|
||
|
||
## Go to Helper-Scripts:
|
||
|
||
```cd /opt/Fail2Ban-Report/Helper-Scripts/```
|
||
```./manage-clients.sh```
|
||
|
||
Enter data for the new client.
|
||
|
||
## WebUI configuration
|
||
|
||
Adjust `.htaccess` in `/var/www/html/Fail2Ban-Report/` (or where your Installation exists) and `/endpoint/` to let the new IPs access it
|
||
|
||
Add your IP (use Require Any)
|
||
|
||
## After first sync of Fail2Ban events from the new Client
|
||
|
||
```cd /opt/Fail2Ban-Report/Helper-Scripts/```
|
||
```./folder-watchdog.sh```
|