Einrichtung per API-Verbindung (empfohlen)
v1.0
·
Updated vor 2 Wochen
Einrichtung per API-Verbindung
Dies ist der empfohlene Weg. Der Client verbindet sich direkt mit deinem GateControl-Server, registriert sich automatisch als Peer und hält die Konfiguration dauerhaft aktuell.
Schritt 1: API-Token im GateControl Server erstellen
- GateControl Web-UI öffnen
- Settings aufrufen, dann API & Webhooks
- Unter API Tokens einen Token-Namen eingeben (z.B.
Windows Client Marc) - Bei Integration den Scope Client App aktivieren
- Create Token klicken
- Den angezeigten Token (
gc_...) kopieren — er wird nur einmal angezeigt
Schritt 2: Client konfigurieren
- GateControl Client starten
- Auf den Tab Settings wechseln
- Server URL eingeben (z.B.
https://vpn.example.com) - API Key einfügen (den kopierten
gc_...Token) - Test Connection klicken — bei Erfolg erscheint eine Bestätigung
- Save & Register klicken
Der Client registriert sich automatisch als neuer Peer auf dem Server. Die Peer-ID wird gespeichert und die WireGuard-Konfiguration vom Server heruntergeladen.
Vorteile der API-Verbindung
- Automatische Peer-Registrierung — kein manuelles Anlegen im Server nötig
- Config-Polling — Änderungen am Server werden automatisch synchronisiert
- Heartbeat — der Server sieht den Online-Status und Traffic des Clients
- Kein manuelles Nachpflegen — anders als bei .conf-Dateien oder QR-Codes
Tipp: Im GateControl Web-UI erscheint der neue Peer unter Peers mit dem Hostnamen des Windows-PCs.