󰦝 OMEGA-FIRE

Poste de gestion unifié de la sécurité réseau

Élaboré par kraynux pour Omega-server https://kraynux.snake-mackarel.ts.net

Page officiel : OMEGA-FIRE Apercu : Screenshots

Omega-Fire est une application TUI (Terminal User Interface) Python construite avec Rich. Elle fournit depuis un terminal une interface unique pour administrer les pare-feux Linux, Fail2Ban, les adresses bannies, les règles réseau, les journaux et les statistiques système.

Le projet est conçu selon les principes de la Clean Architecture, avec une séparation claire entre domaine métier, orchestration, infrastructure et interface utilisateur.

Présentation

Omega-Fire agit comme un poste de pilotage local pour la sécurité réseau. Il détecte automatiquement les composants présents sur la machine et adapte les menus aux capacités réellement disponibles.

Objectifs

Réunir nftables, iptables, ip6tables et Fail2Ban dans une interface cohérente.
Faciliter l’observation et l action des connexions, des bannissements et des événements système.
Centraliser les exports, les sauvegardes, les audits et l’historique des opérations.
Conserver une architecture testable et extensible.
Fonctionner en mode dégradé lorsqu’un composant optionnel est absent.

Ce que fait Omega-Fire

Détecte les backends, services, noyau et outils disponibles.
Administre nftables, iptables et ip6tables lorsque ces composants sont présents.
Gère les IP bannies, seules ou par lots, avec import, export, synchronisation et flush.
Crée, liste et supprime des règles avancées.
Applique des politiques prédéfinies avec sauvegarde automatique préalable.
Administre les jails Fail2Ban et leurs bannissements.
Analyse les logs en direct ou sous forme de statistiques.
Propose de la surveillance sous forme de monitoring.
Utilise conntrack pour afficher les connexions actives lorsqu’il est disponible.
Produit des exports JSON, TXT et HTML.
Sauvegarde et restaure l’état complet dans des archives .tar.gz.
Journalise les opérations dans un journal applicatif et un audit JSON structuré.
Surveille les services et applications détectés : systemd, runit, OpenRC, Docker, serveurs, VNC, etc.

Ce que le projet ne fait pas

Il ne remplace pas nftables, iptables ou Fail2Ban.
Il ne constitue pas un pare-feu autonome indépendant du système.
Il ne fournit pas d’authentification multi-utilisateur.
Il n’expose pas d’API réseau en fonctionnement normal.
Il ne s’agit pas d’un dashboard web.
Il ne protège pas directement une machine distante depuis une autre machine.
Il n’installe par défaut aucun fichier en dehors de son propre dossier.
Il ne garantit pas la disponibilité de tous les backends sur toutes les distributions.

Fonctionnalités

1. Capacités et diagnostics

Affichage du registre des capacités détectées.
Consultation détaillée d’une capacité par identifiant.
Re-scan manuel du système après installation d’un composant.
Consultation des diagnostics récents.
Consultation et recherche dans le journal applicatif.
Export de l’état et des diagnostics en JSON, TXT ou HTML.

2. Gestion unifiée des IP

La blacklist unifiée permet de travailler avec nftables et iptables depuis un même écran.

Bannissement d’une IP ou d’une liste d’IPs.
Débannissement individuel ou par lots.
Saisie directe ou import depuis un fichier.
Liste par backend ou vue unifiée.
Synchronisation entre les backends NFTables/IPTables.
Export et réimport des listes.
Nettoyage complet d’un ou plusieurs backends.
Prise en charge IPv4 et IPv6.

3. Gestion des règles et politiques

Assistant pas à pas pour créer une règle avancée.
Liste des règles système et des règles créées par Omega-Fire.
Suppression d’une règle par sélection.
Nettoyage automatique des règles inactives dans la base de référence.
Application de politiques prédéfinies.
Sauvegarde automatique avant application d’une politique.
Personnalisation, sauvegarde et restauration d’une politique.
Identification de la politique active dans le menu de statut et le dashboard.
Signalement des profils modifiés sous la forme Profil + CUSTOM.

4. Gestion Fail2Ban

État détaillé des jails et de leurs paramètres.
Nombre d’IPs bannies et informations de rate-limit.
Recherche d’une IP dans les jails.
Ban et unban individuels ou multiples.
Transfert d’IPs entre jails, backends et fichiers.
Création guidée d’un jail personnalisé.
Modèles de jails prédéfinis.
Suppression d’un jail.
Vidage d’un jail ou purge générale.
Export en JSON, TXT ou HTML.
Vérification et audit de configuration.
Contrôle du service : statut, démarrage, arrêt, redémarrage, activation et désactivation au démarrage.

