Zum Inhalt springen

Netbird Port Forwarding Guide

26. März 2026 durch
Netbird Port Forwarding Guide
Nathalie Schoenwetter


3D-Drucker von überall steuern – So richtest du IP Forwarding für NetBird ein

Für wen ist dieser Guide? Maker, die ihre 3D-Drucker (Klipper, Mainsail, Fluidd, PrusaLink) über NetBird von überall erreichbar machen wollen – ohne einen einzigen Port im Router zu öffnen.


Was ist IP Forwarding und warum brauchst du es?

NetBird verbindet deine Geräte über verschlüsselte WireGuard-Tunnel. Wenn du aber nicht nur auf ein einzelnes Gerät (z.B. deinen Raspberry Pi) zugreifen willst, sondern auf alle Geräte im Netzwerk dahinter (z.B. deine 3D-Drucker), muss der Raspberry Pi als Router fungieren – er muss Pakete aus dem NetBird-Tunnel in dein lokales Netzwerk weiterleiten.

Das nennt sich IP Forwarding – und es ist standardmäßig deaktiviert.


Voraussetzungen

  • Raspberry Pi mit Raspberry Pi OS (oder Ubuntu) im Netzwerk
  • NetBird installiert und verbunden
  • SSH-Zugang zum Raspberry Pi oder Home Assistant Terminal Add-on


Schritt 1 – IP Forwarding prüfen

Verbinde dich per SSH auf deinen Raspberry Pi:

ssh pi@<IP-des-Raspberry-Pi>

Dann prüfen ob IP Forwarding aktiv ist:

cat /proc/sys/net/ipv4/ip_forward
  • Ausgabe 0 → deaktiviert (Standardzustand)
  • Ausgabe 1 → bereits aktiv ✅


Schritt 2 – IP Forwarding aktivieren

Sofort aktivieren (bis zum nächsten Neustart):

sudo sysctl -w net.ipv4.ip_forward=1

Dauerhaft persistieren (bleibt nach Neustart aktiv):

echo 'net.ipv4.ip_forward=1' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Nochmal prüfen:

cat /proc/sys/net/ipv4/ip_forward
# Muss jetzt "1" ausgeben


Schritt 3 – NetBird Network Route einrichten

Im NetBird Dashboard:

  1. Gehe zu Network Routes
  2. Klicke auf Add Route
  3. Trage folgendes ein:
    • Prefix: 192.168.x.0/24 (dein lokales Netzwerk, z.B. 192.168.178.0/24)
    • Routing Peer: Raspberry Pi (aus der Peer-Liste auswählen)
    • Distributionsgruppe: die Gruppe in der dein Laptop/Client ist (z.B. Clients)
  4. Speichern

Wichtig: /24 bedeutet das gesamte Subnetz – damit sind automatisch alle Geräte erreichbar, also auch alle 3D-Drucker, NAS, etc.


Schritt 4 – Route auf dem Client aktivieren

Auf deinem Laptop/PC:

  1. Öffne die NetBird App
  2. Gehe zu Networks oder Routes
  3. Stelle sicher dass die Route 192.168.x.0/24 aktiv (Toggle ON) ist


Schritt 5 – Testen

Öffne ein Terminal auf deinem Laptop und teste:

# Ping zum Drucker
ping 192.168.178.71

# Traceroute um den Weg zu sehen
traceroute 192.168.178.71

Danach direkt im Browser aufrufen:

http://192.168.178.71

Das Webinterface deines 3D-Druckers (Mainsail, Fluidd, PrusaLink) sollte jetzt erscheinen. ✅


Bonus: iMac / macOS als Routing Peer

Falls du einen Mac als Routing Peer verwenden möchtest (statt Raspberry Pi):

Sofort aktivieren:

sudo sysctl -w net.inet.ip.forwarding=1

Dauerhaft persistieren:

echo "net.inet.ip.forwarding=1" | sudo tee -a /etc/sysctl.conf


Häufige Fehler

Problem Ursache Lösung
Ping Timeout IP Forwarding nicht aktiv Schritt 2 wiederholen
Route nicht sichtbar Distributionsgruppe falsch Gruppe im NetBird Dashboard prüfen
Route sichtbar aber kein Zugriff Toggle in NetBird App aus Route in App aktivieren
SSH Connection Refused SSH auf Pi nicht aktiviert sudo systemctl enable ssh && sudo systemctl start ssh


Zusammenfassung

Mit diesen drei Schritten erreichst du alle Geräte in deinem Netzwerk über NetBird:

  1. IP Forwarding auf dem Raspberry Pi aktivieren und persistieren
  2. Network Route im NetBird Dashboard anlegen (/24 Subnetz)
  3. Route in der NetBird App auf dem Client aktivieren

Kein Port Forwarding, kein offener Router, keine Cloud. 🔒

Dieser Guide ist Teil der Videoserie über Zero-Trust-Networking für Maker.