WireGuard Peer hinzufügen: im laufenden Betrieb, ohne den Tunnel neu zu starten

Einen WireGuard-Peer hinzuzufügen erfordert keinen Neustart. wg set übernimmt einen neuen Peer sofort in eine laufende Schnittstelle, während wg-quick down/up jede bestehende Sitzung abwirft. Der Befehl, was in AllowedIPs gehört, wie er einen Neustart übersteht, und warum der neue Peer meist trotzdem nicht verbindet.

Von Eric GerardGründer · VPNSmith - Spezialist für selbstgehostete VPNs & DSGVO-VPS

Aktualisiert 9 Min. Lesezeit9 min

Affiliate-Links: ggf. Provision, ohne Mehrkosten für Sie. Methode

Meine Config erstellenZur Anleitung

fig. 01 / self-host-vpnencrypted tunnelUDP 51820DEVICE10.8.0.2SERVER10.8.0.1INTERNETNATAllowedIPs = 0.0.0.0/0, ::/0ListenPort = 51820 (server)
fig. 01 / self-host-vpn

Die meisten Anleitungen beantworten „wie füge ich einen WireGuard-Peer hinzu?" mit wg-quick down wg0 && wg-quick up wg0. Das funktioniert, und trennt zugleich alle, die den Tunnel gerade benutzen, um eine einzige Zeile in eine Datei zu schreiben. Auf einem Server mit einer Handvoll Clients ist das ein kurzes Ärgernis. Auf einem Server, auf den Sie sich wirklich verlassen, ist es der Grund, warum Leute das Hinzufügen von Peers ganz vermeiden.

fig. 01 / self-host-vpnencrypted tunnelUDP 51820DEVICE10.8.0.2SERVER10.8.0.1INTERNETNATAllowedIPs = 0.0.0.0/0, ::/0ListenPort = 51820 (server)
fig. 01 / self-host-vpn

Es gibt einen Befehl, der es im laufenden Betrieb erledigt.

Wie fügt man einen Peer zu WireGuard hinzu?

Eine Zeile, auf der laufenden Schnittstelle:

wg set wg0 peer <CLIENT_PUBLIC_KEY> allowed-ips 10.0.0.5/32

Der Peer existiert ab diesem Moment. Kein Neustart, keine abgebrochenen Handshakes, keine Unterbrechung für irgendjemanden, der bereits verbunden ist. wg set spricht direkt mit dem Kernel-Modul und bearbeitet die Live-Konfiguration der Schnittstelle.

Prüfen, ob es angekommen ist:

wg show wg0

Der neue öffentliche Schlüssel taucht in der Liste auf, noch ohne Handshake, das ist erwartbar, der Handshake passiert, wenn der Client zum ersten Mal Verkehr sendet.

Wie sieht der vollständige Ablauf auf der Kommandozeile aus?

Auf der Client-Maschine das Schlüsselpaar erzeugen:

wg genkey | tee client.key | wg pubkey > client.pub

client.key ist der private Schlüssel und verlässt diese Maschine nie. client.pub ist das, was der Server braucht.

Auf dem Server:

wg set wg0 peer "$(cat client.pub)" allowed-ips 10.0.0.5/32

Zurück auf dem Client braucht die Konfigurationsdatei den öffentlichen Schlüssel des Servers, dessen Endpunkt und die gerade vergebene Adresse:

[Interface]
PrivateKey = <Inhalt von client.key>
Address = 10.0.0.5/32

[Peer]
PublicKey = <SERVER_PUBLIC_KEY>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25

Die beiden Schlüssel sind der Schritt, den man falsch macht: Jede Seite hält den öffentlichen Schlüssel der anderen Seite, nie den eigenen.

