WireGuard-VPN-Server auf einem Linux-VPS installieren

Linux 20 Min. Lesezeit

WireGuard ist ein einfach einzurichtendes VPN: Es baut zwischen zwei oder mehr Rechnern einen verschlüsselten Tunnel auf, durch den der gesamte Netzwerkverkehr laufen kann. Mit einem WireGuard-Server auf Ihrem eigenen KVM-VPS surfen Sie auch in öffentlichen WLANs (im Café, im Hotel, am Flughafen) verschlüsselt, und gegenüber Websites treten Sie mit der IP-Adresse des VPS auf. Dieser Artikel zeigt die Installation des Servers, das Hinzufügen von Clients, die Überprüfung und häufige Fehler.

Wir haben die Schritte im November 2026 unter Ubuntu 24.04, Debian 13.7, AlmaLinux 9.9 und AlmaLinux 10.3 als Server getestet, als Client diente ein Rechner mit Ubuntu 26.04; beim vollständigen Tunnel haben wir auf dem Server zusätzlich mit tcpdump geprüft, dass der Verkehr des Clients tatsächlich über den VPS ins Internet geht. Unter Rocky Linux sind die Schritte dieselben wie unter AlmaLinux, dort haben wir sie jedoch nicht getestet. Wenn Sie sich für die allgemeine Funktionsweise eines VPN, den Vergleich von OpenVPN und WireGuard oder die Variante auf dem Router zu Hause interessieren, lesen Sie den Beitrag Eigenen VPN-Server für den Fernzugriff einrichten.

Wozu ein eigener VPN-Server auf dem VPS?

  • Sicher surfen in fremden Netzen. Ihr gesamter Verkehr läuft verschlüsselt bis zum VPS, sodass weder der Betreiber des öffentlichen WLANs noch andere Nutzer sehen, welche Seiten Sie aufrufen, und niemand in den Verkehr eingreifen kann. Websites sehen die IP-Adresse des VPS.
  • Zugriff auf interne Dienste ohne öffentlichen Port. Eine Admin-Oberfläche, eine Datenbank oder eine Monitoring-Seite kann nur auf der VPN-Adresse lauschen (im Beispiel 10.8.0.1) und ist dann aus dem Internet überhaupt nicht erreichbar, von Ihren eigenen Geräten aus aber schon.
  • Mehrere Rechner verbinden. Ihr Laptop, Ihr Telefon und Ihre anderen Server kommen in ein gemeinsames, verschlüsseltes internes Netz und erreichen einander über den VPS.

Wenn Sie nur den Verkehr des Browsers über den Server leiten oder eine einzelne, auf dem Server laufende Weboberfläche öffnen möchten, genügt oft auch SSH, ganz ohne Installation. Ein SSH-SOCKS-Proxy ist jedoch kein VPN: Ihn nutzen nur die Programme, in denen Sie ihn einstellen (in der Regel der Browser), und er überträgt nur TCP-Verbindungen. WireGuard legt auf dem Rechner eine Netzwerkschnittstelle an, sodass der Verkehr aller Programme und Protokolle (auch UDP, DNS und ping) darüber laufen kann, auch auf dem Telefon, und die Verbindung stellt sich nach einem Netzwechsel von selbst wieder her.

WireGuard in Kürze

WireGuard ist seit März 2020, seit Version 5.6, Teil des Linux-Kernels, daher muss auf aktuellen Distributionen kein eigenes Kernelmodul kompiliert oder installiert werden: Es genügt, die Userspace-Werkzeuge, also das Paket wireguard-tools (mit den Befehlen wg und wg-quick), zu installieren. WireGuard überträgt die verschlüsselten IP-Pakete über UDP. In den Beispielen der offiziellen Dokumentation steht der UDP-Port 51820, und meist wird dieser verwendet, doch das ist nur eine Gewohnheit, kein verbindlicher Standardwert: Den Port legt die Zeile ListenPort der Konfiguration fest, und fehlt sie, wählt wg einen zufälligen Port. Die Rechner (im Sprachgebrauch von WireGuard Peers) authentifizieren sich gegenseitig mit Curve25519-Schlüsselpaaren: Jeder hat einen geheimen, privaten Schlüssel, und die anderen erkennen ihn an seinem öffentlichen Schlüssel, ähnlich wie bei der Anmeldung per SSH-Schlüssel. Benutzernamen, Passwörter oder Zertifikate gibt es nicht.

