You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This document collects common issues and their solutions that you may encounter when using Tianji.
8
+
9
+
## WebSocket Connection Issues
10
+
11
+
### Problem Description
12
+
13
+
When using HTTPS services, other functions work normally, but WebSocket service cannot connect properly, which manifests as:
14
+
15
+
- The connection status indicator in the bottom left corner shows gray
16
+
- Server page list shows counts but no actual content
17
+
18
+
### Root Cause
19
+
20
+
This issue is usually caused by improper WebSocket forwarding policies in reverse proxy software. In HTTPS environments, WebSocket connections require correct Cookie security policies.
21
+
22
+
### Solution
23
+
24
+
You can resolve this issue by setting the following environment variable:
25
+
26
+
```bash
27
+
AUTH_USE_SECURE_COOKIES=true
28
+
```
29
+
30
+
This setting forces the application to treat cookies passed by the browser as encrypted cookies, thereby resolving WebSocket connection issues.
31
+
32
+
#### Configuration Methods
33
+
34
+
**Docker Environment:**
35
+
```yaml
36
+
# docker-compose.yml
37
+
services:
38
+
tianji:
39
+
environment:
40
+
- AUTH_USE_SECURE_COOKIES=true
41
+
```
42
+
43
+
**Direct Deployment:**
44
+
```bash
45
+
export AUTH_USE_SECURE_COOKIES=true
46
+
```
47
+
48
+
**systemd Service:**
49
+
```ini
50
+
[Service]
51
+
Environment=AUTH_USE_SECURE_COOKIES=true
52
+
```
53
+
54
+
### Verification Steps
55
+
56
+
After configuration, restart the service and check:
57
+
58
+
1. The bottom left connection status indicator should show green
59
+
2. Server pages should display real-time data normally
60
+
3. WebSocket connections should be established properly in browser developer tools
61
+
62
+
---
63
+
64
+
*If you encounter other issues, feel free to submit an [Issue](https://github.com/msgbyte/tianji/issues) or contribute solutions to this documentation.*
Copy file name to clipboardExpand all lines: website/i18n/de/docusaurus-plugin-content-docs/current/install/environment.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,20 +1,20 @@
1
1
---
2
2
sidebar_position: 10
3
-
_i18n_hash: 5ff3432ae327097b85732e04b2cda2d3
3
+
_i18n_hash: 0648c6e4c85f3bd3ac4cdd91fad4eb39
4
4
---
5
5
# Umgebungsvariablen
6
6
7
-
Tianji unterstützt verschiedene Umgebungsvariablen, um sein Verhalten anzupassen. Sie können diese Variablen im `env`-Feld Ihres Docker Compose oder über Ihre Bereitstellungsumgebung konfigurieren.
7
+
Tianji unterstützt verschiedene Umgebungsvariablen zur Anpassung des Verhaltens. Diese Variablen können Sie in Ihrem Docker Compose `env`-Feld oder über Ihre Bereitstellungsumgebung konfigurieren.
8
8
9
9
## Grundkonfiguration
10
10
11
11
| Variable | Beschreibung | Standard | Beispiel |
12
12
| --- | --- | --- | --- |
13
13
|`PORT`| Server-Port |`12345`|`3000`|
14
-
|`JWT_SECRET`| Geheimnis für JWT-Token| Zufälliger Text |`your-secret-key`|
14
+
|`JWT_SECRET`| Geheimnis für JWT-Tokens| Zufälliger Text |`your-secret-key`|
Für boolesche Umgebungsvariablen können Sie entweder `"1"` oder `"true"` verwenden, um das Feature zu aktivieren, und entweder die Variable weglassen oder auf einen anderen Wert setzen, um es zu deaktivieren.
111
+
Für boolesche Umgebungsvariablen können Sie entweder `"1"` oder `"true"` verwenden, um die Funktion zu aktivieren, und entweder die Variable weglassen oder auf einen anderen Wert setzen, um sie zu deaktivieren.
Dieses Dokument sammelt häufige Probleme und deren Lösungen, die bei der Verwendung von Tianji auftreten können.
8
+
9
+
## WebSocket-Verbindungsprobleme
10
+
11
+
### Problembeschreibung
12
+
13
+
Beim Verwenden von HTTPS-Diensten funktionieren andere Funktionen normal, aber der WebSocket-Dienst kann nicht ordnungsgemäß verbunden werden, was sich wie folgt äußert:
14
+
15
+
- Der Verbindungsstatusanzeiger in der unteren linken Ecke zeigt grau
16
+
- Die Serverseitenseitenliste zeigt Zählungen, aber keinen tatsächlichen Inhalt
17
+
18
+
### Ursache
19
+
20
+
Dieses Problem wird normalerweise durch falsche Weiterleitungsrichtlinien für WebSockets in Revers-Proxy-Software verursacht. In HTTPS-Umgebungen erfordern WebSocket-Verbindungen korrekte Cookie-Sicherheitsrichtlinien.
21
+
22
+
### Lösung
23
+
24
+
Sie können dieses Problem beheben, indem Sie die folgende Umgebungsvariable setzen:
25
+
26
+
```bash
27
+
AUTH_USE_SECURE_COOKIES=true
28
+
```
29
+
30
+
Diese Einstellung zwingt die Anwendung, Cookies, die vom Browser übergeben werden, als verschlüsselte Cookies zu behandeln, wodurch das Problem mit den WebSocket-Verbindungen behoben wird.
31
+
32
+
#### Konfigurationsmethoden
33
+
34
+
**Docker-Umgebung:**
35
+
```yaml
36
+
# docker-compose.yml
37
+
services:
38
+
tianji:
39
+
environment:
40
+
- AUTH_USE_SECURE_COOKIES=true
41
+
```
42
+
43
+
**Direkte Bereitstellung:**
44
+
```bash
45
+
export AUTH_USE_SECURE_COOKIES=true
46
+
```
47
+
48
+
**systemd-Dienst:**
49
+
```ini
50
+
[Service]
51
+
Environment=AUTH_USE_SECURE_COOKIES=true
52
+
```
53
+
54
+
### Überprüfungsschritte
55
+
56
+
Nach der Konfiguration starten Sie den Dienst neu und überprüfen Sie:
57
+
58
+
1. Der Verbindungsstatusanzeiger unten links sollte grün anzeigen
59
+
2. Serverseiten sollten Echtzeitdaten normal anzeigen
60
+
3. WebSocket-Verbindungen sollten ordnungsgemäß in den Entwickler-Tools des Browsers hergestellt werden
61
+
62
+
---
63
+
64
+
*Wenn Sie auf andere Probleme stoßen, können Sie gerne ein [Issue](https://github.com/msgbyte/tianji/issues) einreichen oder Lösungen zu dieser Dokumentation beitragen.*
Tianji prend en charge diverses variables d'environnement pour personnaliser son comportement. Vous pouvez configurer ces variables dans votre champ `env` de docker compose ou via votre environnement de déploiement.
7
+
Tianji prend en charge diverses variables d'environnement pour personnaliser son comportement. Vous pouvez configurer ces variables dans le champ `env` de votre docker-compose ou via votre environnement de déploiement.
8
8
9
9
## Configuration de base
10
10
11
-
| Variable | Description |Par défaut| Exemple |
11
+
| Variable | Description |Défault| Exemple |
12
12
| --- | --- | --- | --- |
13
13
|`PORT`| Port du serveur |`12345`|`3000`|
14
-
|`JWT_SECRET`|Clé secrète pour les jetons JWT | Texte aléatoire |`your-secret-key`|
14
+
|`JWT_SECRET`|Secret pour les tokens JWT | Texte aléatoire |`votre-clé-secrète`|
15
15
|`ALLOW_REGISTER`| Activer l'enregistrement des utilisateurs |`false`|`true`|
|`AUTH_CUSTOM_ISSUR`| URL de l'émetteur OIDC | - |`https://auth.example.com`|
60
60
61
-
## Fonctions AI
61
+
## Fonctionnalités AI
62
62
63
-
| Variable | Description |Par défaut| Exemple |
63
+
| Variable | Description |Défault| Exemple |
64
64
| --- | --- | --- | --- |
65
-
|`OPENAI_API_KEY`| Clé API OpenAI | - |`your-openai-api-key`|
66
-
|`OPENAI_BASE_URL`| URL personnalisée de l'API OpenAI | - |`https://api.openai.com/v1`|
65
+
|`OPENAI_API_KEY`| Clé API OpenAI | - |`votre-clé-api-openai`|
66
+
|`OPENAI_BASE_URL`| URL API OpenAI personnalisée| - |`https://api.openai.com/v1`|
67
67
|`OPENAI_MODEL_NAME`| Modèle OpenAI à utiliser |`gpt-4o`|`gpt-3.5-turbo`|
68
68
|`DEBUG_AI_FEATURE`| Déboguer les fonctionnalités AI |`false`|`true`|
69
69
70
-
## Configuration Sandbox
70
+
## Configuration du Bac à Sable
71
71
72
-
| Variable | Description |Par défaut| Exemple |
72
+
| Variable | Description |Défault| Exemple |
73
73
| --- | --- | --- | --- |
74
-
|`USE_VM2`| Utiliser VM2 pour l'exécution en sandbox|`false`|`true`|
75
-
|`SANDBOX_MEMORY_LIMIT`| Limite de mémoire pour la sandbox (MB) |`16`|`32`|
74
+
|`USE_VM2`| Utiliser VM2 pour l'exécution de bac à sable|`false`|`true`|
75
+
|`SANDBOX_MEMORY_LIMIT`| Limite de mémoire pour le bac à sable (MB) |`16`|`32`|
76
76
|`PUPPETEER_EXECUTABLE_PATH`| Chemin personnalisé vers l'exécutable Puppeteer | - |`/usr/bin/chromium`|
77
77
78
-
## Intégration de cartes
78
+
## Intégration de Cartes
79
79
80
-
| Variable | Description |Par défaut| Exemple |
80
+
| Variable | Description |Défault| Exemple |
81
81
| --- | --- | --- | --- |
82
-
|`AMAP_TOKEN`| Jeton API AMap (Gaode) | - |`your-amap-token`|
83
-
|`MAPBOX_TOKEN`| Jeton API Mapbox | - |`your-mapbox-token`|
82
+
|`AMAP_TOKEN`| Jeton API AMap (Gaode) | - |`votre-token-amap`|
83
+
|`MAPBOX_TOKEN`| Jeton API Mapbox | - |`votre-token-mapbox`|
84
84
85
85
## Télémétrie
86
86
87
-
| Variable | Description |Par défaut| Exemple |
87
+
| Variable | Description |Défault| Exemple |
88
88
| --- | --- | --- | --- |
89
89
|`DISABLE_ANONYMOUS_TELEMETRY`| Désactiver la télémétrie anonyme |`false`|`true`|
90
90
|`CUSTOM_TRACKER_SCRIPT_NAME`| Nom du script de suivi personnalisé | - |`custom-tracker.js`|
91
91
92
-
## Définir les variables d'environnement
92
+
## Définir les Variables d'Environnement
93
93
94
94
Vous pouvez définir ces variables d'environnement de différentes manières :
95
95
96
-
1.Les définir directement dans votre environnement de déploiement (Docker, Kubernetes, etc.)
96
+
1.Définissez-les directement dans votre environnement de déploiement (Docker, Kubernetes, etc.)
97
97
98
-
2. Pour les déploiements Docker, vous pouvez utiliser des variables d'environnement dans votre docker-compose.yml :
98
+
2. Pour les déploiements Docker, vous pouvez utiliser les variables d'environnement dans votre docker-compose.yml :
99
99
100
100
```yaml
101
101
services:
@@ -106,6 +106,6 @@ services:
106
106
- ALLOW_REGISTER=true
107
107
```
108
108
109
-
## Valeurs booléennes
109
+
## Valeurs Booléennes
110
110
111
-
Pour les variables booléennes, vous pouvez utiliser soit `"1"` soit `"true"` pour activer la fonctionnalité, et soit omettre la variable soit la définir sur toute autre valeur pour la désactiver.
111
+
Pour les variables d'environnement booléennes, vous pouvez utiliser soit `"1"` soit `"true"` pour activer la fonctionnalité, et soit omettre la variable soit la définir sur toute autre valeur pour la désactiver.
0 commit comments