152 lines
7.1 KiB
Markdown
152 lines
7.1 KiB
Markdown
---
|
|
sidebar_position: 10
|
|
_i18n_hash: a89f05aed50f89d55367e4d1d6598373
|
|
---
|
|
# Umgebungsvariablen
|
|
|
|
Tianji unterstützt verschiedene Umgebungsvariablen zur Anpassung seines Verhaltens. Sie können diese Variablen in Ihrem Docker Compose `env` Feld oder über Ihre Bereitstellungsumgebung konfigurieren.
|
|
|
|
## Grundkonfiguration
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `PORT` | Serverport | `12345` | `3000` |
|
|
| `JWT_SECRET` | Geheimnis für JWT-Tokens | Zufälliger Text | `dein-geheimnis-schlüssel` |
|
|
| `ALLOW_REGISTER` | Benutzerregistrierung aktivieren | `false` | `true` |
|
|
| `ALLOW_OPENAPI` | OpenAPI-Zugriff aktivieren | `true` | `false` |
|
|
| `WEBSITE_ID` | Website-Kennung | - | `deine-website-id` |
|
|
| `DISABLE_AUTO_CLEAR` | Automatische Datenbereinigung deaktivieren | `false` | `true` |
|
|
| `DISABLE_ACCESS_LOGS` | Zugriffsprotokolle deaktivieren | `false` | `true` |
|
|
| `DB_DEBUG` | Datenbank-Debugging aktivieren | `false` | `true` |
|
|
| `ALPHA_MODE` | Alpha-Funktionen aktivieren | `false` | `true` |
|
|
| `ENABLE_FUNCTION_WORKER` | Funktionsarbeiter aktivieren | `false` | `true` |
|
|
| `REGISTER_AUTO_JOIN_WORKSPACE_ID` | Automatische Beitritts-ID für neue Benutzer | - | `arbeitsraum-id-123` |
|
|
|
|
## Cache-Konfiguration
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `CACHE_MEMORY_ONLY` | Nur-Speicher-Caching verwenden | `false` | `true` |
|
|
| `REDIS_URL` | Redis-Verbindungs-URL | - | `redis://localhost:6379` |
|
|
|
|
## Authentifizierung
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `DISABLE_ACCOUNT` | Konto-basierte Authentifizierung deaktivieren | `false` | `true` |
|
|
| `AUTH_SECRET` | Authentifizierungsgeheimnis | MD5 des JWT-Geheimnisses | `dein-auth-geheimnis` |
|
|
| `AUTH_RESTRICT_EMAIL` | Registrierung auf bestimmte E-Mail-Domänen beschränken | - | `@example.com` |
|
|
| `AUTH_USE_SECURE_COOKIES` | Sichere Cookies für die Authentifizierung verwenden | `false` | `true` |
|
|
|
|
### E-Mail-Authentifizierung und Einladung
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `EMAIL_SERVER` | SMTP-Server für E-Mail | - | `smtp://user:pass@smtp.beispiel.de:587` |
|
|
| `EMAIL_FROM` | E-Mail-Absenderadresse | - | `noreply@beispiel.de` |
|
|
|
|
### GitHub-Authentifizierung
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `AUTH_GITHUB_ID` | GitHub OAuth-Client-ID | - | `deine-github-client-id` |
|
|
| `AUTH_GITHUB_SECRET` | GitHub OAuth-Client-Geheimnis | - | `dein-github-client-geheimnis` |
|
|
|
|
### Google-Authentifizierung
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `AUTH_GOOGLE_ID` | Google OAuth-Client-ID | - | `deine-google-client-id` |
|
|
| `AUTH_GOOGLE_SECRET` | Google OAuth-Client-Geheimnis | - | `dein-google-client-geheimnis` |
|
|
|
|
### Benutzerdefinierte OAuth/OIDC-Authentifizierung
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `AUTH_CUSTOM_ID` | Benutzerdefinierte OAuth/OIDC-Client-ID | - | `deine-benutzerdefinierte-client-id` |
|
|
| `AUTH_CUSTOM_SECRET` | Benutzerdefiniertes OAuth/OIDC-Client-Geheimnis | - | `dein-benutzerdefiniertes-client-geheimnis` |
|
|
| `AUTH_CUSTOM_NAME` | Name des benutzerdefinierten Anbieters | `Custom` | `Enterprise SSO` |
|
|
| `AUTH_CUSTOM_TYPE` | Authentifizierungstyp | `oidc` | `oauth` |
|
|
| `AUTH_CUSTOM_ISSUER` | OIDC-Aussteller-URL | - | `https://auth.beispiel.de` |
|
|
|
|
## KI-Funktionen
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `SHARED_OPENAI_API_KEY` | OpenAI-API-Schlüssel | - | `dein-openai-api-key` |
|
|
| `SHARED_OPENAI_BASE_URL` | Benutzerdefinierte OpenAI-API-URL | - | `https://api.openai.com/v1` |
|
|
| `SHARED_OPENAI_MODEL_NAME` | OpenAI-Modell, das verwendet werden soll | `gpt-4o` | `gpt-3.5-turbo` |
|
|
| `SHARED_OPENAI_TOKEN_CALC_CONCURRENCY` | Token-Berechnungskonkurrenz | `5` | `10` |
|
|
| `DEBUG_AI_FEATURE` | KI-Funktionen debuggen | `false` | `true` |
|
|
|
|
## ClickHouse-Konfiguration
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `CLICKHOUSE_URL` | ClickHouse-Datenbank-URL | - | `http://localhost:8123` |
|
|
| `CLICKHOUSE_USER` | ClickHouse-Benutzername | - | `default` |
|
|
| `CLICKHOUSE_PASSWORD` | ClickHouse-Passwort | - | `dein-passwort` |
|
|
| `CLICKHOUSE_DATABASE` | ClickHouse-Datenbankname | - | `tianji` |
|
|
| `CLICKHOUSE_DEBUG` | ClickHouse-Debugging aktivieren | `false` | `true` |
|
|
| `CLICKHOUSE_DISABLE_SYNC` | ClickHouse-Synchronisation deaktivieren | `false` | `true` |
|
|
| `CLICKHOUSE_SYNC_BATCH_SIZE` | Synchronisations-Batchgröße | `10000` | `5000` |
|
|
| `CLICKHOUSE_ENABLE_FALLBACK` | ClickHouse-Fallback aktivieren | `true` | `false` |
|
|
| `CLICKHOUSE_HEALTH_CHECK_INTERVAL` | Gesundheitscheck-Intervall (ms) | `30000` | `60000` |
|
|
| `CLICKHOUSE_MAX_CONSECUTIVE_FAILURES` | Maximale aufeinanderfolgende Fehler | `3` | `5` |
|
|
| `CLICKHOUSE_RETRY_INTERVAL` | Wiederholungsintervall (ms) | `5000` | `10000` |
|
|
|
|
## Abrechnungssystem (LemonSqueezy)
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `ENABLE_BILLING` | Abrechnungsfunktionalität aktivieren | `false` | `true` |
|
|
| `LEMON_SQUEEZY_SIGNATURE_SECRET` | LemonSqueezy Webhook-Signaturgeheimnis | - | `dein-signatur-geheimnis` |
|
|
| `LEMON_SQUEEZY_API_KEY` | LemonSqueezy API-Schlüssel | - | `dein-api-schlüssel` |
|
|
| `LEMON_SQUEEZY_STORE_ID` | LemonSqueezy Shop-ID | - | `dein-shop-id` |
|
|
| `LEMON_SQUEEZY_SUBSCRIPTION_FREE_ID` | Varianten-ID für kostenlose Abonnementstufe | - | `kostenlose-variante-id` |
|
|
| `LEMON_SQUEEZY_SUBSCRIPTION_PRO_ID` | Varianten-ID für Pro-Abonnementstufe | - | `pro-variante-id` |
|
|
| `LEMON_SQUEEZY_SUBSCRIPTION_TEAM_ID` | Varianten-ID für Team-Abonnementstufe | - | `team-variante-id` |
|
|
|
|
## Sandbox-Konfiguration
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `USE_VM2` | VM2 für Sandbox-Ausführung verwenden | `false` | `true` |
|
|
| `SANDBOX_MEMORY_LIMIT` | Speicherlimit für Sandbox (MB) | `16` | `32` |
|
|
| `PUPPETEER_EXECUTABLE_PATH` | Benutzerdefinierter Pfad zur Puppeteer-Ausführbaren Datei | - | `/usr/bin/chromium` |
|
|
|
|
## Kartenintegration
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `AMAP_TOKEN` | AMap (Gaode) API-Token | - | `dein-amap-token` |
|
|
| `MAPBOX_TOKEN` | Mapbox API-Token | - | `dein-mapbox-token` |
|
|
|
|
## Telemetrie
|
|
|
|
| Variable | Beschreibung | Standard | Beispiel |
|
|
| --- | --- | --- | --- |
|
|
| `DISABLE_ANONYMOUS_TELEMETRY` | Anonyme Telemetrie deaktivieren | `false` | `true` |
|
|
| `CUSTOM_TRACKER_SCRIPT_NAME` | Benutzerdefinierter Tracker-Skriptname | - | `custom-tracker.js` |
|
|
|
|
## Festlegen von Umgebungsvariablen
|
|
|
|
Sie können diese Umgebungsvariablen auf verschiedene Weise festlegen:
|
|
|
|
1. Direkt in Ihrer Bereitstellungsumgebung festlegen (Docker, Kubernetes, etc.)
|
|
|
|
2. Für Docker-Bereitstellungen können Sie Umgebungsvariablen in Ihrer docker-compose.yml verwenden:
|
|
|
|
```yaml
|
|
services:
|
|
tianji:
|
|
image: moonrailgun/tianji:latest
|
|
environment:
|
|
- PORT=3000
|
|
- ALLOW_REGISTER=true
|
|
```
|
|
|
|
## Boolesche Werte
|
|
|
|
Für boolesche Umgebungsvariablen können Sie entweder `"1"` oder `"true"` verwenden, um die Funktion zu aktivieren, oder die Variable weglassen oder auf einen anderen Wert setzen, um sie zu deaktivieren.
|