Ist der neue Client ein Telefon oder eine Maschine ohne installiertes wg, lässt sich seine Seite auch ohne Terminal erzeugen. Stellen Sie unseren kostenlosen WireGuard-Konfigurationsgenerator auf einen Client sowie Endpunkt und Subnetz Ihres Servers ein: Er erzeugt das Schlüsselpaar im Browser und liefert die Client-Datei, deren QR-Code und den passenden [Peer]-Block für den Server. Zwei Dinge sind vor dem Einsatz zu prüfen. Der Generator erfindet ein eigenes Server-Schlüsselpaar, ersetzen Sie also PublicKey im [Peer]-Block des Clients durch Ihren echten Schlüssel aus wg show wg0 public-key. Und er vergibt dem ersten Client die Adresse .2 des Subnetzes, ändern Sie also Address (und die allowed-ips, die Sie wg set übergeben), falls diese schon belegt ist. Der private Schlüssel des Clients und der öffentliche Schlüssel, den Sie dem Server geben, sind so, wie sie sind, einsatzbereit. Der Generator ist kostenlos und ohne Konto, bis 250 Geräte, und sein ZIP-Export enthält jede Client-.conf mit ihrem QR-Code als PNG, praktisch, um ein ganzes Büro oder eine Familie auf einmal auszustatten.

Erzeugen Sie Ihre WireGuard-Konfigurationen hier

Serveradresse eingeben, Anzahl der Geräte wählen, dann jeden QR-Code in der App scannen.

Alle Schlüssel werden in deinem Browser erzeugt (Curve25519 / X25519). Nichts wird an unsere Server gesendet - deine Konfiguration bleibt zu 100 % privat.

Öffentliche IPv4 oder Domain des Rechners, auf dem WireGuard läuft. Noch kein Server? Leer lassen und später eintragen.

Kostenlos, ohne Konto: bis zu 250 Clients, jede .conf mit QR-Code, und ein ZIP mit allen Dateien.

Alles, was das Gerät ins Internet sendet, läuft über Ihren Server.

Erweiterte EinstellungenTunnel-Subnetz, DNS, Site-to-Site-Netze. Die Standardwerte passen für die meisten Setups.

Optional. Gib das LAN-Subnetz hinter dem Server und/oder hinter einem Client an, der als Standort-Gateway dient (ein Router, ein Raspberry Pi, ein NAS). Der Generator trägt jedes LAN in die AllowedIPs des Servers ein, gibt jedem Peer die Routen zu den anderen LANs und schreibt die Forwarding-Regeln auf die Gateways. Lass ein Feld leer für einen normalen Client.

Was du herunterlädst

  • wg0.conf

    für den Server

  • client1.conf

    eine pro Gerät

  • QR (Beispiel)

    für die Handy-App

Nur zur Veranschaulichung: Zeilen und QR-Code sind erfunden, kein echter Schlüssel. Deine echten Dateien entstehen beim Klick in deinem Browser.

Was gehört in AllowedIPs, wenn man einen Peer hinzufügt?

Es hängt davon ab, auf welcher Seite Sie stehen, und diese Asymmetrie ist die Quelle der meisten Verwirrung.

Auf dem Server, für diesen PeerAuf dem Client, für den Server
Bedeutungwelche Adresse diesem Client gehörtwelcher Verkehr durch den Tunnel geht
Typischer Wert10.0.0.5/32, eine Adresse0.0.0.0/0 (alles) oder das LAN-Subnetz (Split Tunnel)
Darf sie sich mit einem anderen Peer überschneiden?Neinnicht zutreffend
Wirkung bei FehlerPakete gehen an den falschen Peer oder werden verworfenVerkehr umgeht den Tunnel, oder der Tunnel schluckt Ihr LAN

Die Regel gegen Überschneidungen ist strukturell, nicht kosmetisch. AllowedIPs sagt WireGuard, welchem Peer ein bestimmtes Ziel gehört, eine auf zwei Peers aufgeführte Adresse macht diese Entscheidung mehrdeutig, und das praktische Symptom ist, dass das Hinzufügen eines Clients den vorherigen stillschweigend offline nimmt.