In Red Hat Enterprise Linux 9 und 10 ist WireGuard eine „Technology Preview“, Red Hat bietet dafür also keinen Produktsupport; auch die Versionshinweise von RHEL 10.2 führen es so auf, nicht als veraltet (deprecated). Der AlmaLinux-Kernel gibt das beim Laden des Moduls auch aus (sudo dmesg):

wireguard: WireGuard 1.0.0 loaded. See www.wireguard.com for information.
TECH PREVIEW: WireGuard may not be fully supported.

Unter AlmaLinux 9 und 10 ist das Modul dennoch im Standardkernel enthalten und das Paket wireguard-tools im Standard-Repository AppStream; im Test funktionierte es auf beiden Systemen fehlerfrei, auch mit SELinux im Modus Enforcing.

Was wird dafür benötigt?

  • Ein Linux-VPS mit root- oder sudo-Rechten und SSH-Zugang dazu (siehe: Wie stelle ich über SSH eine Verbindung zu meinem VPS her?).
  • Die öffentliche IP-Adresse des VPS (in den Beispielen 203.0.113.25).
  • Ein eigener interner Adressbereich für das VPN, der sich nicht mit Ihrem Heim- oder Büronetz überschneidet. Das Beispiel verwendet den Bereich 10.8.0.0/24: Der Server erhält die Adresse 10.8.0.1, der Laptop 10.8.0.2, das Telefon 10.8.0.3.

WireGuard läuft im Kernel, ohne eigenen Hintergrundprozess (wg-quick richtet nur die Schnittstelle ein und beendet sich dann), daher genügt auch ein kleiner VPS; im Test dienten virtuelle Maschinen mit 1 GB Arbeitsspeicher als Server. Bei hohem Datenaufkommen benötigt die Verschlüsselung Prozessorzeit.

1. wireguard-tools installieren

Unter Ubuntu und Debian (nftables wird für das NAT benötigt, siehe unten; im Cloud-Image von Debian 13 war es nicht installiert, unter Ubuntu 24.04 schon):

sudo apt update
sudo apt install wireguard-tools nftables

Unter AlmaLinux 9 und 10 sowie unter Rocky Linux:

sudo dnf install wireguard-tools

Im Test wurde unter Ubuntu 24.04, Debian 13 und AlmaLinux 9 die Version 1.0.20210914 von wireguard-tools installiert, unter AlmaLinux 10 und Ubuntu 26.04 die Version 1.0.20250521. Das Kernelmodul muss nicht eigens geladen werden, wg-quick lädt es beim ersten Start.

2. Das Schlüsselpaar des Servers

Die Schlüssel kommen in das Verzeichnis /etc/wireguard, das nur root lesen kann. umask 077 sorgt dafür, dass auch die neu angelegten Dateien nur für root lesbar sind:

sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/server.key | wg pubkey > /etc/wireguard/server.pub'
sudo cat /etc/wireguard/server.pub

wg genkey erzeugt den privaten Schlüssel, wg pubkey berechnet daraus den öffentlichen. Der ausgegebene öffentliche Schlüssel (ein 44 Zeichen langer Text, der auf = endet) kommt später in die Konfiguration der Clients. Geben Sie den Inhalt von server.key niemals weiter und kopieren Sie ihn nicht an einen öffentlichen Ort.

3. Die Konfiguration des Servers

Prüfen Sie zuerst, über welche Netzwerkschnittstelle der Server ins Internet geht:

ip route show default
default via 203.0.113.1 dev eth0 proto static

