Umgebungsvariablen
Alle Variablen, die in der aktuellen Beispielsdatei deklariert sind.
NasDash-Variablen
| Variable | Umgebung | Erforderlich | Wirkung |
|---|---|---|---|
NEXT_PUBLIC_DASHBOARD_TITLE | Entwicklung / Build | nein | Fallback beim Build ohne gespeicherten Titel; normalerweise Einstellungen → Kopfzeile verwenden; Beispiel NASDASH |
NASDASH_ADMIN_PASSWORD | Produktion | nein; nur neue Konten | erstes Passwort für admin anstelle eines generierten Einrichtungscodes |
NASDASH_VIEWER_PASSWORD | ältere Initialisierung | nein | initialisiert nur einen vorhandenen älteren viewer-Platzhalter; erstellt bei Neuinstallationen keinen Leser und setzt nicht das Passwort des im öffentlichen Modus erstellten Kontos |
NASDASH_JWT_SECRET | Produktion | nein; erweiterte Vorgabe | Stabiles Geheimnis für Sitzungen und verschlüsselte Zugangsdaten |
NASDASH_DATA_DIR | Erweitert / Test | nein | Ersetzt das Verzeichnis für Daten, normalerweise <project>/data |
NASDASH_ALLOWED_DEV_ORIGINS | Nur Entwicklung | nein | Liste von Hosts/IPs, die berechtigt sind, npm run dev:lan von einem anderen privaten Gerät aus zu öffnen |
NASDASH_DEMO_MODE | Nur Demo | nein | Aktiviert fiktive Testdaten und deaktiviert echte Verbindungen |
Image-Variablen
Das Image legt diese Standardwerte fest; Compose lädt eine optionale Umgebungsdatei:
NODE_ENV=production
PORT=2504
HOSTNAME=0.0.0.0Generieren des Geheimnisses
openssl rand -hex 32Ein Umgebungsgeheimnis ist nicht erforderlich: NasDash speichert jwt.secret und encryption.key im Datenverzeichnis. Nutzen Sie NASDASH_JWT_SECRET nur als erweiterte Vorgabe bei der Erstinstallation. Behalten Sie nach Verschlüsselung der Zugangsdaten dieselbe Schlüsselkonfiguration bei Neustarts, Sicherungen und Updates bei: Hinzufügen oder Ändern kann Daten unlesbar machen und Sitzungen verwerfen.
Ohne vorgegebenes Passwort
Bei einer Neuinstallation zeigt NasDash einmalig Setup code: XXXX-XXXX-XXXX im Protokoll. Dies ist das erste Administratorpasswort. Geben Sie es auf dem Einrichtungsbildschirm ein und wählen Sie dann im Leitfaden ein neues Passwort mit mindestens 12 Zeichen. Standardmäßig wird kein Leser erstellt.
docker compose logs nasdashSetzen Sie Passwörter für bestehende Konten unter Einstellungen → Benutzer und Zugriff. Änderungen an Umgebungsvariablen setzen bestehende Passwörter niemals zurück. Nutzen Sie bei verlorenem Zugang die Offline-Wiederherstellung.
.env-Datei
NASDASH_ADMIN_PASSWORD=replace-with-a-unique-password
NASDASH_JWT_SECRET=replace-with-a-stable-random-secret.env niemals in die Versionskontrolle einchecken. Kopieren Sie ein Produktionsgeheimnis nicht in die öffentliche Demo oder einen Fehlerbericht.
Bei Anfragelimits werden weitergeleitete Client-Adressen standardmäßig ignoriert. Aktivieren Sie NASDASH_TRUST_PROXY=true nur hinter einem vertrauenswürdigen Proxy, der Client-Header überschreibt und direkten NasDash-Zugriff verhindert. Andernfalls bleibt NASDASH_TRUST_PROXY=false. Die Einstellung ändert nur die Identität für Limits, nicht HTTPS-Erkennung oder Authentifizierungscookies. Fehlgeschlagene Anmeldungen werden zusätzlich pro Konto begrenzt, unabhängig von Weiterleitungsheadern.