====== WireGuard – VPN-Schlüssel ====== ===== Installation (Debian) ===== sudo apt update sudo apt install wireguard Version prüfen: wg --version ===== Prinzip ===== WireGuard ist ein schlankes VPN-Protokoll. Jeder Peer besitzt ein privates und ein öffentliches Schlüsselpaar. Die Schlüssel dienen der gegenseitigen kryptografischen Identifikation und der Ableitung von Sitzungsschlüsseln. WireGuard verwendet moderne festgelegte Kryptografie. ===== Schlüsselpaar erstellen ===== Private Schlüssel nicht in gemeinsam lesbaren Verzeichnissen erzeugen. Beispiel in einem geschützten Arbeitsverzeichnis: umask 077 Privaten Schlüssel erzeugen: wg genkey > privatekey Öffentlichen Schlüssel daraus ableiten: wg pubkey < privatekey > publickey Die Datei ''privatekey'' ist geheim; ''publickey'' wird auf der jeweiligen Gegenstelle hinterlegt. ===== Peer-Konfiguration ===== Eine typische Konfiguration enthält auf der lokalen Seite ''PrivateKey'' und für jeden Peer dessen ''PublicKey'' sowie ''AllowedIPs''. Die konkreten IP-Bereiche und Endpunkte hängen vom Netzwerk ab. ===== Verbindung starten und beenden ===== Voraussetzung ist eine korrekt eingerichtete Konfiguration ''/etc/wireguard/wg0.conf''. ''wg0'' ist ein Beispielname. **Starten:** sudo wg-quick up wg0 **Beenden:** sudo wg-quick down wg0 Die Nutzdaten werden automatisch ver- und entschlüsselt. ===== Status prüfen ===== sudo wg show Die Ausgabe zeigt unter anderem Peers, Handshakes und übertragene Daten. Sie ist für die Diagnose hilfreich, kann aber Netzwerkdetails offenlegen. In o.a. Anzeige sind der öffentliche Schlüssel sowie die IP-Adresse zu sehen, aber keine weiteren Client-Informationen. ==== Eigenes Anzeige-Script ==== **1. Gerätenamen in wg0.conf eintragen (Beispiel):** \\ sudo nano /etc/wireguard/wg0.conf [Peer] # Client: Notebook PublicKey = ... AllowedIPs = 10.10.0.2/32 [Peer] # Client: Smartphone PublicKey = ... AllowedIPs = 10.10.0.3/32 Wichtig ist, dass # Client: jeweils innerhalb des zugehörigen [Peer]-Abschnitts steht. **2. Skript erstellen** \\ Auf dem WireGuard-Server: sudo nano /usr/local/sbin/wg-status Folgenden Inhalt einfügen: #!/usr/bin/env bash set -euo pipefail CONFIG="/etc/wireguard/wg0.conf" INTERFACE="wg0" if [[ $EUID -ne 0 ]]; then echo "Bitte mit sudo ausführen: sudo wg-status" >&2 exit 1 fi if [[ ! -r "$CONFIG" ]]; then echo "Konfiguration nicht lesbar: $CONFIG" >&2 exit 1 fi declare -A CLIENTS # Gerätenamen und PublicKeys aus der Konfiguration lesen. while IFS=$'\t' read -r key name; do [[ -n "$key" ]] && CLIENTS["$key"]="$name" done < <( awk ' /^\[Peer\][[:space:]]*$/ { if (peer && key != "") print key "\t" name peer=1 key="" name="Unbekannt" next } /^\[/ { if (peer && key != "") print key "\t" name peer=0 next } peer && /^[[:space:]]*#[[:space:]]*Client:/ { sub(/^[[:space:]]*#[[:space:]]*Client:[[:space:]]*/, "") name=$0 next } peer && /^[[:space:]]*PublicKey[[:space:]]*=/ { sub(/^[[:space:]]*PublicKey[[:space:]]*=[[:space:]]*/, "") sub(/[[:space:]]*$/, "") key=$0 } END { if (peer && key != "") print key "\t" name } ' "$CONFIG" ) echo "WireGuard-Status: $INTERFACE" echo "============================================================" # Aktuelle Peer-Daten abfragen. while IFS=$'\t' read -r key psk endpoint ips handshake rx tx keepalive; do [[ -n "$key" ]] || continue name="${CLIENTS[$key]:-Unbekannt}" if [[ "$handshake" =~ ^[0-9]+$ ]] && (( handshake > 0 )); then age=$(( $(date +%s) - handshake )) (( age < 0 )) && age=0 days=$(( age / 86400 )) hours=$(( (age % 86400) / 3600 )) minutes=$(( (age % 3600) / 60 )) seconds=$(( age % 60 )) parts=() (( days > 0 )) && parts+=("$days Tage") (( hours > 0 )) && parts+=("$hours Stunden") (( minutes > 0 )) && parts+=("$minutes Minuten") (( seconds > 0 || ${#parts[@]} == 0 )) && parts+=("$seconds Sekunden") handshake_text="vor ${parts[*]}" else handshake_text="Noch kein Handshake" fi rx_mib=$(awk -v n="$rx" 'BEGIN {printf "%.2f", n/1048576}') tx_mib=$(awk -v n="$tx" 'BEGIN {printf "%.2f", n/1048576}') printf '\nClient: %s\n' "$name" printf 'PublicKey: %s\n' "$key" printf 'VPN-IP: %s\n' "$ips" printf 'Endpoint: %s\n' "$endpoint" printf 'Handshake: %s\n' "$handshake_text" printf 'Empfangen: %s MiB\n' "$rx_mib" printf 'Gesendet: %s MiB\n' "$tx_mib" done < <(wg show "$INTERFACE" dump | tail -n +2) **3. Ausführbar machen** \\ sudo chmod 755 /usr/local/sbin/wg-status **4. Link ins Homeverzeichnis** \\ ln -s /usr/local/sbin/wg-status ~/wg-status **5. Aufrufen** \\ sudo ~/wg-status ===== Geräteverwaltung ===== Für jedes Gerät ein eigenes Schlüsselpaar verwenden. Geht ein Gerät verloren, wird dessen Peer auf den Gegenstellen entfernt und gegebenenfalls ein neuer Schlüssel eingerichtet. Der Austausch eines Schlüssels erfordert die Aktualisierung des zugehörigen öffentlichen Schlüssels auf den Gegenstellen. ===== Sicherheit ===== Der private Schlüssel darf nicht öffentlich werden. ''AllowedIPs'' steuert sowohl Routing als auch die Zuordnung zulässiger IP-Adressen zu Peers; eine sorgfältige Konfiguration ist notwendig. WireGuard ersetzt keine Firewall-Regeln oder Zugriffskontrollen auf Anwendungsebene. ---- [[index|Zurück zur Übersicht]]