# GNAI-006-SEC – VPN-Client-Einrichtung: Linux (KDE Plasma) **Bezug:** GNAI-006-SEC_VPN.md (WireGuard-VPN-Gateway LXC 105) **Zielgruppe:** Benutzer (Laptop, z. B. CachyOS mit KDE Plasma) **Version:** 1.0 · 2026-09-09 --- ## 1. Voraussetzungen * WireGuard-Client-Paket installiert * Das eigene wg-easy-Profil (`.conf`) – s. Abschnitt 2 ## 2. Profil aus der wg-easy-UI beziehen (einmalig) > ⚠️ Die UI ist **nur aus dem LAN** erreichbar (nftables). Beim ersten Setup also im Heimnetz (WLAN/LAN) bleiben. 1. Browser öffnen → `http://10.0.0.15:51821` 2. Passwort eingeben 3. In der Client-Liste den eigenen Eintrag wählen (z. B. `Laptop-FullAdmin`) 4. **`Download`** klicken → Datei `Laptop-FullAdmin.conf` wird heruntergeladen *(Alternativ: QR-Code auf dem Display mit dem Smartphone scannen – Android/KDE-kompatibel.)* Die Datei enthält alles Notwendige: ```ini [Interface] PrivateKey = … # nur die eigenen – NICHT weitergeben Address = 10.8.0.2/32 DNS = 10.0.0.1 # Fritzbox als Resolver [Peer] PublicKey = … PresharedKey = … Endpoint = vpn.ghostnet.selfhost.eu:51820 AllowedIPs = 10.0.0.0/24, 10.8.0.0/24, … ``` **Nur der Abschnitt `[Interface]` (PrivateKey!) ist privat** – `PublicKey`/`PresharedKey` dürfen geteilt werden, `PrivateKey` niemals. ## 3. WireGuard installieren (CachyOS) ```bash sudo pacman -S wireguard-dkms wireguard-tools ``` * DKMS baut das WireGuard-Kernelmodul für den jeweils laufenden Kernel (CachyOS wechselt Kernel häufig – DKMS verhindert, dass nach einem Kernel-Update das Modul fehlt). * Prüfen: `lsmod | grep wireguard` ## 4. Profil importieren ### Variante A – KDE-Systemtray (empfohlen) 1. Oben rechts in der Taskleiste → **Systemtray-Icon** (kleines WLAN/Schild-Symbol) – erscheint nach Installation von `wireguard-tools` + `plasma-workspace` (bzw. `plasma-vault`-unabhängig, Teil der Standard-KDE-Pakete). 2. Rechtsklick auf das Icon → **„New from file…“** → die `.conf` wählen. 3. Eintrag erscheint in der Liste → Rechtsklick → **„Connect“**. ### Variante B – `wg-quick` (Konsole / Autostart) ```bash # Profil in das Konfigurationsverzeichnis legen install -m 600 ~/Downloads/Laptop-FullAdmin.conf /etc/wireguard/ # Verbindung starten (ohne root) sudo wg-quick up wg0 # Status wg show wg0 # Verbinden getrennt sudo wg-quick down wg0 ``` **Autostart (optional):** `/etc/wireguard/wg0.conf` mit `[Interface] PrivateKey=…` vorhanden → `sudo systemctl enable wg-quick@wg0`. ## 5. Verifikation ```bash ip -br addr show wg0 # wg0 UP, 10.8.0.2/32 ping -c 3 10.8.0.1 # VPN-Gateway (muss funktionieren) ping -c 3 10.0.0.2 # Proxmox – LAN via Tunnel ping -c 3 10.0.0.90 # LLM-Server – LAN via Tunnel curl -s ifconfig.co # eigene ÖFFENTLICHE IP (Nicht-LAN: muss die WAN-IP des Providers sein, NIE 10.0.0.x) ``` **Erwartet (Split-Tunneling):** * LAN-Hosts (`10.0.0.0/24`) → **über den VPN-Tunnel** * Alles andere (Internet) → **direkt** (Nicht-LAN: Provider-NAT) * `curl ifconfig.co` zeigt deine **normale** Außen-IP – **nicht** eine VPN-IP ## 6. Fehlersuche | Symptom | Ursache / Lösung | | --- | --- | | „No handshake yet“ nach 30 s | (1) LAN: `http://10.0.0.15:51821` erreichbar? (2) Nicht-LAN: DNS von `vpn.ghostnet.selfhost.eu` auflösen (`nslookup vpn.ghostnet.selfhost.eu` → muss `93.208.161.126` zeigen); Fritzbox-Portforward UDP 51820 aktiv? | | `wg-quick` meldet `WireGuard kernel module not loaded` | `sudo modprobe wireguard` (DKMS nicht installiert oder Kernel-Update → `sudo pacman -S wireguard-dkms`) | | LAN-Ping funktioniert, `curl ifconfig.co` zeigt VPN-IP | Client ist (fälschlich) im Full-Tunnel-Modus → `AllowedIPs` in der `.conf` prüfen – muss **nur** `10.0.0.0/24,10.8.0.0/24,…` sein, **nicht** `0.0.0.0/0` | | `Permission denied` bei `wg-quick up` | `sudo` vergessen (oder: `sudo usermod -aG wheel $USER` + `sudo /usr/bin/setfacl -m u:$USER:rw /etc/wireguard/wg0.conf` für rootless) | | KDE-Icon fehlt | `plasma-workspace`-Paket installiert; Systemtray neu starten: `plasmashell --replace` | ## 7. Sicherheitshinweise * **Niemals** den PrivateKey aus der `.conf` in einen Chat/Die-Cloud/Chat-Verlauf stellen. * `.conf` mit `chmod 600` (`install -m 600` s. oben) – kein World-Readable. * Bei Verdacht auf Kompromittierung: in der wg-easy-UI Client **deaktivieren** (Toggle) oder **delete** – der Server erkennt den Key nicht mehr an.