Typ: Client-Installation | Dauer: ~10 Min | Voraussetzung: unRAID mit Docker, NetBird Server erreichbar
Einrichtung des NetBird-Clients auf unRAID als Docker-Container. Der Client kann als Gateway für das Home-Netzwerk fungieren, sodass alle Home-Geräte über NetBird erreichbar sind.
Im NetBird Dashboard (https://netbird.luckynuc.de):
| Feld | Wert |
|---|---|
| Name | unRAID |
| Reusable | Aus (einmalig) |
| Expires | 7 Tage |
| Ephemeral Peers | ❌ AUS! |
| Auto-assigned groups | Optional: Home |
⚠️ Ephemeral Peers AUS lassen! Sonst wird unRAID nach 10 Minuten Offline automatisch aus dem Dashboard gelöscht.
| Einstellung | Wert |
|---|---|
| Name | NetBird-Client |
| Netzwerktyp | Host ⚠️ Pflicht! |
| Management URL | https://netbird.luckynuc.de |
| Admin Portal URL | https://netbird.luckynuc.de |
| Setup Key | <dein-setup-key> |
| Extra Parameter | --cap-add=NET_ADMIN --cap-add=SYS_ADMIN |
⚠️ Netzwerktyp MUSS Host sein — sonst funktioniert das Routing nicht!
Anwenden klicken und warten.
# Im unRAID Terminal prüfen
cat /proc/sys/net/ipv4/ip_forward
# Falls 0, aktivieren
echo 1 > /proc/sys/net/ipv4/ip_forward
Für Persistenz nach Neustart in /boot/config/go einfügen (vor emhttp):
#!/bin/bash
# IP Forwarding für NetBird
echo 1 > /proc/sys/net/ipv4/ip_forward
# Start the Management Utility
/usr/local/sbin/emhttp
docker exec -it NetBird-Client netbird status
Erwartete Ausgabe:
Management: Connected
Signal: Connected
NetBird IP: 10.200.x.x/16
Peers count: X/X Connected
Falls unRAID als Gateway für das Home-Netzwerk dienen soll:
Im NetBird Dashboard → Network Routes → Add Route:
| Feld | Wert |
|---|---|
| Network Range | Dein Home-Subnetz |
| Routing Peer | unraid |
| Distribution Groups | Admin ⚠️ Nicht All! |
| Name | Home-LAN |
| Enable Route | ✅ |
| Masquerade | ✅ |
⚠️ Distribution Groups auf Admin setzen! Verhindert, dass Hetzner-VMs auf Home-Geräte zugreifen.
# Status
docker exec -it NetBird-Client netbird status
# Detaillierter Status
docker exec -it NetBird-Client netbird status -d
# Neu verbinden
docker exec -it NetBird-Client netbird down
docker exec -it NetBird-Client netbird up
# Logs
docker logs -f NetBird-Client
sysctl "net.ipv4.ip_forward" not allowed in host network namespace
Lösung: IP-Forwarding auf dem Host aktivieren. --sysctl net.ipv4.ip_forward=1 aus Extra-Parametern entfernen.
Stand: Januar 2026 — In WikiJS erstellt: 2026-03-22 (NanoClaw, aus wiki-entwurf)