5. Logs et maintenance

Live Tail avec tableau de bord Omega-Fire.
Affichage multi-fichiers avec bookmarks.
Intégration optionnelle de lnav.
Analyse des IPs les plus fréquentes avec Top N.
Nettoyage ciblé d’une IP dans des fichiers LOG ou TXT.
Rotation et sauvegardes immédiates ou automatisées.
Restauration d’un backup.
Purge selon ancienneté, quota, type ou sélection manuelle.
Nettoyage avancé par dossier ou environnement.
Statistiques sur 24 heures, 7 jours ou 30 jours.
Analyse des événements, mouvements, quotas et IPs présentes dans les jails.

6. Exports et rapports

Formats disponibles :

JSON : données structurées et réutilisables.
TXT : format brut ou adapté à l’injection.
HTML : rapport lisible et visuel.

Rapports disponibles :

Blacklist complète.
Ruleset structuré.
Règles sélectionnées par provenance : système, Omega-Fire ou actives.
Rapport d’audit complet.
Statistiques Fail2Ban.
État et diagnostics système.
Rapports statistiques sur 7 ou 30 jours.

Thèmes HTML :

omega-base — bleu nuit et cyan, thème par défaut.
omega-burn — braise rouge-orangé.
omega-neon — cyberpunk cyan et magenta.
light-basic — clair et sobre.
light-alt — papier crème et vert forêt.

7. Système et persistance

Sauvegarde de l’état complet : règles, bans nftables, bans iptables et Fail2Ban.
Création d’archives .tar.gz horodatées.
Liste et restauration des snapshots.
Historique des actions.
Filtrage et purge de l’historique.
Rechargement de configuration et re-scan sans redémarrage.

8. Monitoring et statistiques

Dashboard temps réel avec rafraîchissement périodique.
Visualisation de la politique active.
Connexions actives via conntrack.
Trafic, événements, statistiques et logs serveur.
Rapports consolidés sur 7 et 30 jours.
Export HTML des snapshots et rapports.

Architecture

src/omega_fire/
├── app/              Bootstrap et conteneur d’injection de dépendances
├── core/             Capacités, énumérations et exceptions
├── domain/           Logique métier pure : règles, IPs, jails, logs
├── application/      Orchestration : commands et queries
├── infrastructure/   Backends, stockage, exports, logs et sondes système
├── ports/            Contrats Protocol/ABC
├── interfaces/       Interface TUI Rich, menus, actions et renderers
├── plugins/          Extensions intégrées : nftables, iptables, Fail2Ban, conntrack
└── shared/           Parsing, réseau, formatage et utilitaires transverses

Principes de conception

domain/ ne contient ni I/O ni dépendance vers l’infrastructure.
application/ orchestre les cas d’usage via le domaine et les ports.
infrastructure/ est la seule couche autorisée à appeler nft, iptables, fail2ban-client et les autres outils externes.
interfaces/ ne doit pas appeler directement subprocess.
ports/ définit les contrats attendus par les adaptateurs.
core/ fournit le registre de capacités utilisé par les différentes couches.
Les plugins permettent d’ajouter ou de faire évoluer les backends sans modifier le domaine métier.

Structure des données

Omega-Fire utilise SQLite via la bibliothèque standard sqlite3, sans ORM externe. Les principaux ensembles de données concernent les bans, règles, événements d’audit et snapshots.

Les migrations sont versionnées et appliquées automatiquement au démarrage.

Prérequis

Système

Linux, en priorité Arch Linux et distributions compatibles.
Python 3.10 ou supérieur.
Privilèges root disponibles via sudo.
Un gestionnaire de services : systemd, runit ou OpenRC.
Au moins un backend firewall : nftables ou iptables.

Dépendances Python

Les dépendances sont définies dans requirements.txt :

rich — TUI, tableaux, couleurs et affichage Live.
jinja2 — génération des exports HTML.
python-dotenv — variables d’environnement.
pytest et pytest-cov — tests et couverture.
black, flake8 et mypy — qualité de code.

Outils optionnels recommandés

L’application fonctionne en mode dégradé si ces outils sont absents :

fail2ban — bannissement automatisé.
conntrack ou conntrack-tools — connexions actives et statistiques réseau.
lnav — analyse avancée et multi-fichiers des logs.
psutil — informations complémentaires sur les composants système.

