Gateway einrichten

Gib deinem NAS eine Tür.

Das Gateway ist der kleine Teil von Loft, der zu Hause läuft. Deine Apps sprechen mit ihm, und es spricht mit deinem NAS, in deinem Namen angemeldet. Die Einrichtung dauert etwa zehn Minuten, und du machst sie nur einmal.

Was du brauchst

  • Einen Linux-Rechner, der immer läuft und im selben Netzwerk wie das NAS ist: x86_64 oder arm64, mit Python 3.12 oder neuer. Debian 13, Ubuntu 24.04 und das aktuelle Raspberry Pi OS bringen das mit; auf einem älteren System nimmst du den Container. Ein 64-Bit-Raspberry-Pi reicht. Nimm nach Möglichkeit einen Rechner, der sonst nichts tut (siehe Sicherheit).
  • Ein NAS oder einen Server, der Ordner über SMB 3 freigibt, und seine Adresse in deinem Netzwerk.
  • Deinen NAS-Benutzernamen und dein Passwort. Die gibst du später in der App ein, nicht in den Einstellungen des Gateways.

  1. Installieren

    Demnächst verfügbar. Das Gateway kann noch nicht heruntergeladen werden. Sobald es so weit ist, findest du das .deb und das Container-Image unter Download, und die Befehle zum Installieren stehen genau hier.

  2. Auf dein NAS verweisen

    Führe loft-gateway init aus. Es fragt nach der Adresse deines NAS, schreibt die Einstellungsdatei und erzeugt die Schlüssel des Gateways. Am Ende zeigt es einen Kopplungscode an.

    Führe dann loft-gateway doctor aus. Es prüft, ob das Gateway das NAS erreicht, welche SMB-Version und Verschlüsselung das NAS anbietet, ob die Uhr richtig geht und ob das Zertifikat gültig ist. Wenn etwas nicht stimmt, sagt es dir, was. Gib --user und deinen NAS-Benutzernamen dazu, um auch die Anmeldung und die freigegebenen Ordner zu prüfen. Es fragt nach dem Passwort und gibt es nie aus.

    Ein älteres NAS ohne SMB-Verschlüsselung? Standardmäßig verbindet sich das Gateway nicht ohne sie. Mit smb_encryption = "server" in der Einstellungsdatei entscheidet stattdessen das NAS, und die Verbindung in deinem Heimnetz wird nur verschlüsselt, wenn das NAS es verlangt. Du entscheidest.

  3. Deine Apps koppeln

    Führe loft-gateway pair aus und scanne den QR-Code mit der Loft-App oder öffne den Link auf dem Gerät. Der Code enthält die Adresse und die Schlüssel des Gateways, damit die App schon bei der ersten Verbindung weiß, dass sie mit deinem Gateway spricht. Melde dich dann mit deinem NAS-Benutzernamen und Passwort an.

    Ein Feld zum Eintippen einer Gateway-Adresse gibt es absichtlich nicht: Eine eingetippte Adresse könnte dich zu einem gefälschten Gateway führen, das Passwörter sammelt. Wenn du es wirklich brauchst, hat die App Manuell einrichten auf dem Kopplungsbildschirm.

  4. Unterwegs (optional)

    Zu Hause brauchst du nichts weiter. Um Loft unterwegs zu nutzen, wähle eins von beiden:

    • Einen Tunnel, zum Beispiel Cloudflare Tunnel. Kein offener Port auf deinem Router, aber der Tunnelanbieter kann den Datenverkehr lesen, und du meldest dich zu Hause an.
    • Direkt, mit einer Portweiterleitung auf deinem Router zum Gateway. Ende-zu-Ende verschlüsselt, und du kannst dich überall anmelden. Das Gateway begrenzt die Anmeldeversuche.

    Die Unterschiede erklärt So funktioniert’s. Führe loft-gateway pair nach einer Änderung erneut aus, damit der Code die neue Adresse enthält.

Einschränken, was Loft zeigt (optional)

Loft zeigt jeden freigegebenen Ordner, den dein NAS-Konto öffnen darf, und den Rest entscheiden die Berechtigungen des NAS. In der Einstellungsdatei kannst du das weiter eingrenzen: nur bestimmte freigegebene Ordner, ausgeblendete Ordner oder Pfade oder nur bestimmte Benutzer. All das ist standardmäßig leer.

Aktualisieren

Das Gateway aktualisiert sich nie selbst. Installiere das neue .deb oder hol ein neues Container-Image, nachdem du die Versionshinweise gelesen hast. → Quellcode für Versionshinweise und Prüfsummen.