Configura un gateway

Dai una porta al tuo NAS.

Il gateway è la piccola parte di Loft che gira a casa. Le tue app parlano con il gateway, e il gateway parla con il tuo NAS accedendo come te. Ci vogliono circa dieci minuti, e lo fai una volta sola.

Cosa ti serve

  • Una macchina Linux sempre accesa e sulla stessa rete del NAS: x86_64 o arm64, con Python 3.12 o successivo. Debian 13, Ubuntu 24.04 e l'attuale Raspberry Pi OS lo includono; su un sistema più vecchio, usa il container. Va bene anche un Raspberry Pi a 64 bit. Se puoi, usa una macchina che non fa altro (vedi Sicurezza).
  • Un NAS o un server che condivide cartelle tramite SMB 3, e il suo indirizzo sulla tua rete.
  • Nome utente e password del tuo NAS. Li inserirai più avanti nell'app, non nelle impostazioni del gateway.

  1. Installa

    Prossimamente. Il gateway non è ancora disponibile per il download. Quando lo sarà, il .deb e l'immagine container saranno in Download, e i comandi per installarli saranno proprio qui.

  2. Collegalo al tuo NAS

    Esegui loft-gateway init. Ti chiede l'indirizzo del NAS, scrive il file delle impostazioni e crea le chiavi del gateway. Alla fine mostra un codice di abbinamento.

    Poi esegui loft-gateway doctor. Verifica che il gateway raggiunga il NAS, quale versione di SMB e quale crittografia offre il NAS, che l'orologio sia giusto e che il certificato sia valido. Se qualcosa non va, ti dice cosa. Aggiungi --user e il tuo nome utente del NAS per verificare anche l'accesso e le cartelle condivise. Ti chiede la password e non la mostra mai.

    Un NAS più vecchio senza crittografia SMB? Per impostazione predefinita il gateway si rifiuta di collegarsi senza. Con smb_encryption = "server" nel file delle impostazioni decide invece il NAS, e la connessione sulla rete di casa è crittografata solo se è il NAS a chiederlo. La scelta è tua.

  3. Abbina le tue app

    Esegui loft-gateway pair e scansiona il codice QR con l'app Loft, oppure apri il link sul dispositivo. Il codice contiene l'indirizzo del gateway e le sue chiavi, così l'app sa di parlare con il tuo gateway fin dalla prima connessione. Poi accedi con il nome utente e la password del tuo NAS.

    Non c'è un campo per digitare l'indirizzo di un gateway, ed è voluto: un indirizzo digitato a mano potrebbe portarti a un gateway falso che raccoglie password. Se ti serve davvero, l'app ha Configura manualmente nella schermata di abbinamento.

  4. Fuori casa (facoltativo)

    A casa non serve altro. Per usare Loft fuori casa, scegli una delle due opzioni:

    • Un tunnel, per esempio Cloudflare Tunnel. Nessuna porta aperta sul router, ma il fornitore del tunnel può leggere il traffico, e l'accesso lo fai da casa.
    • Diretto, con una porta inoltrata dal router al gateway. Crittografato end-to-end, e puoi accedere da ovunque. Il gateway limita i tentativi di accesso.

    Le differenze sono spiegate in Come funziona. Dopo averlo cambiato, esegui di nuovo loft-gateway pair, così il codice include il nuovo indirizzo.

Limita cosa mostra Loft (facoltativo)

Loft mostra tutte le cartelle condivise che il tuo account del NAS può aprire, e il resto lo decidono i permessi del NAS stesso. Puoi restringere ulteriormente nel file delle impostazioni: solo alcune cartelle condivise, cartelle o percorsi nascosti, oppure solo alcuni utenti. Per impostazione predefinita, queste opzioni sono tutte vuote.

Aggiornamento

Il gateway non si aggiorna mai da solo. Installa il nuovo .deb o scarica una nuova immagine container dopo aver letto le note di rilascio. → Codice sorgente per note di rilascio e checksum.