Installer une passerelle

Donnez une porte à votre NAS.

La passerelle est le petit élément de Loft qui tourne chez vous. Vos apps lui parlent, et elle parle à votre NAS, connectée en votre nom. Comptez une dizaine de minutes ; c’est à faire une seule fois.

Ce qu’il vous faut

  • Une machine Linux toujours allumée et sur le même réseau que le NAS : x86_64 ou arm64, avec Python 3.12 ou plus récent. Debian 13, Ubuntu 24.04 et la version actuelle de Raspberry Pi OS l’incluent ; sur un système plus ancien, utilisez le conteneur. Un Raspberry Pi 64 bits fait l’affaire. Si possible, utilisez une machine qui ne fait rien d’autre (voir Sécurité).
  • Un NAS ou un serveur qui partage des dossiers en SMB 3, et son adresse sur votre réseau.
  • Le nom d’utilisateur et le mot de passe de votre NAS. Vous les saisirez plus tard dans l’app, pas dans la configuration de la passerelle.

  1. Installez-la

    Bientôt disponible. La passerelle n’est pas encore disponible au téléchargement. Dès qu’elle le sera, le .deb et l’image de conteneur se trouveront sur la page Téléchargement, et les commandes pour les installer figureront ici même.

  2. Reliez-la à votre NAS

    Lancez loft-gateway init. La commande demande l’adresse de votre NAS, écrit le fichier de configuration et crée les clés de la passerelle. À la fin, elle affiche un code d’association.

    Lancez ensuite loft-gateway doctor. Cette commande vérifie que la passerelle peut joindre le NAS, quelle version de SMB et quel chiffrement le NAS propose, que l’horloge est à l’heure et que le certificat est valide. En cas de problème, elle vous dit lequel. Ajoutez --user et votre nom d’utilisateur du NAS pour vérifier aussi la connexion et les dossiers partagés. Elle demande alors le mot de passe et ne l’affiche jamais.

    Un NAS ancien sans chiffrement SMB ? Par défaut, la passerelle refuse de s’y connecter. Avec smb_encryption = "server" dans le fichier de configuration, c’est le NAS qui décide, et la connexion sur votre réseau domestique n’est chiffrée que si le NAS le demande. C’est à vous de choisir.

  3. Associez vos apps

    Lancez loft-gateway pair et scannez le code QR avec l’app Loft, ou ouvrez le lien sur l’appareil. Le code contient l’adresse de la passerelle et ses clés : l’app sait ainsi qu’elle parle à votre passerelle dès la toute première connexion. Connectez-vous ensuite avec le nom d’utilisateur et le mot de passe de votre NAS.

    Il n’y a volontairement pas de champ pour saisir l’adresse d’une passerelle : une adresse saisie à la main pourrait vous mener vers une fausse passerelle qui récolte les mots de passe. Si vous en avez vraiment besoin, l’app propose Configurer manuellement sur l’écran d’association.

  4. Hors de chez vous (facultatif)

    À la maison, rien d’autre n’est nécessaire. Pour utiliser Loft hors de chez vous, choisissez l’une de ces options :

    • Un tunnel, par exemple Cloudflare Tunnel. Aucun port ouvert sur votre routeur, mais le fournisseur du tunnel peut lire le trafic, et vous vous connectez à la maison.
    • Le mode direct, avec une redirection de port de votre routeur vers la passerelle. Chiffré de bout en bout, et vous pouvez vous connecter de n’importe où. La passerelle limite les tentatives de connexion.

    Les différences sont expliquées dans Fonctionnement. Après un changement, relancez loft-gateway pair pour que le code contienne la nouvelle adresse.

Limiter ce que Loft affiche (facultatif)

Loft affiche tous les dossiers partagés que votre compte NAS peut ouvrir, et les autorisations du NAS lui-même décident du reste. Vous pouvez restreindre davantage dans le fichier de configuration : seulement certains dossiers partagés, des dossiers ou chemins masqués, ou seulement certains utilisateurs. Tous ces réglages sont vides par défaut.

Mises à jour

La passerelle ne se met jamais à jour toute seule. Installez le nouveau .deb ou récupérez une nouvelle image de conteneur après avoir lu les notes de version. → Code source pour les notes de version et les sommes de contrôle.