Der Name nach dev (hier eth0; im Test war es unter Ubuntu und Debian enp0s1, unter AlmaLinux eth0) wird für die NAT-Regel benötigt. Legen Sie danach die Datei /etc/wireguard/wg0.conf an, ebenfalls mit Rechten, die nur root das Lesen erlauben:

sudo sh -c 'umask 077; nano /etc/wireguard/wg0.conf'

Ubuntu und Debian

[Interface]
# Adresse des Servers im VPN
Address = 10.8.0.1/24
ListenPort = 51820
# Inhalt von /etc/wireguard/server.key
PrivateKey = <privater Schlüssel des Servers>
# NAT: Datenverkehr aus dem VPN geht mit der IP-Adresse des Servers hinaus (ersetzen Sie eth0 durch den Namen Ihrer eigenen Schnittstelle)
PostUp = nft add table ip wgnat; nft add chain ip wgnat postrouting '{ type nat hook postrouting priority srcnat; }'; nft add rule ip wgnat postrouting ip saddr 10.8.0.0/24 oifname "eth0" masquerade
PostDown = nft delete table ip wgnat

Die Zeile PostUp legt beim Start des Tunnels eine eigene nftables-Tabelle wgnat mit einer einzigen NAT-Regel (Masquerade) an, PostDown löscht sie beim Beenden. Diese Tabelle funktioniert auch neben den Regeln von ufw, und auch ufw reload löscht sie nicht.

Läuft auf dem Server auch der Dienst nftables (unter Debian ist er standardmäßig deaktiviert), löscht die erste Zeile von /etc/nftables.conf (flush ruleset) beim Neustart des Dienstes alle Tabellen, auch die Tabelle wgnat. Starten Sie in diesem Fall danach auch WireGuard neu: sudo systemctl restart wg-quick@wg0.

AlmaLinux und Rocky Linux

Hier übernimmt firewalld das NAT (siehe nächster Schritt), daher ist die Konfiguration kürzer:

[Interface]
# Adresse des Servers im VPN
Address = 10.8.0.1/24
ListenPort = 51820
# Inhalt von /etc/wireguard/server.key
PrivateKey = <privater Schlüssel des Servers>

4. IP-Weiterleitung und Firewall

Der Server muss die aus dem VPN eingehenden Pakete ins Internet weiterleiten. Aktivieren Sie das in einer eigenen sysctl-Datei, damit es auch nach einem Neustart erhalten bleibt (auf allen Systemen gleich):

echo 'net.ipv4.ip_forward = 1' | sudo tee /etc/sysctl.d/99-wireguard.conf
sudo sysctl --system

In der Ausgabe muss die Zeile * Applying /etc/sysctl.d/99-wireguard.conf ... erscheinen. Unter Debian 13 gibt es keine Datei /etc/sysctl.conf, dort ist dieses Drop-in-Verzeichnis der einzige Ort.

ufw (Ubuntu)

Wenn Sie ufw nicht verwenden, entfällt dieser Teil, die obige nftables-Regel genügt allein. Ist ufw aktiviert, sperrt es standardmäßig allen eingehenden und allen weitergeleiteten (routed) Verkehr. Geben Sie den UDP-Port von WireGuard frei sowie die Weiterleitung aus dem VPN ins Internet:

sudo ufw allow 51820/udp
sudo ufw route allow in on wg0 out on eth0

Wenn Sie ufw jetzt zum ersten Mal aktivieren, geben Sie vorher SSH frei (sudo ufw allow OpenSSH), sonst sperren Sie sich aus. Die Grundlagen zeigt der Artikel Wie richte ich eine Firewall auf meinem VPS ein?

firewalld (AlmaLinux, Rocky Linux)

sudo firewall-cmd --permanent --add-port=51820/udp
sudo firewall-cmd --permanent --add-masquerade
sudo firewall-cmd --reload

