Einrichtung per QR-Code
v1.0
·
Updated vor 2 Wochen
Einrichtung per QR-Code
Der GateControl Client kann WireGuard-Konfigurationen per Webcam-Scan eines QR-Codes importieren — praktisch, wenn du den QR-Code aus dem GateControl Web-UI oder einer anderen Quelle hast.
Voraussetzung
- Eine Webcam am PC
- Kamera-Berechtigung in Windows aktiviert (Einstellungen → Datenschutz → Kamera)
- Ein QR-Code, der eine vollständige WireGuard-Konfiguration enthält (z.B. aus dem GateControl Web-UI unter Peers → Peer auswählen → QR-Code anzeigen)
Scan-Schritte
- GateControl Client starten
- Auf den Tab Settings wechseln
- QR-Code scannen klicken
- Die Webcam wird aktiviert — ein Vorschaufenster erscheint
- Den WireGuard-QR-Code gut beleuchtet und scharf vor die Kamera halten (Mindestabstand ca. 15 cm)
- Bei Erkennung wird die Konfiguration automatisch importiert und das Kamerafenster schließt sich
Du kannst dich anschließend auf der Status-Seite verbinden.
Tipps bei Problemen
- Stelle sicher, dass der QR-Code eine vollständige WireGuard-Konfiguration enthält (inklusive
[Interface]und[Peer]Sektionen) - Probiere verschiedene Abstände und Beleuchtungen
- Prüfen, ob die Kamera-Berechtigung in Windows aktiviert ist
Einschränkungen gegenüber der API-Verbindung
- Keine automatische Synchronisation — wie beim .conf-Import, ändert sich die Konfiguration auf dem Server, muss erneut gescannt werden
- Kein Heartbeat — der Server sieht keinen Online-Status
- Manuelle Peer-Verwaltung — der Peer muss zuerst im Server angelegt werden