Configurar un gateway

Dale una puerta a tu NAS.

El gateway es la pequeña parte de Loft que funciona en casa. Tus apps se comunican con él, y él se comunica con tu NAS, con la sesión iniciada como tú. Lleva unos diez minutos y solo se hace una vez.

Qué necesitas

  • Una máquina Linux que esté siempre encendida y en la misma red que el NAS: x86_64 o arm64, con Python 3.12 o posterior. Debian 13, Ubuntu 24.04 y la versión actual de Raspberry Pi OS lo incluyen; en un sistema más antiguo, usa el contenedor. Sirve una Raspberry Pi de 64 bits. Si puedes, usa una máquina que no haga nada más (consulta Seguridad).
  • Un NAS o servidor que comparta carpetas por SMB 3, y su dirección en tu red.
  • Tu nombre de usuario y tu contraseña del NAS. Los escribirás más adelante en la app, no en la configuración del gateway.

  1. Instalar

    Muy pronto. El gateway aún no se puede descargar. Cuando se pueda, el .deb y la imagen de contenedor estarán en Descargar, y los comandos para instalarlos estarán aquí mismo.

  2. Indícale dónde está tu NAS

    Ejecuta loft-gateway init. Te pide la dirección de tu NAS, escribe el archivo de configuración y crea las claves del gateway. Al final, muestra un código de vinculación.

    Después ejecuta loft-gateway doctor. Comprueba que el gateway llega al NAS, qué versión de SMB y qué cifrado ofrece el NAS, que el reloj está en hora y que el certificado es válido. Si algo falla, te dice qué. Añade --user y tu nombre de usuario del NAS para comprobar también el inicio de sesión y las carpetas compartidas. Te pide la contraseña y nunca la muestra.

    ¿Un NAS antiguo sin cifrado SMB? De forma predeterminada, el gateway se niega a conectarse sin él. Con smb_encryption = "server" en el archivo de configuración, decide el NAS, y la conexión en la red de casa solo se cifra si el NAS lo pide. Tú decides.

  3. Vincula tus apps

    Ejecuta loft-gateway pair y escanea el código QR con la app Loft, o abre el enlace en el dispositivo. El código contiene la dirección del gateway y sus claves, así que la app sabe que se comunica con tu gateway desde la primera conexión. Después, inicia sesión con tu nombre de usuario y tu contraseña del NAS.

    No hay ningún campo para escribir la dirección de un gateway, y es a propósito: una dirección escrita a mano podría llevarte a un gateway falso que recopila contraseñas. Si de verdad lo necesitas, la app tiene Configurar manualmente en la pantalla de vinculación.

  4. Fuera de casa (opcional)

    En casa no hace falta nada más. Para usar Loft fuera de casa, elige una opción:

    • Un túnel, por ejemplo Cloudflare Tunnel. No hay ningún puerto abierto en tu router, pero el proveedor del túnel puede leer el tráfico, e inicias sesión en casa.
    • Directo, con un puerto de tu router redirigido al gateway. Cifrado de extremo a extremo, y puedes iniciar sesión desde cualquier lugar. El gateway limita los intentos de inicio de sesión.

    Las diferencias se explican en Cómo funciona. Después de cambiarlo, vuelve a ejecutar loft-gateway pair para que el código incluya la nueva dirección.

Limitar lo que muestra Loft (opcional)

Loft muestra todas las carpetas compartidas que puede abrir tu cuenta del NAS, y los permisos del propio NAS deciden el resto. Puedes restringirlo más en el archivo de configuración: solo algunas carpetas compartidas, carpetas o rutas ocultas, o solo algunos usuarios. Todas estas opciones están vacías de forma predeterminada.

Actualizar

El gateway nunca se actualiza solo. Instala el nuevo .deb o descarga una nueva imagen de contenedor después de leer las notas de la versión. → Código fuente, con las notas de la versión y las sumas de comprobación.