--add-masquerade setzt die Absenderadresse des Verkehrs, der über die öffentliche Zone (public) hinausgeht, auf die Adresse des Servers um. Im Test leitete firewalld (unter AlmaLinux 9 Version 1.3.4, unter AlmaLinux 10 Version 2.4.3) mit diesen beiden Regeln den Internetverkehr der VPN-Clients bereits weiter. In den AlmaLinux-Cloud-Images war firewalld nicht installiert; wenn es auch bei Ihnen fehlt, geben Sie die obigen Befehle nach sudo dnf install firewalld und sudo systemctl enable --now firewalld ein.

5. WireGuard starten

sudo systemctl enable --now wg-quick@wg0
sudo wg show

Der Dienst wg-quick@wg0 legt anhand von /etc/wireguard/wg0.conf die Schnittstelle wg0 an und startet auch beim Systemstart. wg show zeigt zu diesem Zeitpunkt nur den Server:

interface: wg0
  public key: L/UC2CKSjsekZbOeHuiMS07rEo8ugu2uYzcvKU1Yc1U=
  private key: (hidden)
  listening port: 51820

Ob der Server tatsächlich lauscht, prüfen Sie mit dem Befehl sudo ss -lunp | grep 51820 (zum Auflisten von Ports: Linux: offene Ports anzeigen mit ss, lsof und netstat). Auf allen vier Systemen startete der Tunnel auch nach einem Neustart, zusammen mit dem NAT und den Firewall-Regeln.

6. Einen Client hinzufügen

Jedes Gerät (Laptop, Telefon, anderer Server) erhält ein eigenes Schlüsselpaar und eine eigene VPN-Adresse. So können Sie ein verlorenes Telefon aussperren, ohne die anderen Geräte anzufassen.

Das Schlüsselpaar des Clients

Installieren Sie auf einem Linux-Client ebenfalls das Paket wireguard-tools und erzeugen Sie das Schlüsselpaar auf dem Client selbst, so verlässt der private Schlüssel den Rechner gar nicht erst:

sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/laptop.key | wg pubkey > /etc/wireguard/laptop.pub'
sudo cat /etc/wireguard/laptop.pub

Den Client auf dem Server eintragen

Fügen Sie auf dem Server am Ende von wg0.conf einen Abschnitt [Peer] mit dem öffentlichen Schlüssel und der VPN-Adresse des Clients hinzu:

# laptop
[Peer]
PublicKey = <öffentlicher Schlüssel des Laptops>
AllowedIPs = 10.8.0.2/32

AllowedIPs bedeutet auf der Serverseite, dass der Server von diesem Client nur Pakete mit der Absenderadresse 10.8.0.2 annimmt und Pakete an 10.8.0.2 an diesen Client schickt. Deshalb erhält jeder Client eine eigene /32-Adresse.

Um die Änderung zu übernehmen, müssen Sie den Tunnel nicht neu starten, die Verbindung bereits verbundener Clients bricht nicht ab:

sudo systemctl reload wg-quick@wg0

reload führt im Hintergrund den Befehl wg syncconf wg0 <(wg-quick strip wg0) aus: Er wendet nur den Unterschied zwischen der Datei und dem laufenden Zustand an. Mit dem Befehl sudo wg set wg0 peer <öffentlicher Schlüssel> allowed-ips 10.8.0.3/32 können Sie einen Client auch ohne Bearbeiten der Datei hinzufügen, das gilt aber nur für den laufenden Tunnel: Im Test war ein so hinzugefügter Client nach einem Neustart von WireGuard verschwunden. Tragen Sie ihn deshalb immer in die Datei wg0.conf ein.

Die Konfiguration des Clients (Linux)

Legen Sie auf dem Client die Datei /etc/wireguard/wg0.conf an (sudo sh -c 'umask 077; nano /etc/wireguard/wg0.conf'):

[Interface]
# Inhalt von /etc/wireguard/laptop.key
PrivateKey = <privater Schlüssel des Laptops>
Address = 10.8.0.2/24
# DNS-Resolver durch den Tunnel (Sie können jeden vertrauenswürdigen Resolver angeben)
DNS = 9.9.9.9

