wehub-resource-sync
1.9 KiB
sidebar_position, _i18n_hash
| sidebar_position | _i18n_hash |
|---|---|
| 100 | 2419750faca3b35056a24bc0a5e02a22 |
Fehlerbehebung
Dieses Dokument sammelt häufige Probleme und deren Lösungen, die bei der Verwendung von Tianji auftreten können.
WebSocket-Verbindungsprobleme
Problembeschreibung
Bei der Nutzung von HTTPS-Diensten funktionieren andere Funktionen normal, aber der WebSocket-Dienst kann nicht ordnungsgemäß verbunden werden, was sich wie folgt zeigt:
- Der Verbindungsstatusanzeiger in der unteren linken Ecke zeigt grau an
- Die Serverseitenseitenliste zeigt Zählungen, aber keinen tatsächlichen Inhalt
Ursachenermittlung
Dieses Problem wird meist durch unzureichende WebSocket-Weiterleitungsrichtlinien in der Reverse-Proxy-Software verursacht. In HTTPS-Umgebungen erfordern WebSocket-Verbindungen korrekte Cookie-Sicherheitsrichtlinien.
Lösung
Sie können dieses Problem durch Setzen der folgenden Umgebungsvariable lösen:
AUTH_USE_SECURE_COOKIES=true
Diese Einstellung zwingt die Anwendung, Cookies, die vom Browser übermittelt werden, als verschlüsselte Cookies zu behandeln und löst somit die Probleme mit WebSocket-Verbindungen.
Konfigurationsmethoden
Docker-Umgebung:
# docker-compose.yml
services:
tianji:
environment:
- AUTH_USE_SECURE_COOKIES=true
Direkte Bereitstellung:
export AUTH_USE_SECURE_COOKIES=true
Überprüfungsschritte
Nach der Konfiguration starten Sie den Dienst neu und überprüfen Sie:
- Der Verbindungsstatusanzeiger unten links sollte grün anzeigen
- Serverseiten sollten Echtzeitdaten normal anzeigen
- WebSocket-Verbindungen sollten ordnungsgemäß in den Entwickler-Tools des Browsers hergestellt werden
Wenn Sie auf andere Probleme stoßen, können Sie gerne ein Issue einreichen oder Lösungen zu dieser Dokumentation beitragen.