Sur Arch Linux et dérivés :

sudo pacman -S fail2ban conntrack-tools lnav

Installation

L’archive officielle est fournie au format .tar.gz. Vérifiez son intégrité avant installation :

sha256sum omega-fire.tar.gz

Méthode 1 — script d’installation

[ -d omega-fire ] && echo "ℹ️ Déjà extrait ici, étape ignorée." || tar -xzf omega-fire.tar.gz
[ -d ~/omega-fire ] && echo "ℹ️ ~/omega-fire existe déjà, déplacement ignoré." || mv omega-fire ~/
cd ~/omega-fire/
chmod +x install.sh
./install.sh

Lancement :

./omega-fire.sh

Si l’alias a été installé, ouvrez un nouveau terminal puis utilisez :

fire

Méthode 2 — installation complète résiliente

Cette commande peut être relancée : elle ignore les étapes déjà réalisées.

([ -d ~/omega-fire ] && echo "ℹ️ ~/omega-fire existe déjà, extraction ignorée." || (tar -xzf omega-fire.tar.gz && mv omega-fire ~/)) && cd ~/omega-fire/ && ([ -d .venv ] && echo "ℹ️ .venv existe déjà, étape ignorée." || python3 -m venv .venv) && source .venv/bin/activate && pip install -r requirements.txt && chmod +x omega-fire.sh && mkdir -p var && (getent group omega-fire >/dev/null 2>&1 && echo "ℹ️ Groupe omega-fire déjà présent." || sudo groupadd omega-fire) && (groups "$USER" 2>/dev/null | grep -qw omega-fire && echo "ℹ️ $USER déjà membre du groupe omega-fire." || sudo usermod -aG omega-fire "$USER") && sudo chgrp -R omega-fire var && sudo chmod -R 2775 var && echo "✅ Omega-Fire installé. Lancez ./omega-fire.sh."

Méthode 3 — installation détaillée

# 1. Extraire
[ -d omega-fire ] && echo "ℹ️ Déjà extrait ici, étape ignorée." || tar -xzf omega-fire.tar.gz

# 2. Déplacer dans le home
[ -d ~/omega-fire ] && echo "ℹ️ ~/omega-fire existe déjà, déplacement ignoré." || mv omega-fire ~/

# 3. Entrer dans le projet
cd ~/omega-fire/

# 4. Créer l’environnement virtuel
[ -d .venv ] && echo "ℹ️ .venv existe déjà, création ignorée." || python3 -m venv .venv

# 5. Installer les dépendances
source .venv/bin/activate
pip install -r requirements.txt

# 6. Rendre le lanceur exécutable
chmod +x omega-fire.sh

# 7. Préparer var/ pour root et l’utilisateur courant
mkdir -p var
getent group omega-fire >/dev/null 2>&1 || sudo groupadd omega-fire
groups "$USER" 2>/dev/null | grep -qw omega-fire || sudo usermod -aG omega-fire "$USER"
sudo chgrp -R omega-fire var
sudo chmod -R 2775 var

# 8. Lancer
./omega-fire.sh

Le groupe dédié et le bit setgid permettent à root et à l’utilisateur de partager les fichiers produits dans var/ sans ouvrir les permissions à l’ensemble du système. Une nouvelle connexion ou newgrp omega-fire peut être nécessaire pour bénéficier immédiatement de l’appartenance au groupe.

Alias Bash ou Zsh

grep -qxF 'alias fire="sudo ~/omega-fire/omega-fire.sh"' ~/.bashrc 2>/dev/null || echo 'alias fire="sudo ~/omega-fire/omega-fire.sh"' >> ~/.bashrc
grep -qxF 'alias fire="sudo ~/omega-fire/omega-fire.sh"' ~/.zshrc 2>/dev/null || echo 'alias fire="sudo ~/omega-fire/omega-fire.sh"' >> ~/.zshrc

Rechargez ensuite le shell :

source ~/.bashrc 2>/dev/null || source ~/.zshrc

Icônes et symboles Nerd Fonts

Si les icônes ne sont pas disponibles, installez les symboles Nerd Fonts :

mkdir -p ~/.local/share/fonts
curl -fLo /tmp/NerdFontsSymbolsOnly.zip \
  https://github.com/ryanoasis/nerd-fonts/releases/latest/download/NerdFontsSymbolsOnly.zip