[Peer]
# öffentlicher Schlüssel des Servers (server.pub)
PublicKey = <öffentlicher Schlüssel des Servers>
# öffentliche IP-Adresse des VPS und WireGuard-Port
Endpoint = 203.0.113.25:51820
# vollständiger Tunnel: der gesamte IPv4- und IPv6-Verkehr läuft über das VPN
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

Die einzelnen Zeilen:

  • AllowedIPs legt auf der Clientseite fest, für welche Adressen der Verkehr in den Tunnel gehen soll. 0.0.0.0/0, ::/0 ist der vollständige Tunnel: Der gesamte Verkehr geht über den VPS ins Internet. Wenn Sie nur das interne Netz des VPN (den Server und die anderen Clients) erreichen möchten und Ihr Internetverkehr über Ihre eigene Verbindung laufen soll, schreiben Sie: AllowedIPs = 10.8.0.0/24. Im Test liefen dann die Adressen 10.8.0.x über wg0, alles andere über das lokale Netz.
  • DNS: Im vollständigen Tunnel soll auch die Namensauflösung durch den Tunnel laufen, sonst gehen die Anfragen an den Resolver des lokalen Netzes, außerhalb des VPN (siehe Fehlerbehebung). Für die Zeile DNS braucht der Client resolvconf; unter Ubuntu und Debian stellt es das Paket systemd-resolved bereit.
  • PersistentKeepalive = 25: Der Client sendet alle 25 Sekunden ein kleines Paket, damit zwischengeschaltete NAT-Geräte (Router zu Hause, Mobilfunkanbieter) die Verbindung nicht vergessen. Auch die WireGuard-Dokumentation empfiehlt diesen Wert; auf der Serverseite ist er nicht nötig.
  • Endpoint: Statt einer IP-Adresse kann hier auch ein Domainname stehen (zum Beispiel vpn.pelda.hu:51820), wenn ein A-Eintrag auf die Adresse des VPS zeigt.
  • Im Abschnitt [Interface] des Clients steht kein ListenPort, daher erhält er einen zufälligen Port (im Test zum Beispiel 38802).

Starten und Beenden:

sudo wg-quick up wg0
sudo wg-quick down wg0

Soll auch der Client immer verbunden sein, können Sie ihn ebenso als Dienst einrichten: sudo systemctl enable --now wg-quick@wg0.

Telefon: Konfiguration per QR-Code

Auf dem Telefon kann die offizielle WireGuard-App (Android, iOS) die Konfiguration auch aus einem QR-Code einlesen, unter Windows und macOS importiert die offizielle App die Datei .conf. In diesem Fall können Sie das Schlüsselpaar auch auf dem Server erzeugen und die fertige Konfiguration als QR-Code im Terminal anzeigen. Dafür wird das Paket qrencode benötigt: Unter Ubuntu und Debian installieren Sie es mit sudo apt install qrencode, unter AlmaLinux aus dem EPEL-Repository (sudo dnf install epel-release, dann sudo dnf install qrencode; ausführlich: Installation des EPEL-Repositorys unter AlmaLinux).

sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/telefon.key | wg pubkey > /etc/wireguard/telefon.pub'

Tragen Sie das Telefon in die Datei wg0.conf des Servers als [Peer] ein (AllowedIPs = 10.8.0.3/32), führen Sie den Befehl sudo systemctl reload wg-quick@wg0 aus und schreiben Sie dann die Konfiguration des Telefons in die Datei /etc/wireguard/telefon.conf, im gleichen Aufbau wie die des Laptops (PrivateKey ist der Inhalt von telefon.key, Address = 10.8.0.3/24). Der QR-Code:

sudo qrencode -t ansiutf8 -r /etc/wireguard/telefon.conf

