Erste Schritte

Umgebungsvariablen

Alle Variablen, die in der aktuellen Beispielsdatei deklariert sind.

NasDash-Variablen

VariableUmgebungErforderlichWirkung
NEXT_PUBLIC_DASHBOARD_TITLEEntwicklung / BuildneinFallback beim Build ohne gespeicherten Titel; normalerweise Einstellungen → Kopfzeile verwenden; Beispiel NASDASH
NASDASH_ADMIN_PASSWORDProduktionnein; nur neue Kontenerstes Passwort für admin anstelle eines generierten Einrichtungscodes
NASDASH_VIEWER_PASSWORDältere Initialisierungneininitialisiert nur einen vorhandenen älteren viewer-Platzhalter; erstellt bei Neuinstallationen keinen Leser und setzt nicht das Passwort des im öffentlichen Modus erstellten Kontos
NASDASH_JWT_SECRETProduktionnein; erweiterte VorgabeStabiles Geheimnis für Sitzungen und verschlüsselte Zugangsdaten
NASDASH_DATA_DIRErweitert / TestneinErsetzt das Verzeichnis für Daten, normalerweise <project>/data
NASDASH_ALLOWED_DEV_ORIGINSNur EntwicklungneinListe von Hosts/IPs, die berechtigt sind, npm run dev:lan von einem anderen privaten Gerät aus zu öffnen
NASDASH_DEMO_MODENur DemoneinAktiviert 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.0

Generieren des Geheimnisses

openssl rand -hex 32

Ein 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 nasdash

Setzen 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.