docs: add installation instructions for UniFi Gateway BGP setup

2026-03-06 21:14:59 +00:00
parent 2f6c5b34ad
commit 389e5dc787
1 changed files with 59 additions and 0 deletions
@@ -0,0 +1,59 @@
 # 📡 UniFi Gateway BGP Setup
 Diese Sektion beschreibt die Konfiguration des **UniFi Gateways** (UDM/Pro/SE), um BGP-Peering mit dem RKE2-Cluster zu ermöglichen. Dies ist die Voraussetzung, damit Cilium LoadBalancer-IPs (VIPs) direkt im Heimnetzwerk ankündigen kann.
 ## ⚙️ 1. FRR Konfiguration (bgp.conf)
 Auf dem UniFi Gateway nutzen wir **FRR (Free Range Routing)**. Die Konfiguration in `bgp.conf` definiert das Gateway als BGP-Peer.
 ### Wichtige Parameter:
 - **Router ASN:** `65100` (Das UniFi Gateway) 🏛️
 - **Router ID:** `192.168.1.1` (Die LAN-IP des Gateways)
 - **Peer Group:** `RKE2`
 - **Remote ASN:** `65200` (Der RKE2 Cluster) ⚓
 - **Neighbor:** `192.168.1.238` (Die IP des ASUS-Nodes)
 ### Beispiel-Konfiguration:
 ```frr
 router bgp 65100
 bgp router-id 192.168.1.1
 neighbor RKE2 peer-group
 neighbor RKE2 remote-as 65200
 neighbor 192.168.1.238 peer-group RKE2
 !
 address-family ipv4 unicast
  neighbor RKE2 activate
  neighbor RKE2 next-hop-self
  redistribute connected
 exit-address-family
 ```
 ---
 ## 🛠️ 2. Aktivierung auf dem UniFi Gateway
 Da UniFi BGP nicht nativ über das Web-UI für alle Anwendungsfälle unterstützt (je nach Firmware-Stand), erfolgt die Einrichtung oft über die Shell oder spezielle Tools wie `udm-utilities`.
 1.  **SSH Zugriff:** Verbinde dich via SSH auf dein UniFi Gateway.
 2.  **BGP aktivieren:** Stelle sicher, dass der FRR-Dienst läuft.
 3.  **Konfiguration anwenden:** Die Werte aus `bgp.conf` müssen in die laufende FRR-Konfiguration übernommen werden (meist via `vtysh`).
 ---
 ## 🔍 3. Verifizierung
 Nachdem sowohl das UniFi Gateway als auch Cilium im Cluster konfiguriert sind, kann der Status geprüft werden:
 - **Auf dem Gateway:**
  ```bash
  vtysh -c "show ip bgp summary"
  ```
  Der Status sollte `Established` zeigen. ✅
 - **Im Cluster:**
  ```bash
  cilium bgp peers
  ```
 ---
 *Zuletzt aktualisiert am 06. März 2026 von Gemini CLI*