Files
OPNexus/README.de.md
T
Julian Boldt 3b76f9f5fa
Release / verify (push) Canceled after 0s
CI / checks (push) Canceled after 0s
CI / frontend (push) Canceled after 0s
CI / backend (push) Canceled after 0s
Release / test (push) Canceled after 0s
Release / publish (backend) (push) Canceled after 0s
Release / publish (frontend) (push) Canceled after 0s
Release / publish (proxy) (push) Canceled after 0s
Release v1.14.0
Diagnose von der Firewall aus sowie VXLAN und GIF. Gegen die OPNsense-Core-Quellen
geprüft und live auf den Test-Firewalls getestet, siehe Handbuch „Erweiterung 1.14.0“:

- **Host-System › Diagnose:** Ping, Traceroute, Port-Prüfung und DNS-Abfrage, ausgeführt von der
  ausgewählten Firewall. Nur für Admins, strenge Eingabeprüfung, jeder Lauf im Audit-Log,
  Ping-Jobs werden immer wieder aufgeräumt, der Banner der Gegenstelle wird nicht weitergegeben.
  Packet-Capture gibt es bewusst nicht (Mitschnitte enthalten fremde Nutzdaten).
- **Netzwerk › Geräte:** VXLAN und GIF-Tunnel (anlegen, ändern, löschen) über dieselbe abgesicherte
  Engine wie die übrigen Geräte.
- **Fehlerkorrektur:** Auf den Host-System-Seiten war „Übersicht › Hosts“ markiert und der Seitentitel
  falsch, weil `/hostsystem` mit `/hosts` beginnt.
2026-10-09 22:49:10 +02:00

4.6 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

Zentrale Firewall-Regeln

Stand: 1.14.0 ist 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 lassen sich übernehmen.
  • Zertifikate — Trust-Store für alle Firewalls und Ausstellung per ACME / Let's Encrypt.
  • Logs & Audit — zentrale Log-Suche mit Korrelation, Dashboards und lückenloser Deploy-Verlauf.
  • Update-Center — Firmware-Updates für die Flotte, mit Blick auf HA-Reihenfolge und Wartungsmodus.
  • Zugang — HTTPS mit gepinnten Firewall-Zertifikaten, optionale Zwei-Faktor-Anmeldung, Rollen (Admin / Nur-Lesen), Tastaturbedienung, Dark Mode, Oberfläche auf Deutsch und Englisch.

Alle Screenshots zeigen fiktive Beispieldaten.

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:

docker compose logs backend | grep -A5 "generated password"

Für den Zugriff von anderen Rechnern und den Produktivbetrieb mit TLS (mitgelieferter Caddy-Proxy) siehe das Handbuch.

Fertige Images (amd64) liegen in der Registry dieses Gitea. In der .env:

OPNEXUS_IMAGE_REPO=git.opnexus.dev/opnexus
OPNEXUS_VERSION=1.14.0
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 (UPDATE_CHECK_URL=https://updates.opnexus.dev/latest.json) ist aus, solange du ihn nicht setzt; 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.