Home WissenUniFi WireGuard Site-to-Site: Zwei Standorte über eine OPNsense verbinden

UniFi WireGuard Site-to-Site: Zwei Standorte über eine OPNsense verbinden

by Dimitri Roschkowski
0 Kommentare

Ich habe zwei Standorte mit UniFi-Routern, einen mit einem Cloud Gateway Ultra und einen mit einer Dream Machine Pro, dazu Server in einem Rechenzentrum hinter einer OPNsense. Alle drei sollten sich gegenseitig erreichen: Laptop am einen Standort auf die Server, Home Assistant am anderen Standort vom ersten aus. UniFi bringt dafür eine eigene Site-to-Site-Funktion mit. Die passt aber nicht, sobald eine Gegenstelle keine UniFi ist oder ein Standort hinter dem NAT des Providers hängt. Meine Lösung ist ein Stern mit der OPNsense in der Mitte: Beide UniFi-Router verbinden sich per WireGuard als Client zur OPNsense, und die vermittelt zwischen allen Netzen. Dieser Artikel zeigt den Aufbau mit Screenshots aus beiden Oberflächen, inklusive der Stellen, an denen es typischerweise hakt.

Zwei Häuser in unterschiedlichen Landschaften, verbunden durch leuchtende Linien mit einem Rechenzentrum in der Mitte
Zwei Standorte, ein Hub: Die Verbindungen laufen sternförmig über das Rechenzentrum. (Symbolbild, KI-generiert)

Das Wichtigste in Kürze

  • Stern statt Mesh: Die OPNsense ist WireGuard-Server, beide UniFi-Router sind Clients. Verkehr zwischen den Standorten läuft über die OPNsense.
  • Funktioniert hinter NAT: Weil die UniFi-Router die Verbindung selbst aufbauen, darf ein Standort auch hinter dem Router des Providers hängen. Nur die OPNsense braucht eine öffentliche IP.
  • UniFi als „VPN Client“: Die Konfiguration kommt als WireGuard-Datei. Sie braucht eine DNS-Zeile, sonst lehnt UniFi sie ab. Welche Netze in den Tunnel gehen, legt eine Policy-Based Route fest.
  • Zwei Mal maskieren: UniFi maskiert in den Tunnel, die OPNsense ins Server-LAN. Dadurch braucht keine VM eine Rückroute.
  • MTU beachten: Bei mir läuft der Standort-Tunnel durch einen weiteren Tunnel, deshalb MTU 1280.

Warum nicht die Site-to-Site-Funktion von UniFi?

UniFi bietet unter Settings → VPN → Site-to-Site VPN mehrere Varianten an: SD-WAN (früher Site Magic) zwischen UniFi-Gateways, IPsec und OpenVPN zu Fremdgeräten. Für meinen Fall hatten alle einen Haken:

  • SD-WAN verbindet nur UniFi mit UniFi. Die OPNsense im Rechenzentrum bleibt außen vor.
  • Klassisches Site-to-Site braucht auf beiden Seiten eine erreichbare Adresse. Einer meiner Standorte hängt hinter dem Router des Internetanbieters, eingehende Verbindungen kommen dort nicht an.
  • Ein alter OpenVPN-Tunnel zu einem längst abgeschalteten Server stand noch in der Konfiguration und enthielt ein Netz des anderen Standorts. Solche Leichen sollte man vorher deaktivieren, sonst konkurrieren die Routen.

Die Variante VPN Client löst beides: Der UniFi-Router baut die Verbindung selbst nach außen auf, wie ein Laptop mit WireGuard-App. Was über diesen Tunnel geht, bestimmen Policy-Based Routes. Das funktioniert mit jedem WireGuard-Server, hier eben der OPNsense.

Der Aufbau

Schema: Standort A mit UCG Ultra und Standort B mit UDM Pro verbinden sich per WireGuard als Client mit der OPNsense, die das Server-LAN anbindet
Sternförmiger Aufbau mit der OPNsense als Hub. Alle Adressen sind Beispiele oder private Netze.
Teil Rolle Netze
OPNsense WireGuard-Server wg0, Port 51820, öffentlich erreichbar unter 203.0.113.1 Tunnelnetz 10.113.113.0/24 (OPNsense .1), Server-LAN 192.168.20.0/24
Standort A (Cloud Gateway Ultra) WireGuard-Client, Tunnel-IP 10.113.113.2 10.2.0.0/24, 10.100.100.0/24 und weitere
Standort B (Dream Machine Pro) WireGuard-Client, Tunnel-IP 10.113.113.3 10.30.0.0/24, 10.40.0.0/24 und weitere
Vorher prüfen: Überschneiden sich die Netze? Kein Netz darf an zwei Standorten vorkommen. Zwei Mal 192.168.1.0/24 lässt sich nicht routen. Die Standardnetze von UniFi (192.168.1.0/24) und vielen Fritzboxen sind dafür berüchtigt. Notfalls ein Netz umziehen, bevor du den Tunnel baust.

