# OPNsense DHCP Server: Dynamische Adressvergabe für Profis

TL;DR / Management Summary Der DHCP (Dynamic Host Configuration Protocol) Dienst in OPNsense ist mehr als nur ein IP-Verteiler. Er ist tief in den DNS-Resolver (Unbound) integriert und ermöglicht die automatische Namensregistrierung von Clients. Ein Senior Admin nutzt statische DHCP-Mappings (Reservierungen) für alle Infrastruktur-Komponenten, setzt spezifische DHCP-Optionen für VoIP-Telefone und PXE-Boot (Artikel 494) und sichert den Pool gegen Erschöpfung ab.


# 1. Einführung & Architektur

Das Herz des LANs.

OPNsense nutzt den bewährten ISC DHCP Server. Er vergibt:


# 2. Einrichtung in der Praxis

Der Standard-Pool.

# Schritt 1: Aktivierung

Services -> DHCPv4 -> [Interface Name].

  1. Haken bei Enable DHCP server on interface setzen.
  2. Range: Definieren Sie den Pool (z.B. 10.0.0.100 bis 10.0.0.250).
  3. DNS Servers: Wenn leer, wird die IP der OPNsense übermittelt.

# Schritt 2: Statische Mappings (Reservierungen)

Anstatt IPs am Gerät (Drucker, Server) manuell zu vergeben:

  1. Scrollen Sie zum Ende der DHCP-Seite.
  2. Klicken Sie auf das Plus-Symbol bei “Static Mappings”.
  3. Geben Sie MAC-Adresse und Wunsch-IP an.

# 3. Deep Dive: Fortgeschrittene Optionen

Spezial-Konfigurationen.

# DHCP Options

Nutzen Sie das Feld “Additional Options”, um Herstellerspezifische Daten zu senden:

# PXE-Boot (Network Booting)

Wenn Sie OPNsense als Boot-Server für Proxmox-Installationen nutzen:

  1. Next-server: IP des WDS/MDT Servers.
  2. Filename: undionly.kpxe (Legacy) oder wdsmgfw.efi (UEFI).

# 4. Day-2 Operations: Pool-Management

Wenn die Adressen knapp werden.

# Lease Time

# DHCP Leases einsehen

Services -> DHCPv4 -> Leases.


# 5. Troubleshooting & “War Stories”

Wenn der Client keine IP bekommt.

# Top 3 Fehlerbilder

  1. Symptom: Client bekommt keine IP (“Eingeschränkte Konnektivität”).

    • Ursache: IP-Pool ist voll.
    • Lösung: Range vergrößern oder Lease-Time verkürzen.
  2. Symptom: “Rogue DHCP” Warnung.

    • Ursache: Ein zweiter DHCP-Server (z.B. FritzBox) im gleichen Netz.
    • Tool: nmap --script broadcast-dhcp-discover.
  3. Symptom: Statische Reservierung funktioniert nicht.

    • Ursache: MAC-Adresse falsch eingegeben oder das Gerät nutzt eine “Private/Random MAC” (Smartphone-Feature).
    • Lösung: Zufällige MACs am Smartphone für das Firmen-WLAN deaktivieren.

# “War Story”: Der “Geister”-DHCP

In einem Unternehmen konnten plötzlich keine neuen Laptops mehr ins Netz. Der OPNsense-Pool war laut GUI zu 50% frei. Die Entdeckung: Ein Mitarbeiter hatte einen alten WLAN-Router von zu Hause mitgebracht und falsch herum (LAN an LAN) eingesteckt. Dieser Router verteilte IPs aus einem völlig anderen Subnetz schneller als die OPNsense. Lehre: Aktivieren Sie DHCP Snooping auf Ihren Managed Switches. Nur der Port, an dem die OPNsense hängt, darf DHCP-Antworten schicken.


# 6. Monitoring & Alerting

Auslastung überwachen.

# Dashboard Widget

Fügen Sie das Widget “DHCP Leases” hinzu.


# 7. Fazit & Empfehlung

Der DHCP-Server ist ein kritisches Infrastruktur-Element.


# Anhang: Cheatsheet

Aufgabe Pfad
Pool konfigurieren Services -> DHCPv4 -> [Interface]
Aktive Leases Services -> DHCPv4 -> Leases
DHCP Log System -> Log-Files -> General (Filter: dhcpd)
Config Pfad (SSH) /var/dhcpd/var/db/dhcpd.leases

# Referenzen