Proxy & Netzwerk
Unter Einstellungen > Proxy & Netzwerk konfigurieren Sie, wie xyva auf externe Dienste zugreift. Das ist besonders relevant in Unternehmensumgebungen mit Firewalls oder Proxy-Servern.
HTTP-Proxy
Falls Ihr Netzwerk einen HTTP-Proxy erfordert, tragen Sie ihn hier ein. Die Einstellung gilt für alle ausgehenden Verbindungen von xyva -- einschließlich KI-API-Aufrufe, CI/CD-Zugriffe und Auto-Updates.
Proxy konfigurieren
- Öffnen Sie Einstellungen > Proxy & Netzwerk
- Aktivieren Sie HTTP-Proxy verwenden
- Tragen Sie die Proxy-URL ein (z. B.
http://proxy.firma.de:8080) - Falls nötig, geben Sie Benutzername und Passwort ein
- Klicken Sie auf Verbindung testen
Proxy-URL: http://proxy.firma.de:8080
Authentifizierung: Basic (Benutzername/Passwort)TIP
xyva respektiert auch die Systemumgebungsvariablen HTTP_PROXY und HTTPS_PROXY. Die Einstellung in der App überschreibt diese jedoch bei Bedarf.
AI Proxy
Der AI Proxy ist ein optionaler Zwischenserver, der alle KI-API-Anfragen bündelt. Er ist für Unternehmens-Deployments gedacht, in denen:
- API-Keys zentral verwaltet werden sollen
- Anfragen protokolliert und überwacht werden müssen
- Rate-Limiting über mehrere Nutzer hinweg benötigt wird
AI Proxy einrichten
- Aktivieren Sie AI Proxy verwenden
- Tragen Sie die Proxy-URL ein (z. B.
https://ai-proxy.firma.de) - Geben Sie den Proxy-Token ein, den Ihr Administrator bereitstellt
- Wählen Sie den Backend-Provider (Gemini, OpenAI, Claude)
INFO
Bei aktiviertem AI Proxy werden API-Anfragen über den Proxy-Server geleitet, statt direkt an den KI-Anbieter gesendet. Der API-Key wird dann auf dem Proxy-Server verwaltet, nicht lokal.
WireGuard VPN
Für den Zugriff auf selbst gehostete Dienste (internes GitLab, privater AI Proxy, Checkmk) kann xyva eine WireGuard-VPN-Verbindung nutzen.
Voraussetzungen
- WireGuard-Client muss separat installiert sein
- Sie benötigen eine
.conf-Datei von Ihrem Administrator
| Plattform | Installation |
|---|---|
| Windows | WireGuard für Windows |
| macOS | App Store oder brew install wireguard-tools |
| Linux | sudo apt install wireguard |
VPN-Profil importieren
- Aktivieren Sie WireGuard VPN
- Klicken Sie auf Konfiguration importieren
- Wählen Sie die
.conf-Datei aus - xyva stellt die Verbindung automatisch her
WARNING
VPN-Verbindungen erfordern erweiterte Systemrechte. Unter Windows und macOS wird möglicherweise eine Administrator-Bestätigung abgefragt.
Netzwerk-Diagnose
Bei Verbindungsproblemen hilft die integrierte Diagnosefunktion:
- Klicken Sie auf Netzwerk-Diagnose starten
- xyva prüft die Erreichbarkeit aller konfigurierten Endpunkte
- Ergebnisse werden mit Status (erreichbar/nicht erreichbar/Timeout) angezeigt
Nächste Schritte
- KI-Anbieter -- Provider konfigurieren, die den Proxy nutzen
- Einstellungen-Übersicht -- Zurück zur Übersicht