50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# BanForge
|
|
|
|
Log-based IPS system written in Go for Linux-based system.
|
|
|
|
# Table of contents
|
|
1. [Overview](#overview)
|
|
2. [Requirements](#requirements)
|
|
3. [Installation](#installation)
|
|
4. [Usage](#usage)
|
|
5. [License](#license)
|
|
|
|
# Overview
|
|
BanForge is a simple IPS for replacement fail2ban in Linux system.
|
|
The project is currently in its early stages of development.
|
|
All release are available on my self-hosted [Gitea](https://gitea.d3m0k1d.ru/d3m0k1d/BanForge) because Github has limits for Actions.
|
|
If you have any questions or suggestions, create issue on [Github](https://github.com/d3m0k1d/BanForge/issues).
|
|
|
|
## Roadmap
|
|
- [x] Real-time Nginx log monitoring
|
|
- [ ] Add support for other service
|
|
- [ ] Add support for user service with regular expressions
|
|
- [ ] TUI interface
|
|
|
|
# Requirements
|
|
|
|
- Go 1.25+
|
|
- ufw/iptables/nftables/firewalld
|
|
|
|
# Installation
|
|
Search for a release on the [Gitea](https://gitea.d3m0k1d.ru/d3m0k1d/BanForge/releases) releases page and download it. Then create or copy a systemd unit file.
|
|
Or clone the repo and use the Makefile.
|
|
```
|
|
git clone https://gitea.d3m0k1d.ru/d3m0k1d/BanForge.git
|
|
cd BanForge
|
|
sudo make build-daemon
|
|
cd bin
|
|
```
|
|
|
|
# Usage
|
|
```bash
|
|
banforge init # Create config files and database
|
|
banforge daemon # Start BanForge daemon (use systemd or another init system to create a service)
|
|
```
|
|
You can edit the config file with examples in
|
|
- `/etc/banforge/config.toml` main config file
|
|
- `/etc/banforge/rules.toml` ban rules
|
|
|
|
# License
|
|
The project is licensed under the [GPL-3.0](https://github.com/d3m0k1d/BanForge/blob/master/LICENSE)
|