Wegen der Option -r liest qrencode die Datei selbst; die Form sudo qrencode ... < Datei funktioniert nicht, da die Eingabe von Ihrem eigenen Benutzer geöffnet würde, der dafür keine Berechtigung hat. Löschen Sie nach dem Einlesen den Schlüssel und die Konfiguration des Telefons vom Server; in der Datei wg0.conf des Servers bleibt nur sein öffentlicher Schlüssel:

sudo rm /etc/wireguard/telefon.key /etc/wireguard/telefon.conf

Der QR-Code enthält den privaten Schlüssel: Fotografieren Sie ihn nicht ab und zeigen Sie ihn nicht dort an, wo andere ihn sehen können.

7. Überprüfung

Auf dem Client zeigt sudo wg show eine erfolgreiche Verbindung mit der Zeile latest handshake an:

interface: wg0
  public key: 509FXrsngphGeLkubh6MsZDTkwa3Y2md9Jj8CRBMekU=
  private key: (hidden)
  listening port: 44606
  fwmark: 0xca6c

peer: L/UC2CKSjsekZbOeHuiMS07rEo8ugu2uYzcvKU1Yc1U=
  endpoint: 203.0.113.25:51820
  allowed ips: 0.0.0.0/0, ::/0
  latest handshake: 3 seconds ago
  transfer: 52.78 KiB received, 4.95 KiB sent
  persistent keepalive: every 25 seconds

Auf dem Server zeigt sudo wg show für jeden Client, von wo er sich verbunden hat (endpoint), wann der letzte Handshake war und wie viele Daten übertragen wurden. Ein Client, der sich noch nicht verbunden hat, erscheint nur mit den Zeilen peer und allowed ips.

Im vollständigen Tunnel geht der Client über den VPS ins Internet. So prüfen Sie das auf dem Client:

ping -c 2 10.8.0.1
ip route get 1.1.1.1
curl -4 ifconfig.me
1.1.1.1 dev wg0 table 51820 src 10.8.0.2 uid 1000

In der Antwort von ip route get zeigt dev wg0, dass der Verkehr in den Tunnel geht, und curl -4 ifconfig.me gibt die IP-Adresse des VPS aus (im Beispiel 203.0.113.25), nicht die Ihrer eigenen Internetverbindung. Suchen Sie in der Ausgabe des einfachen ip route nicht nach der Standardroute über wg0: wg-quick verwendet beim vollständigen Tunnel eine eigene Routingtabelle (51820) und eigene Regeln, die ip rule anzeigt. Auf dem Server sehen Sie währenddessen mit sudo tcpdump -ni any host 1.1.1.1, wie das Paket auf wg0 von der VPN-Adresse des Clients (10.8.0.2) ankommt und auf der ausgehenden Schnittstelle bereits mit der Adresse des Servers weitergeht. Mehr über Werkzeuge zur Netzwerkdiagnose lesen Sie im Artikel Netzwerk-Fehlerbehebung: ping, traceroute, mtr, dig und curl.

Interne Dienste und Zugriff der Clients untereinander

Wenn ein Dienst auf dem Server nur auf der VPN-Adresse lauscht (zum Beispiel eine Admin-Oberfläche auf 10.8.0.1:8080) oder die Clients einander erreichen sollen, muss die Firewall auch das zulassen. Im Test funktionierte beides nicht ohne eigene Regel.

Unter Ubuntu mit ufw ein bestimmter Port aus dem VPN bzw. der Verkehr zwischen den Clients:

sudo ufw allow in on wg0 to any port 8080 proto tcp
sudo ufw route allow in on wg0 out on wg0

Achtung: ufw lässt weitergeleitete Pings standardmäßig durch, sodass ping zwischen den Clients funktionieren kann, auch wenn eine TCP-Verbindung (etwa SSH oder HTTP) noch gesperrt ist. Im Protokoll (sudo journalctl -k | grep UFW) erscheinen dann Zeilen wie [UFW BLOCK] IN=wg0 OUT=wg0.