Die öffentliche IP der OPNsense bekomme ich über einen eigenen WireGuard-Tunnel von noez, wie im Artikel OPNsense WireGuard: Eigene öffentliche IPs per noez Premium-Tunnel beschrieben. Das ist für den Aufbau hier aber nicht nötig: Jede OPNsense mit einer erreichbaren Adresse funktioniert genauso.

Schritt 1: WireGuard-Server auf der OPNsense

Menü Einstellung
VPN → WireGuard → Instances Instanz WG-Server, Listen Port 51820, Tunneladresse 10.113.113.1/24. Disable Routes aus: Hier sollen die Routen zu den Standortnetzen automatisch entstehen.
VPN → WireGuard → Peers Je Standort ein Peer mit Public Key und Preshared Key. Endpoint bleibt leer, weil sich die Clients melden. Keepalive 25.
Firewall → Rules → WAN UDP 51820 auf die öffentliche IP erlauben
Firewall → Rules → WireGuard (Gruppe) Verkehr aus dem Tunnel erlauben, am besten nur zu den Netzen, die erreichbar sein sollen
OPNsense-Peer-Liste mit Standort-A und Standort-B an der Instanz WG-Server sowie dem noez-Tunnel
Die Peers der beiden Standorte hängen an der Instanz WG-Server.

Das Wichtigste steht in den Allowed IPs jedes Peers. WireGuard benutzt sie doppelt: als Filter (welche Absender darf dieser Peer schicken) und als Routing-Tabelle (welche Ziele gehen an diesen Peer). Deshalb gehören hier die Tunnel-IP des Standorts als /32 und alle Netze des Standorts hinein, aber nicht das Tunnelnetz als Ganzes.

OPNsense Peer bearbeiten: Allowed IPs mit Tunnel-IP 10.113.113.3/32 und den Netzen von Standort B, Schlüssel ausgeblendet
Allowed IPs von Standort B: eigene Tunnel-IP plus alle Netze dort. Schlüssel sind unkenntlich gemacht.
Typischer Fehler: Bei mir stand bei einem Peer noch das Server-LAN (192.168.20.0/24) in den Allowed IPs, ein Überbleibsel aus einer früheren Einrichtung. Damit „gehört“ das Server-LAN für WireGuard plötzlich zu diesem Peer, und Antworten an die Server landen im falschen Tunnel. Jedes Netz darf nur bei genau einem Peer stehen.

Die Schlüssel erzeuge ich auf der OPNsense selbst (wg genkey | tee priv | wg pubkey), auch die privaten Schlüssel für die UniFi-Seite. Sie landen nur in der Konfigurationsdatei für den jeweiligen Standort. Die Zwischendateien lösche ich danach.

Schritt 2: Source-NAT ins Server-LAN

Die Server im Rechenzentrum wissen nichts von den Standortnetzen. Damit sie trotzdem antworten, maskiert die OPNsense alles, was aus dem Tunnelnetz ins Server-LAN geht, auf ihre eigene LAN-Adresse. Dafür muss der Modus unter Firewall → NAT → Source NAT auf „Hybrid“ stehen, dann eine eigene Regel anlegen:

OPNsense Source NAT im Hybrid-Modus mit einer Regel auf LAN: Quelle 10.113.113.0/24, Ziel 192.168.20.0/24, übersetzt auf 192.168.20.1
Eine Regel genügt: Alles aus dem Tunnelnetz erscheint im Server-LAN als 192.168.20.1.
Ablauf: Laptop 10.2.0.45 wird vom UniFi-Router auf 10.113.113.2 maskiert, die OPNsense maskiert auf 192.168.20.1, die VM antwortet an die OPNsense
Durch das doppelte Maskieren braucht keine VM eine Route zu den Standorten.

