Skip to content

Latest commit

 

History

History
48 lines (27 loc) · 1.2 KB

README.md

File metadata and controls

48 lines (27 loc) · 1.2 KB
Raw

gerberos

gerberos scans sources for lines matching regular expressions and containing IPv4 or IPv6 addresses and performs actions on those addresses. Possible sources are (not necessarily existant) non-directory files, systemd journals, kernel messages, and standard outputs of arbitrary processes. Addresses can be logged or added to ipsets or nft rulesets that gerberos will manage autonomously.

Minimal additional logic is applied. This is to adhere to the Unix philosophy, but impacts gerberos' out-of-the-box usefulness for specific use cases when compared to tools like fail2ban.

Requirements

ipset backend

  • ipset 6.34
  • iptables 1.6.1

nft backend

  • nftables v0.9.3 (tested on Ubuntu 20.04)

Development only

  • Go 1.18
  • GNU Make 4.3 (optional)
  • pgrep (system tests only, optional)

Build

make build

Test

Unit tests only

make test

Unit and system tests

Requires ipset, iptables, and nftables to be installed.

make test_system

Example configuration file (TOML)

See gerberos.toml.

Example systemd service file

See gerberos.service.