Unter AlmaLinux ist es am einfachsten, die Schnittstelle wg0 in die vertrauenswürdige Zone (trusted) aufzunehmen:

sudo firewall-cmd --permanent --zone=trusted --add-interface=wg0
sudo firewall-cmd --reload

Damit erreichen die VPN-Clients alle Dienste des Servers und einander, und das NAT ihres Internetverkehrs funktioniert unverändert; die Einstellung blieb im Test auch nach einem Neustart erhalten. Wählen Sie das nur, wenn Sie ausschließlich eigene, vertrauenswürdige Geräte ins VPN lassen; geben Sie andernfalls statt der Zone trusted die benötigten Ports einzeln frei.

IPv6

Unsere KVM-VPS-Server erhalten standardmäßig eine IPv4- und eine IPv6-Adresse. Das Beispiel des Artikels verwendet im Tunnel nur IPv4-Adressen, trotzdem steht in der Zeile AllowedIPs des Clients ::/0, und das hat einen Grund: Ohne diesen Eintrag würde der IPv6-Verkehr des Clients in einem IPv6-fähigen Netz am Tunnel vorbei über die lokale Verbindung hinausgehen. Im Test zeigte ohne ::/0 der Befehl ip -6 route get die lokale Schnittstelle, mit dem Eintrag wg0; so gelangt der IPv6-Verkehr in den Tunnel, und da der Server ihn nicht weiterleitet, gelangt er nicht am VPN vorbei nach außen. Wenn Sie auch IPv6 durch den Tunnel leiten möchten, sind dafür IPv6-Adressen im VPN und IPv6-Weiterleitung auf dem Server nötig; das zeigen wir in diesem Artikel nicht.

Wenn Sie WireGuard auf einem VPS betreiben, der nur eine IPv6-Adresse hat, kommt in die Zeile Endpoint die IPv6-Adresse des Servers in eckigen Klammern (Endpoint = [2001:db8::25]:51820), und Sie können sich nur aus Netzen verbinden, die eine IPv6-Anbindung haben. Mehr dazu lesen Sie im Artikel IPv6-only-VPS: Vor- und Nachteile und Lösungen.