unzip -o /tmp/NerdFontsSymbolsOnly.zip -d ~/.local/share/fonts
fc-cache -fv

Utilisation

Lancement

cd ~/omega-fire
./omega-fire.sh

ou simplement taper  fire    si vous avez créer l'alias

Le lanceur :

Vérifie les privilèges root et utilise sudo si nécessaire.
Détecte .venv, venv ou Python système.
Configure PYTHONPATH vers src/.
Lance python -m omega_fire.

Parcours général

Écran de démarrage.
Détection des capacités système.
Ouverture du menu principal.
Sélection d’une section ou saisie directe d’un identifiant.
Confirmation des opérations sensibles.
Exécution, diagnostic et retour au menu.

Navigation

Flèches haut/bas : déplacer le curseur.
Flèches gauche/droite : déplacer l'ecran pour lire les longues lignes de logs entieres
Entrée : sélectionner ou valider.
Esc : revenir en arrière.
a : afficher l’aide contextuelle.
t : changer de thème.
q : quitter.
r : refresh, rafraichit l'écran, utile apres un redimensionnement de terminal si non refresh.
d : début, lorsque une liste depasse l'ecran et rentre en systeme de pagination. (Flèches gauche/droite compatible)
f : fin, lorsque une liste depasse l'ecran et rentre en systeme de pagination. (Flèches gauche/droite compatible)
Ctrl + q : quitter certaines actions (logs, dashboard,...)
Ctrl + g/G : Début et fin de liste de logs (fusion lnav)
Ctrl + c : Mode interruption de l application direct (sauvegarde + confirmation)
Identifiant de menu, par exemple 2.1 : positionner le curseur, puis appuyer une seconde fois sur Entrée pour valider.
Identifiant de numero de menu et sous menu , par exemple 2.1 et Entrée : allez directement à la section 2.1.

Thèmes et terminaux

Taille : Confort minimal d 'utilisation 164x47 (specifié dans le header).
Themes : Application complete sur profil classic fond noir, police clair.
Si vous avez personnalisés des themes de profils specifique (wallpaper, couleur,...) le theme se met en mode Fusion (application partielle).
Dix thèmes Rich sont disponibles :

omega-base       omega-dark       omega-light
omega-neon       omega-burn       omega-pink
omega-hack       omega-contrast   omega-mono
omega-minimal

Basculez entre les thèmes avec t. Omega-Fire adapte automatiquement les couleurs, emojis, animations Live et palettes selon les capacités du terminal.
Effet du raccourci [t] : Sur certain dashboard le theme change directement (2s), sur d autres un lanceur vous permet de choisir directement à partir du nom du theme.
le changement de theme s'active depuis les menus et dashboard, pas dans les actions.

Terminal	Couleurs	Emojis	Live	Thèmes
Ghostty, Alacritty, WezTerm, Kitty	24-bit	Oui	Oui	Complets
Konsole, GNOME Terminal, Terminator, xfce4-terminal	256	Oui	Oui	Complets
urxvt	256	Non	Oui	Réduits
xterm	16	Non	Oui	Réduits
Linux TTY	16	Non	Non	Mono
SSH moderne	Variable	Partiel	Partiel	Réduits
SSH ancien	Partiel	Non	Non	Mono

Sur un terminal limité, omega-mono ou omega-minimal constitue le meilleur mode de repli. Les options de lancement historiques --no-emoji, --no-color et --plain peuvent être utilisées si elles sont prises en charge par la version installée.

Configuration

La configuration spécifique peut être ajustée dans :

omega-fire/config/omega-fire.conf

Elle peut notamment définir :

chemins des journaux ;
serveurs et sources de monitoring ;
backends disponibles ou chemins personnalisés ;
environnements à analyser ;
paramètres adaptés à une installation particulière.

La configuration est relue au redémarrage ou lors d’un re-scan manuel.

Chemins internes et chemins système

Par défaut, Omega-Fire travaille dans son propre dossier :

var/exports/       # dossier interne au projet
/var/exports/      # chemin absolu du système

Le / initial est donc significatif. Les imports et exports vers le système doivent être demandés explicitement par l’utilisateur.

Backends et compatibilité

Omega-Fire détecte les composants et active uniquement les fonctionnalités utilisables.

Composant	Rôle	Statut
nftables	Pare-feu IPv4/IPv6 moderne	Recommandé
iptables	Pare-feu IPv4	Compatible
ip6tables	Pare-feu IPv6 avec iptables	Compatible si disponible
Fail2Ban	Jails et bannissements automatisés	Optionnel
conntrack	Connexions actives	Optionnel
lnav	Analyse avancée des logs	Optionnel
systemd, runit, OpenRC	Gestion des services	Détection automatique
Docker, VNC, serveurs	Applications et services détectés	Selon installation