Auf der Client-Seite ist der volle Tunnel 0.0.0.0/0 einfach, "alles außer meinem LAN" dagegen nicht, denn AllowedIPs kennt keine Ausschluss-Syntax. Unser kostenloser AllowedIPs-Rechner macht aus "alles außer X" die kürzeste Liste von IPv4- und IPv6-Bereichen für den [Peer]-Block des neuen Clients. Wenn Sie über die eine /32 hinausgehen wollen, ist AllowedIPs im Detail erklärt der Ort, an dem die Routing-Seite auseinandergenommen wird.

Wie übersteht der neue Peer einen Neustart?

wg set ändert die laufende Schnittstelle. Es fasst /etc/wireguard/wg0.conf nicht an, ein Neustart vergisst es also. Zwei Wege, es dauerhaft zu machen:

Den Block von Hand in die Datei eintragen:

[Peer]
PublicKey = <CLIENT_PUBLIC_KEY>
AllowedIPs = 10.0.0.5/32

Schreiben Sie den Live-Zustand nicht mit wg showconf wg0 > /etc/wireguard/wg0.conf zurück, auch wenn diese Abkürzung weit verbreitet ist. wg showconf kennt nur, was der Kernel kennt: den privaten Schlüssel, den Listen-Port und die Peers. Die wg-quick-Zeilen fehlen, also Address, DNS, MTU, PostUp, PostDown. Überschreiben Sie die Datei damit, startet das nächste wg-quick up die Schnittstelle wg0 ohne Tunneladresse und ohne NAT-Regeln: Jeder Client bekommt einen Handshake, aber nichts wird geroutet.

Wenn der laufende Zustand automatisch gesichert werden soll, setzen Sie SaveConfig = true in [Interface]. wg-quick schreibt die Peers dann beim Herunterfahren der Schnittstelle zurück und behält seine eigenen Zeilen. Der Haken: Es schreibt in diesem Moment die ganze Datei neu, ein Kommentar oder eine Handänderung bei laufendem Tunnel geht also verloren. Wählen Sie eine Methode, handgepflegte Datei oder SaveConfig, nicht beide.

Um eine bearbeitete Datei neu zu laden, ohne Sitzungen abzuwerfen:

wg syncconf wg0 <(wg-quick strip wg0)

syncconf wendet die Unterschiede an. wg-quick down/up tut das nicht: es baut die Schnittstelle von Grund auf neu, also genau das, was Sie vermeiden wollten.

Wie skriptet man das Hinzufügen von Peers unter Linux?

Die Abfolge hat keinen interaktiven Schritt und lässt sich deshalb direkt skripten:

#!/usr/bin/env bash
set -euo pipefail
NAME="$1"; IP="$2"          # ./addpeer.sh laptop 10.0.0.7
umask 077
wg genkey | tee "$NAME.key" | wg pubkey > "$NAME.pub"
wg set wg0 peer "$(cat "$NAME.pub")" allowed-ips "$IP/32"
printf '\n[Peer]\n# %s\nPublicKey = %s\nAllowedIPs = %s/32\n' \
  "$NAME" "$(cat "$NAME.pub")" "$IP" >> /etc/wireguard/wg0.conf
echo "added $NAME at $IP"

umask 077 ist wichtig: Ohne die Zeile ist der frisch geschriebene private Schlüssel für jedes Konto auf der Maschine lesbar. set -euo pipefail ebenso, ohne sie hinterlässt ein fehlgeschlagenes wg set trotzdem Schlüsseldateien und eine fröhliche Erfolgsmeldung. Die printf-Zeile hängt den Peer an die Datei an, statt sie neu zu schreiben, aus dem im vorigen Abschnitt genannten Grund.

Eine vollständigere Fassung dieses Skripts gibt es kostenlos auf GitHub: wg-newpeer.sh erzeugt zusätzlich einen Preshared Key, schreibt die Client-.conf nach ./clients/, übernimmt die Änderung mit wg syncconf und zeigt einen QR-Code an, wenn qrencode installiert ist. Es liegt auch unserem kostenpflichtigen WireGuard Self-Hosting Kit bei (9 USD, auf Englisch), zusammen mit Server- und Client-Vorlagen, der Checkliste mit 12 Fehlerursachen und der Härtungs-Checkliste.