Häufige Fehler

  • Kein Handshake: In der Ausgabe von wg show auf dem Client fehlt die Zeile latest handshake, in der Zeile transfer steht 0 B received. Die häufigste Ursache ist, dass die Firewall des Servers den UDP-Port nicht zulässt: Im Test erschienen mit ufw dann Zeilen wie [UFW BLOCK] ... PROTO=UDP ... DPT=51820 im Protokoll, mit firewalld blieben die Pakete des Clients unbeantwortet. Prüfen Sie auch, ob in der Zeile Endpoint des Clients die IP-Adresse des VPS und der zu ListenPort passende Port stehen und ob die Schlüssel nicht vertauscht sind: In die Konfiguration des Clients kommt der öffentliche Schlüssel des Servers, in die des Servers der des Clients. WireGuard antwortet nicht auf Pakete mit falschem Schlüssel und protokolliert sie auch nicht, daher ist bei einem falschen Schlüssel auf dem Server nichts zu sehen.
  • Handshake vorhanden, auch ping 10.8.0.1 funktioniert, aber kein Internet: Der Server leitet den Verkehr nicht weiter oder setzt die Adressen nicht um. Prüfen Sie, ob cat /proc/sys/net/ipv4/ip_forward den Wert 1 ausgibt und ob die NAT-Regel existiert (sudo nft list table ip wgnat bzw. in der Ausgabe von sudo firewall-cmd --list-all die Zeile masquerade: yes). Im Test verursachte ein falscher Schnittstellenname in der nftables-Regel dasselbe (eth0 statt des tatsächlichen enp0s1): Die Pakete gingen statt mit der Adresse des Servers mit der Absenderadresse 10.8.0.2 hinaus, und es kam keine Antwort darauf. Mit ufw führt auch eine fehlende route allow-Regel dazu; im Protokoll steht dann [UFW BLOCK] IN=wg0 OUT=eth0.
  • Nach einem Neustart von WireGuard auf dem Server eine Zeit lang keine Verbindung: Nach systemctl restart wg-quick@wg0 (oder einem Neustart des Servers) verbinden sich die Clients von selbst wieder, aber nicht sofort; im Test dauerte das 17 Sekunden. systemctl reload trennt die Verbindungen nicht, verwenden Sie es daher zum Hinzufügen oder Entfernen von Clients.
  • Ein Client verbindet sich nach einem Neustart des Servers nicht mehr: Wahrscheinlich haben Sie ihn mit dem Befehl wg set hinzugefügt, und er steht nicht in der Datei wg0.conf. Tragen Sie ihn in die Datei ein und führen Sie den Befehl sudo systemctl reload wg-quick@wg0 aus.
  • DNS-Anfragen laufen am VPN vorbei: Fehlt in der Konfiguration des Clients die Zeile DNS, fragt der Rechner den Resolver des lokalen Netzes; da dieser im lokalen Netz liegt, gehen die Anfragen auch beim vollständigen Tunnel über die lokale Verbindung. Im Test ordnete mit der Zeile DNS = 9.9.9.9 der Befehl resolvectl dns den Resolver der Schnittstelle wg0 zu, und auf dem Server kamen die DNS-Anfragen über wg0 an. Bricht wg-quick up ab, weil resolvconf fehlt, installieren Sie das Paket systemd-resolved (unter Ubuntu und Debian) oder löschen Sie die Zeile DNS.
  • Manche Seiten laden nicht, oder größere Downloads bleiben hängen: Das kann auf die Paketgröße (MTU) des Tunnels hindeuten. wg-quick stellt standardmäßig 1420 Byte ein (so auch im Test), was auf den meisten Verbindungen passt; auf manchen Mobilfunk- oder PPPoE-Verbindungen kann ein kleinerer Wert nötig sein. Versuchen Sie es im Abschnitt [Interface] des Clients mit der Zeile MTU = 1380. Im Test trat dieser Fehler nicht auf.

wg-quick gibt jeden ausgeführten Befehl aus ([#] ip link add dev wg0 type wireguard usw.); das Protokoll des Dienstes zeigt der Befehl sudo journalctl -u wg-quick@wg0.

Sicherheit

  • Schutz der privaten Schlüssel: Das Verzeichnis /etc/wireguard und die Dateien darin sollen nur für root lesbar sein (dafür ist umask 077 nötig). Wer einen privaten Schlüssel erlangt, kann sich im Namen des betreffenden Geräts verbinden. Versenden Sie die Konfigurationsdateien nicht per E-Mail oder Chat und legen Sie sie nicht in eine Versionsverwaltung.
  • Ein Gerät aussperren: Wenn ein Telefon verloren gegangen ist oder Sie ein Gerät nicht mehr verwenden, löschen Sie den zugehörigen Abschnitt [Peer] aus der Datei wg0.conf des Servers und führen Sie dann den Befehl sudo systemctl reload wg-quick@wg0 aus. Im Test verschwand der gelöschte Client sofort aus der Liste von wg show, die Verbindung der anderen Clients brach nicht ab. Der Schlüssel auf dem Gerät ist danach unbrauchbar, die anderen Geräte brauchen keine neuen Schlüssel.
  • Offener Port: Der Port von WireGuard ist nicht „gesprächig“: Auf nicht authentifizierte Pakete antwortet der Server überhaupt nicht, sodass auch ein Portscanner nicht feststellen kann, ob dort etwas läuft. Die übrigen Dienste des Servers, vor allem SSH, müssen Sie unabhängig davon schützen: Sicherheitseinstellungen für den SSH-Server.
  • Updates: WireGuard ist Teil des Kernels, daher erhalten Sie seine Sicherheitskorrekturen mit den üblichen Kernel-Updates des Systems.
Zurück: Linux-Artikel (78)