wehub-resource-sync
59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
---
|
|
sidebar_position: 100
|
|
_i18n_hash: 2419750faca3b35056a24bc0a5e02a22
|
|
---
|
|
# Dépannage
|
|
|
|
Ce document rassemble les problèmes courants et leurs solutions que vous pouvez rencontrer lors de l'utilisation de Tianji.
|
|
|
|
## Problèmes de connexion WebSocket
|
|
|
|
### Description du problème
|
|
|
|
Lors de l'utilisation des services HTTPS, d'autres fonctions fonctionnent normalement, mais le service WebSocket ne peut pas se connecter correctement, ce qui se manifeste par :
|
|
|
|
- L'indicateur d'état de connexion en bas à gauche s'affiche en gris
|
|
- La liste des pages du serveur montre des comptes mais aucun contenu réel
|
|
|
|
### Cause principale
|
|
|
|
Ce problème est généralement causé par des politiques incorrectes de transfert WebSocket dans des logiciels de proxy inversé. Dans les environnements HTTPS, les connexions WebSocket nécessitent des politiques de sécurité des cookies correctes.
|
|
|
|
### Solution
|
|
|
|
Vous pouvez résoudre ce problème en définissant la variable d'environnement suivante :
|
|
|
|
```bash
|
|
AUTH_USE_SECURE_COOKIES=true
|
|
```
|
|
|
|
Ce paramètre force l'application à traiter les cookies passés par le navigateur comme des cookies chiffrés, résolvant ainsi les problèmes de connexion WebSocket.
|
|
|
|
#### Méthodes de configuration
|
|
|
|
**Environnement Docker :**
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
tianji:
|
|
environment:
|
|
- AUTH_USE_SECURE_COOKIES=true
|
|
```
|
|
|
|
**Déploiement direct :**
|
|
```bash
|
|
export AUTH_USE_SECURE_COOKIES=true
|
|
```
|
|
|
|
### Étapes de vérification
|
|
|
|
Après la configuration, redémarrez le service et vérifiez :
|
|
|
|
1. L'indicateur d'état de connexion en bas à gauche devrait s'afficher en vert
|
|
2. Les pages du serveur devraient afficher les données en temps réel normalement
|
|
3. Les connexions WebSocket devraient être établies correctement dans les outils de développement du navigateur
|
|
|
|
---
|
|
|
|
*Si vous rencontrez d'autres problèmes, n'hésitez pas à soumettre un [Issue](https://github.com/msgbyte/tianji/issues) ou à contribuer avec des solutions à cette documentation.*
|