Die Hand eines IT-Technikers auf einer Tastatur an einem weißen Tisch in einem Serverraum, der alte quadratische Monitor vollständig dunkel, dahinter blaues Licht und Racks mit gelben und weißen Patchkabeln
Die Hand eines IT-Technikers auf einer Tastatur an einem weißen Tisch in einem Serverraum, der alte quadratische Monitor vollständig dunkel, dahinter blaues Licht und Racks mit gelben und weißen Patchkabeln

Eine Hand ruht auf der Tastatur, während der Monitor schwarz bleibt, einen Peer mit wg set hinzuzufügen erzeugt überhaupt keine sichtbare Bestätigung, weshalb wg show das Einzige ist, was Ihnen sagt, dass es funktioniert hat.

Warum verbindet sich der neue Peer nicht?

Der Befehl lief durch und nichts passiert. In der Praxis ist es fast immer eines von vier Dingen, und alle vier lassen sich prüfen statt raten.

  1. Die Schlüssel sind vertauscht. Der Server hält den öffentlichen Schlüssel des Clients, der Client den des Servers. Einen privaten Schlüssel dorthin zu schreiben, wo ein öffentlicher hingehört, scheitert lautlos.
  2. Der Client sitzt hinter NAT ohne PersistentKeepalive. Der Server hat keinen Rückweg, bis der Client zuerst spricht, und die NAT-Zuordnung läuft in der Zwischenzeit ab. PersistentKeepalive = 25 auf der Client-Seite hält sie offen, warum 25 Sekunden und was der Wert kostet ist eine eigene Frage.
  3. Die Adresse ist bereits vergeben. Zwei Peers mit denselben AllowedIPs sind der Fall, der am rätselhaftesten aussieht, weil ausgerechnet der ältere Peer kaputtgeht.
  4. Der UDP-Port des Servers ist von außen nicht erreichbar. Bestehende Peers im LAN funktionieren weiter, der Server wirkt also gesund, aber ein neuer Peer im Mobilfunknetz bekommt nie einen Handshake. Unser kostenloser WireGuard-Port-Checker zeigt, ob Ihr Router den Port überhaupt weiterleiten kann (er erkennt CGNAT und doppeltes NAT), und liefert die Firewall-Regel für Ihr System. Lautet die Antwort CGNAT, hilft keine Portweiterleitung: Der übliche Ausweg ist ein Server auf einem VPS mit eigener öffentlicher IPv4, etwa ein Contabo Cloud VPS (Affiliate-Link), auf dem Sie Ihre Peers anlegen. Lieber ein US-Anbieter mit 30 Tagen Geld-zurück-Garantie? Ultahost VPS Basic kostet 5,52 $ im Monat bei 24 Monaten Laufzeit (1 GB RAM, dedizierte IPv4, gelesen am 21. Oktober 2026), genug für einen WireGuard-Server mit wenigen Geräten.

Für diesen dritten Fehler existiert wg-clients-audit. Es liest einen Ordner mit Client-Konfigurationen und meldet doppelte Adressen, wiederverwendete private Schlüssel und AllowedIPs-Bereiche, die breit genug sind, um das lokale Netz zu verschlucken, die drei Fehler, die einen Tunnel erzeugen, der verbindet und sich dann seltsam verhält. Es laufen zu lassen, bevor Sie jemandem eine Konfiguration geben, ist schneller, als es hinterher zu diagnostizieren.

Beginnen Sie mit wg show wg0. Ein Peer ohne latest handshake hat nie einen abgeschlossen, was auf Schlüssel oder Erreichbarkeit deutet. Ein Peer, der einen Handshake hat, aber keine Daten trägt, deutet auf AllowedIPs. Wenn der Handshake selbst der Punkt ist, an dem es hängt, arbeitet die Handshake-Fehlerbehebung die Ursachen der Reihe nach ab.

Ein VPN ändert Ihre IP. Nicht Ihren Browser.

Ein Tunnel ersetzt die Adresse, die ein Dienst sieht. An dem, was Ihr Browser von sich aus preisgibt, ändert er nichts - Schriften, Bildschirm, Zeitzone, Grafik-Stack. Diese Kombination reicht oft aus, um Sie über Sitzungen hinweg wiederzuerkennen.