Warum maskiert die UniFi-Seite überhaupt? Das ist bei UniFi im Modus „VPN Client“ fest eingebaut: Alles, was in den Tunnel geht, bekommt die Tunnel-IP des Routers als Absender. Für die OPNsense sieht Standort A deshalb aus wie ein einzelner Rechner mit 10.113.113.2. Das ist bequem, denn die OPNsense muss nur die Tunnel-IPs kennen. Der Nachteil: In Logs sieht man nicht, welches Gerät am Standort die Verbindung aufgebaut hat.

Ohne die NAT-Regel auf der OPNsense hätte bei mir nur eine einzige VM geantwortet, nämlich die, die zufällig eine passende Rückroute hatte. Alle anderen schickten ihre Antworten über ihr normales Standard-Gateway ins Leere.

Schritt 3: UniFi als WireGuard-Client

In der UniFi-Oberfläche (hier Network 11) liegt das unter Settings → VPN → VPN Client → Create New. Typ WireGuard, dann die Konfigurationsdatei hochladen. Für Standort B sieht sie so aus:

[Interface]
PrivateKey = <privater Schlüssel von Standort B>
Address = 10.113.113.3/32
DNS = 1.1.1.1
MTU = 1280

[Peer]
PublicKey = <Public Key der OPNsense-Instanz WG-Server>
PresharedKey = <Preshared Key>
Endpoint = 203.0.113.1:51820
AllowedIPs = 10.113.113.0/24, 192.168.20.0/24, 10.2.0.0/24, 10.100.100.0/24
PersistentKeepalive = 25
  • DNS-Zeile ist Pflicht. Ohne sie lehnt UniFi die Datei ab (in der API heißt der Fehler MISSING_INTERFACE_DNS). Der eingetragene Server spielt für das Routing keine Rolle.
  • AllowedIPs sind hier alle Ziele, die über den Tunnel erreichbar sein sollen: Tunnelnetz, Server-LAN und die Netze des anderen Standorts.
  • Endpoint ist die öffentliche Adresse der OPNsense.

Damit steht der Tunnel, aber es geht noch nichts hinein. Welche Ziele über den Tunnel laufen, legt eine Policy-Based Route fest. Die findest du unter Policy Engine → Policy Table oder Routing Table: Quelle „Any“, Ziel die Liste der Netze von oben, Interface der VPN-Client. Den Kill Switch lasse ich aus. Laut Ubiquiti stoppt er bei einem Tunnelausfall den Verkehr, ohne ihn fällt der Verkehr auf die normale Internetleitung zurück. Für private Zielnetze ist das gleichgültig, die sind über das Internet ohnehin nicht erreichbar.

UniFi Network: links der VPN-Client WG-OPNsense mit WireGuard-Datei und Verbindungsstatus, rechts die Policy-Based Route mit Quelle Any und den Zielnetzen über den Tunnel
Links der VPN-Client mit Status „Established“, rechts die Route, die die Zielnetze in den Tunnel schickt. Schlüssel ausgeblendet.

Schritt 4: Eingehenden Verkehr in UniFi erlauben

Der VPN-Client landet in der Firewall-Zone „External“. Damit Geräte vom anderen Standort oder von der OPNsense aus auf das lokale Netz zugreifen können, braucht es eine Firewall-Policy: Quelle Zone External mit dem Tunnelnetz 10.113.113.0/24, Ziel Zone Internal, Aktion Allow. Wer den Router selbst aus dem Tunnel anpingen will, braucht eine zweite Regel auf die Zone „Gateway“. Ohne sie antworten nur die Geräte im Netz, nicht der Router.

UniFi Policy Table: Policy-Based Route über WG-OPNsense, Firewall-Regel Allow von External 10.113.113.0/24 nach Internal und eine ICMP-Regel zur Zone Gateway
Drei Einträge machen den Standort erreichbar: die Route, die Freigabe ins interne Netz und optional Ping auf den Router.

Am anderen Standort war das bei mir schon erledigt, weil dort eine ältere, sehr offene Regel von External nach Internal existierte. Prüfe in solchen Fällen, ob die wirklich so offen sein soll. Die saubere Variante erlaubt nur das Tunnelnetz.

MTU: Tunnel im Tunnel

Balkendiagramm: Hetzner-vSwitch 1400 Byte, darin noez-WireGuard 1340 Byte, darin der Standort-Tunnel mit 1280 Byte
Jede WireGuard-Schicht kostet bei IPv4 60 Byte.

