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 :

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 :

# docker-compose.yml
services:
  tianji:
    environment:
      - AUTH_USE_SECURE_COOKIES=true

Déploiement direct :

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 ou à contribuer avec des solutions à cette documentation.