安装 Localtonet 客户端
本页内容 5 个章节
Localtonet 客户端运行在托管你服务的设备上,并保持与 Localtonet 之间的隧道畅通。本页列出受支持的平台,帮助你选择合适的安装方式,并链接到每种方式的指南。
受支持的平台 #
所有下载内容都在下载页面。
| 平台 | 可以安装的内容 | 架构 |
|---|---|---|
| Windows | Microsoft Store 应用、便携式桌面应用、控制台客户端 | 64 位(x64)、32 位(x86)、ARM64 |
| macOS | 控制台客户端,通过 Homebrew 或 ZIP 压缩包安装 | Intel(x64)、Apple Silicon(ARM64) |
| Linux | 控制台客户端,通过安装脚本或 ZIP 压缩包安装 | x64、ARM 和 ARM64,每种都分 glibc 和 musl 版本 |
| Linux 软件包 | 带 systemd 服务的 DEB 和 RPM 软件包 | x64、ARM64 |
| Android | 来自 Google Play 或 APK 文件的 Android 应用 | 该应用要求的最低 Android 版本为 5.0 |
| Termux | 作为 Termux 软件包的控制台客户端 | ARM64 |
| Docker | 官方镜像 localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | 适用于 OpenWrt 24.10 和 25.12+ 的路由器软件包(实验性) | x64、ARM64 |
| NAS 和 Home Assistant | Docker Compose 和 Home Assistant 安装模板 | AMD64, ARM64 |
| 免安装 SSH | 无需安装任何东西。你使用已有的 SSH 客户端。 | 任何带有 SSH 客户端的设备 |
选择安装方式 #
| 选项 | 说明 | 适合在这些情况下选择 |
|---|---|---|
| 控制台客户端 | 适用于 Windows、macOS 和 Linux 的 localtonet 程序。你在终端中用 AuthToken 启动它。它以实时表格显示你的隧道,并且可以把自己安装为服务。 | 你在终端中工作,或者设备是没有桌面环境的服务器。 |
| 桌面应用 | 适用于 Windows、带登录窗口的 Localtonet 应用,来自 Microsoft Store 或作为便携式 ZIP。 | 在 Windows 上,你更喜欢应用窗口而不是终端。 |
| 移动应用 | 适用于 Android 的 Localtonet 应用。你用二维码、PIN 或令牌登录。 | 设备是 Android 手机或平板,例如用于移动代理。 |
| 软件包 | 适用于 Linux 的 DEB 和 RPM 软件包、适用于 Android 的 Termux 软件包,以及实验性的 OpenWrt 软件包。Linux 和 OpenWrt 软件包自带一个从文件读取令牌的服务。 | 你希望由系统的软件包管理器来安装和移除客户端,并有一个开机启动的服务。 |
| 容器 | 官方 Docker 镜像,以及使用它的 NAS 设备和 Home Assistant 安装模板。 | 你的服务已经运行在容器中,或者设备是 NAS。 |
| 免安装 SSH | 控制台会生成一条用于打开隧道的 ssh 命令,无需下载任何内容。它适用于 HTTP 和 TCP 隧道。 | 你无法或不想在设备上安装任何东西。 |
所有安装方式的共同点 #
-
客户端用 AuthToken 登录 #
AuthToken 把一台设备连接到你的账户。你可以在控制台的 AuthToken 卡片上用复制复制它,或者在我的令牌下为每台设备创建一个命名的令牌。令牌的说明见 AuthToken。
请保管好你的令牌。任何拥有令牌的人都可以用它登录应用。
-
用该令牌启动客户端 #
把
<YOUR_TOKEN>替换为你的令牌。Windows
打开 Localtonet 应用并粘贴你的 AuthToken,或者在包含
localtonet.exe的文件夹中,于命令提示符里运行控制台客户端:命令提示符localtonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
打开 Localtonet 应用,然后扫描令牌的二维码、输入它的 PIN 或粘贴令牌,并选择 Connect。二维码和 PIN 位于我的令牌下。
控制台客户端会把令牌保存在本地,因此下次只需用
localtonet即可启动。当你在没有已保存令牌的情况下启动它时,它会询问Please Enter AuthToken or PIN。 -
在控制台中创建并启动隧道 #
客户端不需要事先知道你的隧道。你在我的隧道下创建隧道并选择设备令牌,用该令牌登录的客户端就会为它提供服务。快速入门会带你完成第一个隧道。
-
客户端必须保持运行 #
当客户端用你的 AuthToken 运行并且隧道已启动时,隧道才会上线。我的令牌会把每台设备显示为在线或离线。离线表示设备已断开连接,即使它的隧道仍然配置着。
若要在你关闭终端、注销或重启设备后让客户端继续运行,请把它安装为服务:
平台 方法 Windows 在以管理员身份运行的终端中执行 localtonet --install-service --authtoken <YOUR_TOKEN>macOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>DEB、RPM 和 OpenWrt 软件包 软件包中已包含服务。设置好令牌后启用它即可。 Android 应用会在后台持续运行,并在手机重启后再次打开。 详细信息见作为服务运行和各个平台的页面。
让客户端保持最新 #
我的令牌下的客户端列显示每台设备最近上报的版本。有更新的版本时,需要更新标记会链接到下载页面。控制台客户端也会在其隧道表下方显示 New Version available,而 localtonet --version 会输出已安装的版本。