Bei mir laufen die Standort-Tunnel auf der OPNsense-Seite durch den noez-Tunnel, der wegen des Hetzner-vSwitch schon auf 1340 Byte begrenzt ist. 1340 minus 60 ergibt 1280 für den Standort-Tunnel. Das steht in der Konfigurationsdatei und im VPN-Client von UniFi. Läuft dein Tunnel über eine normale Leitung, nimm 1420. Wie man ein MTU-Problem erkennt (Ping geht, HTTPS hängt), steht ausführlich im Artikel zum Premium-Tunnel.

Testen

Test Ergebnis bei mir
Standort A → Server-LAN (Ping, HTTPS, PostgreSQL) alle VMs antworten, etwa 42 ms
Standort A → Geräte an Standort B (z. B. Home Assistant) antworten, etwa 90 ms, Weg über die OPNsense
OPNsense → Geräte an beiden Standorten antworten
Router selbst aus dem Tunnel anpingen nur mit eigener Regel auf die Zone Gateway

Die Latenz zwischen den Standorten ist die Summe beider Wege zum Rechenzentrum. Das ist der Preis des Sterns. Für Verwaltung, Home Assistant und Dateizugriffe stört das nicht. Für Sprach- oder Videotelefonie zwischen den Standorten wäre ein direkter Tunnel besser.

Tailscale parallel? Wenn du zusätzlich Tailscale mit Subnetz-Routen nutzt, prüfe, welchen Weg ein Gerät wirklich nimmt. Geräte mit aktivierten Tailscale-Routen bevorzugen für diese Netze weiterhin Tailscale. Das ist kein Fehler, kann aber bei der Fehlersuche verwirren.

Vor- und Nachteile des Sterns

Vorteile Nachteile
Standorte dürfen hinter NAT hängen Verkehr zwischen Standorten macht einen Umweg
Firewall-Regeln zentral auf der OPNsense Fällt die OPNsense aus, sind alle Standorte getrennt
Weitere Standorte: einfach einen Peer dazu UniFi maskiert, die echten Absender sind nicht sichtbar
Funktioniert mit UniFi und jedem anderen WireGuard-Gerät Policy-Based Routes müssen bei neuen Netzen gepflegt werden

Fazit

Mit dem VPN-Client von UniFi und einer OPNsense als Hub lassen sich Standorte verbinden, die mit der eingebauten Site-to-Site-Funktion nicht zusammenpassen. Die drei Stellen, an denen es bei mir gehakt hat, sind die Allowed IPs (jedes Netz nur bei einem Peer), das Source-NAT ins Server-LAN und die Pflichtzeile DNS in der UniFi-Datei. Welche UniFi-Gateways WireGuard-Clients überhaupt können und was sie sonst leisten, zeigt der UniFi Gateway Vergleich.

Häufige Fragen

Kann UniFi ein WireGuard Site-to-Site zu einer Fremd-Firewall aufbauen?

Ja, am flexibelsten über „VPN Client“ mit einer WireGuard-Konfigurationsdatei und einer Policy-Based Route. Die Gegenstelle kann jede Firewall mit WireGuard sein, etwa OPNsense oder pfSense.

Warum lehnt UniFi meine WireGuard-Datei ab?

Meist fehlt die Zeile DNS = im Abschnitt [Interface]. UniFi verlangt sie, auch wenn sie für eine reine Standortverbindung keine Rolle spielt.

Wie richte ich WireGuard Site-to-Site auf der OPNsense ein?

Eine Instanz als Server mit Tunnelnetz anlegen, pro Gegenstelle einen Peer mit deren Tunnel-IP und Netzen in den Allowed IPs, Port 51820 auf dem WAN freigeben und den Verkehr aus der WireGuard-Gruppe erlauben. Wenn die Ziele keine Rückroute kennen, kommt eine Source-NAT-Regel dazu.

Brauchen die UniFi-Router eine feste öffentliche IP?

Nein. Sie bauen die Verbindung selbst auf und halten sie mit Keepalive offen. Nur der Hub braucht eine erreichbare Adresse.

Welche MTU für WireGuard auf UniFi?

Bei einer normalen Leitung 1420. Läuft der Tunnel durch einen anderen Tunnel oder über eine Strecke mit kleinerer MTU, jeweils 60 Byte (IPv4) abziehen. Bei mir sind es 1280.

Quellen

You may also like

Hinterlasse einen Kommentar