feat: automatische Prefix-Zuordnung und IP-Netzübersicht hinzufügen

- fehlende Prefixe beim Speichern von IP-Adressen automatisch erstellen - VRF, Mandant, Standort und Lokation übernehmen - bestehende IP-Adressen per Management-Command abgleichen - filterbare IP-Netzübersicht für Regionen, Standorte und Mandanten ergänzen - NetBox 4.6.5 unterstützen
2026-07-23 11:06:50 +02:00
commit 24e59ee9c0
16 changed files with 461 additions and 0 deletions
@@ -0,0 +1,52 @@
+# NetBox Better IPs
+
+Plugin für **NetBox 4.6.5** mit zwei Funktionen:
+
+- Beim Speichern einer IP-Adresse wird das durch deren CIDR-Maske beschriebene Prefix gesucht und, falls es fehlt, automatisch erstellt. NetBox ordnet die IP danach nativ anhand von Prefix und VRF ein.
+- Eine zusätzliche IP-Netzübersicht kann nach Organisation/Region, Standortgruppe, Standort, Lokation, Mandantengruppe und Mandant gefiltert werden.
+
+## Installation
+
+```bash
+/opt/netbox/venv/bin/pip install /pfad/zu/Netbox-Better-IPs
+```
+
+In `configuration.py`:
+
+```python
+PLUGINS = ["netbox_better_ips"]
+
+PLUGINS_CONFIG = {
+    "netbox_better_ips": {
+        "auto_create_prefix": True,
+        "prefix_status": "active",
+        "inherit_scope": True,
+        "inherit_tenant": True,
+        "ignore_host_prefixes": True,
+    }
+}
+```
+
+Danach NetBox neu starten. Das Plugin hat keine eigenen Datenbankmodelle und benötigt daher keine Migration.
+
+## Verhalten
+
+Aus `192.0.2.17/24` wird bei Bedarf `192.0.2.0/24` in derselben VRF erstellt. Bei einer Interface-Zuweisung wird bevorzugt die Lokation, sonst der Standort als Prefix-Scope übernommen. Der Mandant wird von der IP oder dem zugewiesenen Gerät/der VM übernommen. Vorhandene Prefix-Metadaten werden nie überschrieben.
+
+Hostmasken (`/32`, `/128`) werden standardmäßig nicht als Prefix erstellt. Dies kann mit `ignore_host_prefixes=False` geändert werden.
+
+Bereits vorhandene IP-Adressen lassen sich abgleichen:
+
+```bash
+python /opt/netbox/netbox/manage.py reconcile_ip_prefixes --dry-run
+python /opt/netbox/netbox/manage.py reconcile_ip_prefixes
+```
+
+## Berechtigungen
+
+Für die Übersicht ist die NetBox-Berechtigung `ipam.view_prefix` erforderlich. Die automatische Erstellung läuft serverseitig; stellen Sie sicher, dass dies zu Ihrem Berechtigungs- und Change-Control-Konzept passt.
+
+## Hinweis zu „Organisation"
+
+NetBox besitzt kein separates Core-Modell namens Organisation. Die Übersicht bildet Organisation auf NetBox-`Region` ab und bezieht untergeordnete Regionen sowie deren Standorte und Lokationen ein.
+