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.
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 Peer | Auf dem Client, für den Server | |
|---|---|---|
| Bedeutung | welche Adresse diesem Client gehört | welcher Verkehr durch den Tunnel geht |
| Typischer Wert | 10.0.0.5/32, eine Adresse | 0.0.0.0/0 (alles) oder das LAN-Subnetz (Split Tunnel) |
| Darf sie sich mit einem anderen Peer überschneiden? | Nein | nicht zutreffend |
| Wirkung bei Fehler | Pakete gehen an den falschen Peer oder werden verworfen | Verkehr 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.

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.
- 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.
- 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 = 25auf der Client-Seite hält sie offen, warum 25 Sekunden und was der Wert kostet ist eine eigene Frage. - Die Adresse ist bereits vergeben. Zwei Peers mit denselben
AllowedIPssind der Fall, der am rätselhaftesten aussieht, weil ausgerechnet der ältere Peer kaputtgeht. - 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
★ Nürnberger DSGVO-Rechenzentrum · ✓ Dedizierte IPv4 inklusive · 200-Mbit/s-Port
Hoste dein VPN auf deinem eigenen VPS → ContaboCloud VPS 4 · 5,50 €/Mon. · Karte oder PayPal · Bestellungen auch von außerhalb der EU→Preis geprüft am 17.10.2026, Laufzeit 24 Monate


