knauer/identroute repository overview

⁠IdentRoute

IdentRoute vereint Reverse Proxy und Zugriffsschutz in einem Docker-Container. Caddy übernimmt HTTPS und die automatische Verwaltung von Let’s-Encrypt-Zertifikaten. Die Weboberfläche dient zur Administration von HTTP- und TCP-Routen, Authentifizierung, Middleware und Logs.

⁠Funktionen

• Automatische HTTP-Routen für Docker-Container mit identroute.host-Label
• HTTPS mit automatischen Let’s-Encrypt-Zertifikaten durch Caddy
• HTTP-zu-HTTPS-Weiterleitung
• Manuelle HTTP-Routen und TCP-Routen, zum Beispiel für PostgreSQL oder MySQL
• Authentifizierung pro Route: ohne Anmeldung, Benutzername und Passwort oder Passwort mit TOTP
• LDAP-Anbindung oder lokale Benutzerverwaltung
• Redis-Unterstützung für Sitzungen
• SMTP-Einstellungen und Benachrichtigungen
• Middleware-Verwaltung mit Fail2ban für IdentRoute und GeoJS-Unterstützung
• Logs, Backups und Performance-Übersicht in der Weboberfläche

⁠Docker-Routen

Container werden über Labels erkannt. Beispiel:

labels: identroute.host: "n8n.example.de" identroute.host.port: "5678"

Die Authentifizierungsregeln werden anschließend in der IdentRoute-Weboberfläche pro Route festgelegt.

Ports:

Port Zweck 80/tcp HTTP; leitet Anfragen auf HTTPS um 443/tcp HTTPS-Reverse-Proxy 8080/tcp Administrationsoberfläche 3306/tcp TCP-Routing, zum Beispiel für MySQL/MariaDB 5432/tcp TCP-Routing, zum Beispiel für PostgreSQL 9091/tcp Interner Authentifizierungs-Endpunkt für Caddy

Die Administrationsoberfläche sollte nur in vertrauenswürdigen Netzwerken erreichbar sein. Persistente Daten:

Binde das Datenverzeichnis des Containers als Volume ein. Dort speichert IdentRoute unter anderem verschlüsselte Einstellungen, Caddy-Zertifikate, Logs, Backups und Middleware-Daten. Das Volume sollte regelmäßig gesichert werden.

Docker-Zugriff:

Für die automatische Erkennung lokaler Container benötigt IdentRoute Zugriff auf den Docker-Socket. Der Docker-Socket gewährt weitreichende Kontrolle über die Docker-Engine und sollte nur in einer vertrauenswürdigen Umgebung eingebunden werden. Externe Docker-Hosts können über einen Portainer Agent angebunden werden.

In der Version 0.4.7 wurde UDP-Routing integriert als auch automatische Backups als auch Wiederherstellung von Backups integriert.

Ab Version 0.4.8 ist eine mehrsprachige Oberfläche integriert (Deutsch, Englisch, Spanisch, Portugiesisch und Italienisch)

Weiterhin wurden bekannte Vulnerabilities beseitigt und das System gehärtet.