Files
Netbox-Better-IPs/README.md
T
MrBlake acb4e449bc feat: IPAM-Bereiche automatisch ergänzen
Fehlende Prefixe können direkt aus der IPAM-Bereichsliste für alle sichtbaren IP-Adressen angelegt werden. Zusätzlich zeigt die Prefix-IP-Ansicht das zugewiesene Gerät oder die VM standardmäßig an.
2026-07-23 11:15:58 +02:00

2.6 KiB

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.
  • Unter IPAM → Prefixes/IP-Bereiche legt die Aktion Alle fehlenden Bereiche anlegen die Netze für sämtliche bereits vorhandenen, sichtbaren IP-Adressen an.
  • Unter Prefix/IP-Bereich → IP-Adressen wird das zugehörige Gerät beziehungsweise die VM standardmäßig als eigene Spalte angezeigt.

Installation

/opt/netbox/venv/bin/pip install git+https://git.mrblake.cc/MrBlake/Netbox-Better-IPs.git
echo "git+https://git.mrblake.cc/MrBlake/Netbox-Better-IPs.git" >> /opt/netbox/local_requirements.txt

In configuration.py:

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:

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.

Die Aktion für Bestandsdaten benötigt ipam.view_ipaddress und ipam.add_prefix. Sie verarbeitet nur IP-Adressen, die der ausführende Benutzer sehen darf.

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.