Messen Sie Ihren Browser-Fingerabdruck - passiv, ohne Fragen, ohne Konto, ohne E-Mail-Adresse.

Was man behalten sollte

wg set fügt einen Peer live hinzu; wg-quick down/up trennt alle, um dieselbe Aufgabe zu erledigen. Was Sie live hinzufügen, ist nach einem Neustart weg, sofern Sie es nicht auch in die Konfiguration schreiben, und wg showconf ist keine Konfigurationsdatei: Leiten Sie es in wg0.conf um, verlieren Sie Address und PostUp. Ein /32 pro Client, niemals überschneidend. Und wenn ein neuer Peer sich seltsam verhält, sehen Sie in wg show nach, bevor Sie irgendetwas ändern, der Unterschied zwischen „kein Handshake" und „Handshake, aber kein Verkehr" sagt Ihnen, welche Hälfte des Aufbaus Sie sich ansehen müssen.

Affiliate-Link

Preis geprüft am 17.10.2026, Laufzeit 24 Monate

Häufig gestellte Fragen

Wie fügt man einen Peer zu WireGuard hinzu, ohne neu zu starten?
Mit wg set auf der laufenden Schnittstelle: wg set wg0 peer <PUBLIC_KEY> allowed-ips 10.0.0.5/32. Der Peer ist sofort aktiv, und keine bestehende Sitzung wird unterbrochen. Ein Neustart mit wg-quick down wg0 && wg-quick up wg0 funktioniert ebenfalls, reißt aber jeden laufenden Tunnel ab, um eine einzige Zeile hinzuzufügen - weshalb das nicht die Standardmethode sein sollte.
Übersteht wg set einen Neustart?
Nein. wg set ändert den laufenden Kernel-Zustand, nicht die Datei. Nichts, was Sie auf diesem Weg hinzufügen, steht in /etc/wireguard/wg0.conf, ein Neustart verliert es also. Tragen Sie den [Peer]-Block zusätzlich in die Datei ein, oder setzen Sie SaveConfig = true, damit wg-quick die Peers beim Herunterfahren zurückschreibt. Leiten Sie wg showconf wg0 nicht in die Datei um: Dort fehlen Address, DNS und PostUp, das nächste wg-quick up startet also ohne Tunneladresse und ohne NAT-Regeln.
Was gehört bei einem neuen Peer in AllowedIPs?
Auf dem Server eine Adresse pro Client, als /32 - zum Beispiel 10.0.0.5/32. Sie darf sich nicht mit einem anderen Peer überschneiden, denn AllowedIPs entscheidet, an welchen Peer ein Paket geht; eine zweimal aufgeführte Adresse macht diese Wahl mehrdeutig. Auf dem Client beschreibt AllowedIPs, was durch den Tunnel gehen soll: 0.0.0.0/0 für alles, oder nur das Server-Subnetz für Split Tunneling.
Warum verbindet sich mein neuer WireGuard-Peer nicht?
Drei Ursachen decken das meiste ab. Der Client benutzt den falschen öffentlichen Schlüssel - der Server braucht den des Clients und der Client den des Servers, und beide werden leicht vertauscht. Der Client sitzt hinter NAT ohne PersistentKeepalive, sodass der Server keinen Rückweg hat. Oder die vergebene Adresse gehört bereits einem anderen Peer, worauf meist der ältere aufhört zu funktionieren, sobald der neue verbindet.
Wie fügt man unter Linux einen Peer über die Kommandozeile hinzu?
Erzeugen Sie das Schlüsselpaar mit wg genkey | tee client.key | wg pubkey > client.pub und führen Sie dann auf dem Server wg set wg0 peer $(cat client.pub) allowed-ips 10.0.0.5/32 aus. Prüfen Sie das Ergebnis mit wg show wg0. Die gesamte Abfolge lässt sich sauber skripten, was der übliche Weg ist, um mehrere Clients auf einmal anzulegen.