Julian Boldt
95f297d3f2
- **`opnexus update` prüft den Proxy vor dem Wechsel:** Nach dem Ziehen der Images validiert das Werkzeug die Caddy-Konfiguration des neuen Proxy-Images mit den Umgebungsvariablen *dieser* Installation. Ist sie ungültig, bricht das Update ab, bevor etwas gewechselt wurde. Der Fall aus 1.27.0 (Compose-Datei mit leerem `OPNEXUS_GUI_SITES`) wird dabei automatisch repariert: Das Werkzeug trägt den Platzhalter `OPNEXUS_GUI_SITES=https://localhost:9441` in die `.env` ein und sagt es. Installationen, die noch die Compose-Datei aus 1.27.0 haben, müssen also nur einmal `opnexus update` ausführen. - **`opnexus update` erkennt einen abstürzenden Proxy:** Ein Dienst ohne Healthcheck (der Proxy) gilt jetzt erst nach 10 Sekunden durchgehender Laufzeit als gesund. Bisher meldete das Update „Fertig“, obwohl der Proxy in einer Neustart-Schleife hing, und das automatische Zurückrollen griff nicht.
7.7 KiB
OPNexus
Alle OPNsense-Firewalls. Eine Konsole. Zentrale Verwaltung mehrerer OPNsense-Firewalls: Regeln, Aliase, NAT, VPN, Zertifikate, Logs und Updates — per OPNsense-API ausgerollt, mit Vorschau, Bestätigung und automatischem Rollback.
Website · Changelog · Handbuch · English
Stand:
1.27.2ist die aktuelle stabile Version. Entwickelt und getestet wurde gegen echte OPNsense-Instanzen; eine frische Installation aus dem Release-Bundle sowie Updates und Rollbacks sind durchgängig geprüft. Ecken und Kanten bitte melden.
Funktionen
- Flotte & Hochverfügbarkeit — Live-Status aller Hosts, CARP-Rollen nebeneinander, Ereignis-Historie, Alarm bei Split-Brain oder fehlendem MASTER, Wartungsmodus mit optionalem Auto-Revert-Timer.
- Regeln, Aliase & NAT — zentral gepflegt, gezielt auf Hosts oder Gerätegruppen ausgerollt; Port-Forward, 1:1- und Outbound-NAT mit Drift-Erkennung zwischen Cluster-Knoten.
- Sichere Änderungen — jede Änderung läuft Prüfen → Ausrollen → Bestätigen; bleibt die Bestätigung im Zeitfenster aus, rollt OPNexus zurück.
- Hierarchische Policies — Pre-/Post-Rulebases mit Vererbung über Gruppenbäume.
- VPN — IPsec-Site-to-Site, OpenVPN und WireGuard, einmal definiert und ausgerollt.
- Netzwerk — Schnittstellen, VLANs, virtuelle IPs, Gateways, Routen, LAGG/Bridge/GRE, DNS und DHCP je Firewall, dazu Tunables, Cron, Syslog, Snapshots und Diagnose (Ping, Traceroute, Port-Prüfung, DNS), ein Abgleich der Cluster-Knoten, mit Diff-Vorschau, Backup vor jeder Änderung und Schutz davor, die eigene Verbindung zu kappen; von Hand angelegte Regeln, Aliase und NAT-Regeln lassen sich übernehmen.
- Zertifikate — Trust-Store für alle Firewalls und Ausstellung per ACME / Let's Encrypt.
- Alarme — Gateway-/WAN-Ausfall (down, Paketverlust, Latenz), Schwellen für Platte, Speicher, Swap und CPU sowie ausgefallene Dienste; über mehrere Messungen entprellt, damit Einzelspitzen und flackernde Verbindungen schweigen. Zustellung per E-Mail, Webhook, ntfy, Gotify, Telegram, Microsoft Teams oder Matrix, jedes Ereignis einzeln schaltbar.
- Firewall-Oberfläche über OPNexus — die Weboberfläche einer Firewall in einem eigenen Browser-Tab über OPNexus öffnen, auch hinter NAT; nur für Admins, Einmal-Ticket, eigene Origin, Zeitlimits und Audit (standardmäßig aus).
- Logs & Audit — zentrale Log-Suche mit Korrelation, Dashboards und lückenloser Deploy-Verlauf.
- Update-Center und Rollouts — Firmware-Updates für die Flotte, mit Blick auf HA-Reihenfolge und Wartungsmodus; Rollouts in Wellen (Canary → Pilot → Prod) mit wiederkehrenden Wartungsfenstern, Gesundheitsprüfung zwischen den Wellen und automatischem Halt bei jeder Auffälligkeit.
- Einrichtungsassistent — geführter Erststart nach der Installation: eigenes Passwort, Zwei-Faktor und die erste Firewall verbinden.
- Selbst-Update — OPNexus aktualisiert sich auf Wunsch aus der eigenen Oberfläche, mit Fortschritt und automatischem Rollback (optional).
- Automatisierung — persönliche API-Tokens (Lesen / Ausrollen / Admin), Prometheus-Metriken, ein nur lesender MCP-Endpunkt für KI-Assistenten und ein OpenAPI-Schema.
- Sicherheitslage — ein Wert von 0 bis 100 je Firewall aus Härtungs- und Regel-Hygiene-Prüfungen (offene WAN-Regeln, schwaches SSH/SNMP, verdeckte Regeln, alte Backups …), nur lesend.
- Regel-Analyse — „Welche Regel trifft?“ für Quelle, Ziel, Protokoll und Port: die entscheidende Regel je Firewall (oder Flotte/Gruppe) mit ehrlicher Sicherheit (sicher / vermutlich / unbekannt) und Prüfprotokoll Regel für Regel, nur lesend.
- Backups & Wiederherstellung — geplante Konfigurationssicherungen mit Aufbewahrung, verschlüsselte Offsite-Kopie auf S3-kompatiblen Speicher, Änderungsansicht zwischen Sicherungen und eine vollständige verschlüsselte Sicherung von OPNexus selbst (
opnexus backup --full). - Single Sign-on — Anmeldung über deinen Identitätsanbieter (OIDC); die Rolle kommt bei jeder Anmeldung aus dessen Gruppen.
- Zugang — HTTPS mit gepinnten Firewall-Zertifikaten, optionale Zwei-Faktor-Anmeldung, Rollen (Admin / Operator / Nur-Lesen), Tastaturbedienung, Dark Mode, Oberfläche auf Deutsch und Englisch.
Alle Screenshots zeigen fiktive Beispieldaten.
Ratgeber
- OPNsense-Firewalls zentral verwalten – wann sich zentrale Verwaltung lohnt und wie sie funktioniert
- OPNsense-HA-Cluster mit CARP verwalten – Rollen, Alarme, geordnete Updates, Abgleich beider Knoten
- OPNsense-Regeln sicher ausrollen – Vorschau, Bestätigungsfenster und automatischer Rollback
- Das Kommandozeilen-Werkzeug
opnexus– Installation aktualisieren, zurückrollen und sichern
Schnellstart
Voraussetzung: Docker mit Compose-Plugin.
git clone https://git.opnexus.dev/opnexus/opnexus.git
cd opnexus
cp .env.example .env # POSTGRES_PASSWORD (und ADMIN_PASSWORD) setzen
docker compose up -d --build
Die Oberfläche läuft dann unter http://localhost:3100. Ohne ADMIN_PASSWORD wird beim ersten Start ein zufälliges Admin-Passwort erzeugt und einmalig im Backend-Log ausgegeben. Verloren oder nie gesehen? Dieses Kommando setzt ein neues Zufallspasswort und zeigt es an (im Repo-Checkout scripts/opnexus, im Release-Bundle ./opnexus):
scripts/opnexus password
Nach der ersten Anmeldung öffnet sich von selbst ein kurzer Einrichtungsassistent: eigenes Passwort setzen, optional Zwei-Faktor-Anmeldung einschalten, die erste Firewall verbinden (samt Anleitung für den API-Key in OPNsense). Er lässt sich überspringen und jederzeit unter System › Einrichtung wieder öffnen.
Für den Zugriff von anderen Rechnern und den Produktivbetrieb mit TLS (mitgelieferter Caddy-Proxy) siehe das Handbuch.
Fertige Images (amd64 und arm64) liegen in der Registry dieses Gitea. In der .env:
OPNEXUS_IMAGE_REPO=git.opnexus.dev/opnexus
OPNEXUS_VERSION=1.27.2
docker compose pull && docker compose up -d --no-build
Aktualisiert wird danach mit scripts/opnexus update / rollback (erst ziehen, vor Migrationen ein Datenbank-Backup, automatisches Zurückrollen, wenn die Dienste nicht gesund werden).
Datenschutz
OPNexus wird selbst betrieben und hat keine Telemetrie. Es verbindet sich nur mit deinen Firewalls und mit Benachrichtigungszielen, die du selbst einrichtest. Der optionale Hinweis auf neue Versionen (Schalter unter Einstellungen › OPNexus aktualisieren, oder UPDATE_CHECK_URL in der .env) ist aus, solange du ihn nicht einschaltest; eingeschaltet geht höchstens alle 12 Stunden ein einfaches GET mit dem User-Agent OPNexus/<Version> hinaus — ohne Instanz- oder Nutzerdaten.
Lizenz
OPNexus ist quelloffen einsehbar (source-available) unter der PolyForm Shield License 1.0.0 — es ist keine Open-Source-Software im Sinne der OSI. Du darfst den Code herunterladen, lesen, verändern und nutzen, auch in einem Unternehmen für die eigenen Firewalls. Nicht erlaubt ist, damit ein konkurrierendes Produkt anzubieten (etwa Weiterverkauf oder Betrieb als gehosteter Dienst). Maßgeblich ist der Lizenztext.
Sicherheit
Sicherheitslücken bitte vertraulich an [email protected] melden, siehe SECURITY.md.
OPNexus ist ein unabhängiges Projekt und steht in keiner Verbindung zu Deciso B.V. oder dem OPNsense®-Projekt. OPNsense® ist eine Marke von Deciso B.V.