█████╗ ██╗ ██╗████████╗ ██████╗ ██████╗ ███████╗██████╗ ██╗ ██╗ ██╗
██╔══██╗██║ ██║╚══██╔══╝██╔═══██╗██╔══██╗██╔════╝██╔══██╗██║ ╚██╗ ██╔╝
███████║██║ ██║ ██║ ██║ ██║██████╔╝█████╗ ██████╔╝██║ ╚████╔╝
██╔══██║██║ ██║ ██║ ██║ ██║██╔══██╗██╔══╝ ██╔═══╝ ██║ ╚██╔╝
██║ ██║╚██████╔╝ ██║ ╚██████╔╝██║ ██║███████╗██║ ███████╗ ██║
╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚══════╝ ╚═╝
Projekt: autoreply
Beschreibung: Enterprise Autoreply Management und Compliance Plattform für Postfix-Umgebungen (GUI → API → Mailfilter)
Sprache: Perl 5.30+ (Mailfilter), Python 3.6+ (Services Agent), PHP 8.1+ (Web-Konsole), Bash (Installation)
Zweck: Betriebssichere und zentralisierte Verwaltung von Autoreply-Regeln für Postfix-Cluster
Zentrale Auto-Response Verwaltung für Postfix-Cluster
Die Autoreply Plattform ist eine vollumfängliche, produktionsreife Lösung zur zentralen Verwaltung automatischer E-Mail-Antworten in Postfix-basierten Mailinfrastrukturen.
Sie kombiniert eine robuste Mailfilter-Runtime mit einer zentralen Service- und API-Ebene sowie einer optionalen webbasierten Administrationsoberfläche. Der Fokus liegt auf stabilen Betriebsabläufen, klarer Trennung der Komponenten und nachvollziehbaren Änderungen.
Die Plattform wurde entwickelt, um Autoreply-Regeln in Umgebungen mit mehreren Postfix-Servern kontrolliert, einheitlich und revisionssicher zu betreiben.
Typische Herausforderungen, die gelöst werden:
- Manuelle Pflege von Autoreplies auf einzelnen Servern
- Fehlende oder inkonsistente Backups
- Keine saubere Änderungshistorie
- Aufwendige Rollbacks
- Hohe Abhängigkeit der Fachabteilungen von der IT
Die Autoreply Plattform ersetzt diesen Ansatz durch eine zentrale Steuerung, ohne den Mailfluss unnötig zu verkomplizieren oder von Verwaltungsdiensten abhängig zu machen.
- Mailverarbeitung erfolgt lokal auf jedem Postfix-Server
- Administration und Konfigurationspflege erfolgen zentral
- Jede Änderung wird validiert, versioniert und gesichert
- GUI und API sind nicht kritisch für den Mailfluss
- Rollbacks sind jederzeit möglich
- Zentrale Verwaltung mehrerer Postfix-Server
- Einheitliche Autoreply-Regeln für E-Mail-Adressen und Domains
- Automatische Backups bei jeder Änderung
- Versionierung mit Diff- und Restore-Funktion
- Kontrolliertes Deployment auf einzelne oder alle Server
- Trennung von Runtime und Verwaltungslogik
- Audit- und Compliance-tauglicher Betrieb
Geeignet für:
- Unternehmen mit mehreren Postfix-Instanzen
- Organisationen mit 100 bis 2000 Fachanwendungen
- IT-Betrieb mit Änderungs- und Nachweispflichten
- Umgebungen mit klarer Trennung von Betrieb und Inhalt
Typische Einsatzbereiche:
- HR Bewerbungsbestätigungen
- Finanzabteilungen für Rechnungseingänge
- Support- und Ticket-Systeme
- Allgemeine Service- und Info-Adressen
Dieses Repository enthält die technische Kernplattform.
Enthalten sind:
- Autoreply Mailfilter (Postfix Pipe)
- Autoreply Services Agent (systemd Service mit HTTP API)
- Zentrale Konfigurations-, Backup- und Restore-Mechanismen
- Installations- und Betriebslogik
- Technische Dokumentation
Die Web-Konsole ist logisch Teil der Plattform, wird jedoch separat installiert und betrieben.
Die Plattform ist strikt modular aufgebaut.
Postfix
Übergibt eingehende E-Mails an den Autoreply Mailfilter.
Autoreply Mailfilter
Verarbeitet E-Mails, prüft Regeln, Limits und Loop-Schutz und versendet Antworten.
Keine Verwaltungslogik, keine API.
Services Agent (HTTP API)
Zentrale Steuerinstanz für Konfigurationen.
Validierung, Versionierung, Backup und Rollback.
Autoresponder Console (WWW)
Optionale webbasierte Administrationsoberfläche.
Greift ausschliesslich über die API zu und verarbeitet keine E-Mails.
GUI → Services Agent → JSON-Konfigurationen → Mailfilter → Postfix
Der Mailfluss bleibt auch bei Ausfall von GUI oder API vollständig funktionsfähig.
Die technische Plattform wird vollständig über ein zentrales Installationsskript eingerichtet.
SUSE:
sudo zypper install perl-Mojolicious perl-JSON perl-Net-CIDR perl-Log-Log4perl && echo "Module installiert"Debian/Ubuntu:
sudo apt update && sudo apt install libmojolicious-perl libjson-maybexs-perl libnet-cidr-perl liblog-log4perl-perl && echo "Module installiertInstall:
sudo ./install.sh- Anlegen von Service-Usern und Gruppen
- Deployment des Autoreply Mailfilters
- Installation des Services Agent
- Setzen aller benötigten Verzeichnis- und Dateiberechtigungen
- Installation und Aktivierung der systemd Services
- Initiales Anlegen von Konfigurations- und Backup-Verzeichnissen
- Web-Konsole
- Reverse Proxies
- TLS-Termination
- Externe Monitoring- oder Logging-Systeme
- Linux mit systemd
- Postfix installiert und aktiv
- Perl und Python verfügbar
- Root-Zugriff für Installation
- Interner Betrieb vorgesehen
Die Autoresponder Console dient der komfortablen Administration und Visualisierung.
Sie ist kein Bestandteil von install.sh, ergänzt die Plattform aber funktional.
- Verwaltung von Autoreply-Einträgen (E-Mail und Domain)
- HTML- und Text-Templates mit Platzhaltern
- Live-Quelle und Origin-Vergleich
- Backup-, Diff- und Restore-Funktionen
- Verteilung auf mehrere Mailserver
Siehe Screenshots können unter docs/screenshots/.
- Mailverarbeitung ist vollständig entkoppelt von API und GUI
- Konfigurationsänderungen erfolgen ausschliesslich über den Services Agent
- Keine manuellen JSON-Änderungen im Produktivbetrieb
- Jede Änderung erzeugt automatisch ein Backup
- Rollbacks sind jederzeit möglich
- Interner Betrieb ohne Public Exposure
- API-Zugriff über IP-Allowlisten
- Optionale TLS-Absicherung
- Dedizierte Service-User ohne Root-Betrieb
- Keine Secrets im Code oder Repository
- Nachvollziehbare Änderungen durch Backups und Diffs
- README.md Gesamtübersicht und Installation
- autoreply/README.md Mailfilter
- services-agent/README.md Service-Betrieb
- services-agent/README_API.md HTTP API
Dieses Projekt steht unter der MIT Lizenz.
Siehe LICENSE.