Configurar um gateway

Dê uma porta ao seu NAS.

O gateway é a pequena parte do Loft que roda em casa. Seus apps falam com ele, e ele fala com o seu NAS, conectado como você. Leva uns dez minutos, e você só faz isso uma vez.

Do que você precisa

  • Uma máquina Linux sempre ligada e na mesma rede do NAS: x86_64 ou arm64, com Python 3.12 ou mais recente. O Debian 13, o Ubuntu 24.04 e o Raspberry Pi OS atual já vêm com ele; em um sistema mais antigo, use o contêiner. Um Raspberry Pi de 64 bits serve. Se puder, use uma máquina que não faça mais nada (veja Segurança).
  • Um NAS ou servidor que compartilhe pastas por SMB 3, e o endereço dele na sua rede.
  • O nome de usuário e a senha do seu NAS. Você vai digitá-los no app depois, não nas configurações do gateway.

  1. Instale

    Em breve. O gateway ainda não está disponível para download. Quando estiver, o .deb e a imagem de contêiner vão estar em Download, e os comandos para instalá-los vão estar aqui mesmo.

  2. Aponte para o seu NAS

    Execute loft-gateway init. Ele pede o endereço do seu NAS, grava o arquivo de configuração e cria as chaves do gateway. No final, mostra um código de pareamento.

    Depois execute loft-gateway doctor. Ele verifica se o gateway consegue acessar o NAS, qual versão de SMB e qual criptografia o NAS oferece, se o relógio está certo e se o certificado é válido. Se algo estiver errado, ele diz o quê. Adicione --user e o seu nome de usuário do NAS para verificar também o login e as pastas compartilhadas. Ele pede a senha e nunca a exibe.

    Um NAS mais antigo sem criptografia SMB? Por padrão, o gateway se recusa a conectar sem ela. Com smb_encryption = "server" no arquivo de configuração, quem decide é o NAS, e a conexão na sua rede de casa só é criptografada se o NAS pedir. A escolha é sua.

  3. Pareie seus apps

    Execute loft-gateway pair e escaneie o código QR com o app Loft ou abra o link no dispositivo. O código traz o endereço e as chaves do gateway, então o app sabe que está falando com o seu gateway desde a primeira conexão. Depois, entre com o nome de usuário e a senha do seu NAS.

    Não existe um campo para digitar o endereço de um gateway, e isso é proposital: um endereço digitado poderia levar você a um gateway falso que coleta senhas. Se você realmente precisar, o app tem Configurar manualmente na tela de pareamento.

  4. Fora de casa (opcional)

    Em casa, não é preciso mais nada. Para usar o Loft fora de casa, escolha uma opção:

    • Um túnel, por exemplo o Cloudflare Tunnel. Nenhuma porta aberta no roteador, mas o provedor do túnel pode ler o tráfego, e você entra em casa.
    • Direto, com uma porta do seu roteador redirecionada para o gateway. Criptografado de ponta a ponta, e você pode entrar de qualquer lugar. O gateway limita as tentativas de login.

    As diferenças estão explicadas em Como funciona. Execute loft-gateway pair de novo depois de mudar isso, para que o código inclua o novo endereço.

Limitar o que o Loft mostra (opcional)

O Loft mostra todas as pastas compartilhadas que a sua conta do NAS pode abrir, e as próprias permissões do NAS decidem o resto. Você pode restringir ainda mais no arquivo de configuração: só algumas pastas compartilhadas, pastas ou caminhos a ocultar, ou só alguns usuários. Tudo isso vem vazio por padrão.

Atualizações

O gateway nunca se atualiza sozinho. Instale o novo .deb ou baixe uma nova imagem de contêiner depois de ler as notas de versão. → Código-fonte para notas de versão e checksums.