设置网关

给你的 NAS 开一扇门。

网关是 Loft 在家中运行的那一小部分。你的应用与它通信,它再以你的身份登录 NAS 并与之通信。整个过程大约十分钟,而且只需做一次。

你需要准备

  • 一台始终开机、与 NAS 在同一网络中的 Linux 机器:x86_64 或 arm64,需要 Python 3.12 或更高版本。Debian 13、Ubuntu 24.04 和当前版本的 Raspberry Pi OS 都已自带;在较旧的系统上,请使用容器。64 位树莓派即可。如果条件允许,请使用一台不做其他事情的机器(参见安全)。
  • 一台通过 SMB 3 共享文件夹的 NAS 或服务器,以及它在你网络中的地址。
  • 你的 NAS 用户名和密码。稍后你会在应用中输入它们,而不是在网关的设置里。
  1. 安装

    即将推出。网关暂时还不能下载。届时,.deb 和容器镜像会出现在下载页面,安装命令也会放在这里。

  2. 让它指向你的 NAS

    运行 loft-gateway init。它会询问 NAS 的地址,写入配置文件并生成网关的密钥。最后,它会显示一个配对码。

    然后运行 loft-gateway doctor。它会检查网关能否连接到 NAS、NAS 提供哪个 SMB 版本和哪种加密、系统时钟是否准确,以及证书是否有效。如果有问题,它会告诉你问题出在哪里。加上 --user 和你的 NAS 用户名,还能检查登录和共享文件夹。它会询问密码,但从不显示出来。

    较旧的 NAS 不支持 SMB 加密?默认情况下,网关会拒绝建立未加密的连接。在配置文件中设置 smb_encryption = "server" 后,改由 NAS 决定:只有 NAS 要求加密时,家庭网络上的连接才会加密。这由你自己决定。

  3. 配对你的应用

    运行 loft-gateway pair,用 Loft 应用扫描二维码,或在设备上打开链接。二维码中包含网关的地址和密钥,因此从第一次连接起,应用就知道它连接的是你的网关。然后用你的 NAS 用户名和密码登录。

    应用特意没有提供输入网关地址的输入框:手动输入的地址可能把你引向骗取密码的假冒网关。如果确实需要,可以在应用的配对界面上找到手动设置。

  4. 在外使用(可选)

    在家使用无需额外设置。要在外使用 Loft,请选择其中一种方式:

    • 隧道,例如 Cloudflare Tunnel。路由器上无需开放端口,但隧道服务商可以读取流量,而且你需要在家登录。
    • 直连,在路由器上把一个端口转发到网关。端到端加密,可以在任何地方登录。网关会限制登录尝试次数。

    两者的区别详见工作原理。更改后请重新运行 loft-gateway pair,让配对码包含新的地址。

限制 Loft 显示的内容(可选)

Loft 会显示你的 NAS 账户能打开的所有共享文件夹,其余由 NAS 自身的权限决定。你可以在配置文件中进一步缩小范围:只显示部分共享文件夹、隐藏某些文件夹或路径,或只允许部分用户使用。这些设置默认都为空。

更新

网关从不自动更新。请在阅读版本说明后安装新的 .deb 或拉取新的容器镜像。版本说明和校验和:→ 源代码