Häufige Probleme

Häufige Probleme

"WireGuard-Konfiguration konnte nicht gesetzt werden"

Ursache: Die App läuft nicht als Administrator.

Lösung: App beenden. Rechtsklick auf GateControl, dann Als Administrator ausführen.

"WireGuard-Adapter konnte nicht erstellt werden"

Ursache: Fehlende Administrator-Rechte oder ein Konflikt mit einer anderen WireGuard-Instanz.

Lösung:

1. Andere WireGuard-Clients beenden
2. App als Administrator starten
3. Gegebenenfalls PC neustarten

Kill-Switch blockiert Internet nach App-Crash

Ursache: Die Firewall-Regeln wurden bei einem Absturz nicht bereinigt.

Lösung: Admin-Eingabeaufforderung (cmd) öffnen und folgende Befehle ausführen:

netsh advfirewall firewall delete rule name="GateControl_KS_Block_All_Out"
netsh advfirewall firewall delete rule name="GateControl_KS_Block_All_In"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_Loopback"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_WG_Endpoint"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_VPN_Subnet"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_DHCP"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_LAN_10_0_0_0_8"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_LAN_172_16_0_0_12"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_LAN_192_168_0_0_16"

Alternativ die App einfach neu starten — sie bereinigt verwaiste Regeln automatisch.

Server-Verbindung schlägt fehl

QR-Code wird nicht erkannt

• Kamera-Berechtigung in Windows prüfen (Einstellungen → Datenschutz → Kamera)
• QR-Code gut beleuchtet und scharf vor die Kamera halten
• Mindestabstand ca. 15 cm einhalten

Technische Details

WireGuard-Integration

Der Client nutzt WireGuard-NT direkt über FFI (Foreign Function Interface). Es werden keine externen Prozesse gestartet. Die eingebetteten Bibliotheken:

• wireguard.dll — WireGuard-NT Kernel-Implementierung
• wintun.dll — TUN-Netzwerkadapter-Treiber

Ports und Protokolle