Zum Inhalt

wg-quick

Baut einen WireGuard-Tunnel aus einer Konfigurationsdatei auf oder ab, mit Adressen, Routen und DNS.

wg-quick output

Syntax

wg-quick up | down | save | strip INTERFACE

Optionen

Option Beschreibung
up wg0 /etc/wireguard/wg0.conf lesen, das Interface anlegen, Adressen und Routen setzen
down wg0 Das Interface und seine Routen wieder entfernen
save wg0 Den laufenden Zustand (etwa mit wg set hinzugefügte Peers) in die Datei schreiben
strip wg0 Nur den Teil der Datei ausgeben, den wg selbst versteht
systemctl enable --now wg-quick@wg0 Den Tunnel jetzt und bei jedem Start hochfahren

Neben den wg-Einstellungen versteht der Abschnitt [Interface] auch Address, DNS, MTU, PostUp und PostDown, etwa für NAT-Regeln.

Beispiele

Den Tunnel hochfahren:

sudo wg-quick up wg0
[#] ip link add wg0 type wireguard
[#] wg setconf wg0 /dev/fd/63
[#] ip -4 address add 10.8.0.1/24 dev wg0
[#] ip link set mtu 1420 up dev wg0

wg-quick zeigt jeden Befehl, den es ausführt. Die Konfiguration steht in den Grundlagen.

Bei jedem Start hochfahren:

sudo systemctl enable --now wg-quick@wg0
ip -br address show wg0
Created symlink '/etc/systemd/system/multi-user.target.wants/wg-quick@wg0.service' → '/usr/lib/systemd/system/wg-quick@.service'.
wg0              UNKNOWN        10.8.0.1/24

Den Tunnel vom Laptop aus testen:

ping -c 3 10.8.0.1
PING 10.8.0.1 (10.8.0.1) 56(84) bytes of data.
64 bytes from 10.8.0.1: icmp_seq=1 ttl=64 time=18.4 ms
64 bytes from 10.8.0.1: icmp_seq=2 ttl=64 time=18.1 ms
64 bytes from 10.8.0.1: icmp_seq=3 ttl=64 time=18.3 ms

--- 10.8.0.1 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2003ms
rtt min/avg/max/mdev = 18.112/18.267/18.402/0.119 ms

Im Betrieb hinzugefügte Peers speichern:

sudo wg-quick save wg0
sudo grep -c '^\[Peer\]' /etc/wireguard/wg0.conf
2

Den Tunnel herunterfahren:

sudo wg-quick down wg0
[#] ip link delete dev wg0

Wann brauche ich das?

  • Um einen Tunnel für einen Test von Hand zu starten
  • Um das VPN mit systemd automatisch beim Start hochzufahren
  • Um Peers zu speichern, die im laufenden System hinzugefügt wurden

Nach Änderungen neu starten

Nach dem Bearbeiten der wg0.conf übernimmt sudo systemctl restart wg-quick@wg0 sie. Um Peers zu ändern, ohne Verbindungen zu unterbrechen, nimm sudo wg syncconf wg0 <(wg-quick strip wg0).

DNS = braucht resolvconf

Eine Zeile DNS = in der Client-Konfiguration braucht resolvconf oder systemd-resolved. Ohne scheitert wg-quick up mit resolvconf: command not found.

Unterschiede zwischen Distributionen

Debian Ubuntu RHEL Arch
Installation sudo apt install wireguard-tools sudo apt install wireguard-tools sudo dnf install wireguard-tools sudo pacman -S wireguard-tools

Verwandte Befehle

wg · systemctl · ip · resolvectl