Gateway instellen

Geef je NAS een deur.

De gateway is het kleine stukje Loft dat thuis draait. Je apps praten met de gateway, en de gateway praat met je NAS, ingelogd als jou. Het kost ongeveer tien minuten, en je doet het maar één keer.

Wat je nodig hebt

  • Een Linux-machine die altijd aanstaat en op hetzelfde netwerk zit als de NAS: x86_64 of arm64, met Python 3.12 of nieuwer. Debian 13, Ubuntu 24.04 en het huidige Raspberry Pi OS hebben dat; gebruik op een ouder systeem de container. Een 64-bits Raspberry Pi volstaat. Gebruik zo mogelijk een machine die verder niets doet (zie Beveiliging).
  • Een NAS of server die mappen deelt via SMB 3, en het adres ervan op je netwerk.
  • Je gebruikersnaam en wachtwoord van de NAS. Die typ je later in de app, niet in de instellingen van de gateway.

  1. Installeren

    Binnenkort beschikbaar. De gateway is nog niet te downloaden. Zodra dat wel kan, staan de .deb en het container-image op Downloaden, en vind je de opdrachten om ze te installeren hier.

  2. Wijs hem je NAS aan

    Voer loft-gateway init uit. Die vraagt om het adres van je NAS, schrijft het instellingenbestand en maakt de sleutels van de gateway aan. Aan het eind toont hij een koppelcode.

    Voer daarna loft-gateway doctor uit. Die controleert of de gateway de NAS kan bereiken, welke SMB-versie en versleuteling de NAS aanbiedt, of de klok goed staat en of het certificaat geldig is. Is er iets mis, dan vertelt hij wat. Voeg --user en je gebruikersnaam op de NAS toe om ook het inloggen en de gedeelde mappen te controleren. Hij vraagt om het wachtwoord en toont het nooit.

    Een oudere NAS zonder SMB-versleuteling? Standaard weigert de gateway zonder versleuteling verbinding te maken. Met smb_encryption = "server" in het instellingenbestand beslist de NAS, en is de verbinding op je thuisnetwerk alleen versleuteld als de NAS daarom vraagt. Jij kiest.

  3. Koppel je apps

    Voer loft-gateway pair uit en scan de QR-code met de Loft-app, of open de link op het apparaat. De code bevat het adres en de sleutels van de gateway, zodat de app vanaf de allereerste verbinding weet dat hij met jouw gateway praat. Log daarna in met je gebruikersnaam en wachtwoord van de NAS.

    Er is bewust geen veld om een gatewayadres te typen: een getypt adres kan je naar een nep-gateway leiden die wachtwoorden verzamelt. Heb je het echt nodig, dan heeft de app Handmatig instellen op het koppelscherm.

  4. Onderweg (optioneel)

    Thuis is er niets meer nodig. Wil je Loft onderweg gebruiken, kies dan een van deze twee:

    • Een tunnel, bijvoorbeeld Cloudflare Tunnel. Geen open poort op je router, maar de tunnelaanbieder kan het verkeer lezen, en je logt thuis in.
    • Direct, met een poort op je router die naar de gateway wordt doorgestuurd. End-to-end versleuteld, en je kunt overal inloggen. De gateway beperkt het aantal inlogpogingen.

    De verschillen staan uitgelegd in Hoe het werkt. Voer na een wijziging opnieuw loft-gateway pair uit, zodat de code het nieuwe adres bevat.

Beperken wat Loft toont (optioneel)

Loft toont elke gedeelde map die je NAS-account kan openen, en de eigen rechten van de NAS bepalen de rest. In het instellingenbestand kun je het verder inperken: alleen bepaalde gedeelde mappen, verborgen mappen of paden, of alleen bepaalde gebruikers. Standaard is dat allemaal leeg.

Bijwerken

De gateway werkt zichzelf nooit bij. Installeer de nieuwe .deb of haal een nieuw container-image op nadat je de releaseopmerkingen hebt gelezen. → Broncode voor releaseopmerkingen en controlegetallen.