IPv4 et IPv6

Les deux familles d’adresses sont prises en charge par les backends compatibles :

nftables : IPv4 et IPv6 en dual stack ;
iptables/ip6tables : selon les binaires disponibles ;
Fail2Ban : selon la configuration du jail et du système.

Les formats IPv6 longs, compressés, locaux, mixtes, avec zéros et en notation CIDR sont traités par les composants concernés.

Persistance, logs et exports

Persistance

SQLite via sqlite3.
Tables relatives aux bans, règles, audits et snapshots.
Migrations versionnées appliquées automatiquement.
Archives d’état complet au format .tar.gz.

Journaux

Journal texte applicatif : var/logs/app.log.
Journal d’audit JSON structuré avec notamment event_type, actor, action, result et details.

Exports

Les exports sont disponibles en JSON, TXT et HTML, avec plusieurs thèmes CSS pour les rapports HTML.

Sécurité

Omega-Fire agit sur des composants critiques du système et doit être utilisé avec prudence.

Le lancement requiert des privilèges root via sudo.
Le flush, la purge générale et l’application d’une politique peuvent être destructifs.
Une politique prédéfinie déclenche une sauvegarde automatique avant modification.
Réalisez une sauvegarde manuelle avant chaque changement majeur.
Vérifiez l’état réel du firewall, des jails et des connexions après chaque opération.
Testez d’abord sur une machine ou une cible jetable.
Utilisez les réseaux de documentation RFC 5737 pour les essais IPv4 : 192.0.2.0/24, 198.51.100.0/24 et 203.0.113.0/24.
Vérifiez les exports et snapshots avant de les restaurer sur une machine de production.
N’accordez pas de permissions plus larges que nécessaire au dossier var/.

Tests et qualité

Activer l’environnement virtuel puis exécuter les tests unitaires :

source .venv/bin/activate
python -m unittest discover tests/unit -v

La base historique du projet couvre 150 tests unitaires sans échec. Les domaines couverts incluent le parsing, les backends, le domaine métier, l’application, l’infrastructure et les interfaces. Les tests d’intégration et end-to-end sont présents séparément et les écrans Live nécessitent encore une validation manuelle dans un terminal réel.

Outils de qualité disponibles selon la configuration du projet :

black .
flake8 .
mypy src/
pytest --cov

État du projet

Points opérationnels

TUI unifiée pour les principaux mécanismes de sécurité réseau.
Détection automatique des capacités.
Gestion des backends disponibles.
Support IPv4/IPv6 selon les outils présents.
Journalisation applicative et audit.
Sauvegarde et restauration.
Exports JSON, TXT et HTML.
Dashboard et statistiques.
Architecture en couches documentée.

Limites connues

Le mécanisme ExecutionPlan/PipelineStep reste partiellement conservé dans le projet.
La lecture clavier non bloquante est susceptible d’être dupliquée dans certains écrans Live. (non constaté mais probable)
La couverture automatisée des interfaces Live demeure limitée par l’absence de TTY dans certains environnements de test.
La disponibilité exacte des fonctionnalités dépend des binaires, services, permissions et configurations de la machine hôte.

Désinstallation

Si les données sont restées dans le dossier du projet :

sudo rm -rf ~/omega-fire

Supprimez manuellement les fichiers exportés ailleurs, les éventuels alias fire ajoutés dans ~/.bashrc ou ~/.zshrc, ainsi que le groupe dédié si celui-ci n’est plus utilisé :

sudo groupdel omega-fire

N’exécutez cette dernière commande que si aucun autre fichier ou service ne dépend de ce groupe.

Licence

Omega-Fire est distribué sous licence MIT. Consultez le fichier LICENSE pour le texte complet.

Omega-Fire — Observer, piloter, auditer, sécuriser.

Une interface TUI unifiée pour nftables, iptables, ip6tables, Fail2Ban, les logs et le monitoring réseau.

Name		Name	Last commit message	Last commit date
config		config
docs		docs
src/omega_fire		src/omega_fire
var/blocklist		var/blocklist
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh
omega-fire.sh		omega-fire.sh
omega-fire.tar.gz		omega-fire.tar.gz
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt

Latest commit

History

Folders and files

Repository files navigation