跳到内容
Localtonet Localtonet 控制台

安装 Localtonet 客户端

获取本页帮助
本页内容 5 个章节
  1. 受支持的平台
  2. 选择安装方式
  3. 所有安装方式的共同点
  4. 客户端用 AuthToken 登录
  5. 用该令牌启动客户端
  6. 在控制台中创建并启动隧道
  7. 客户端必须保持运行
  8. 让客户端保持最新
  9. 安装指南

Localtonet 客户端运行在托管你服务的设备上,并保持与 Localtonet 之间的隧道畅通。本页列出受支持的平台,帮助你选择合适的安装方式,并链接到每种方式的指南。

受支持的平台 #

所有下载内容都在下载页面。

平台可以安装的内容架构
WindowsMicrosoft 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/localtonetAMD64, ARM64
OpenWrt适用于 OpenWrt 24.10 和 25.12+ 的路由器软件包(实验性)x64、ARM64
NAS 和 Home AssistantDocker 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 隧道。你无法或不想在设备上安装任何东西。

所有安装方式的共同点 #

  1. 客户端用 AuthToken 登录 #

    AuthToken 把一台设备连接到你的账户。你可以在控制台的 AuthToken 卡片上用复制复制它,或者在我的令牌下为每台设备创建一个命名的令牌。令牌的说明见 AuthToken。

    请保管好你的令牌。任何拥有令牌的人都可以用它登录应用。

  2. 用该令牌启动客户端 #

    把 <YOUR_TOKEN> 替换为你的令牌。

    Windows

    打开 Localtonet 应用并粘贴你的 AuthToken,或者在包含 localtonet.exe 的文件夹中,于命令提示符里运行控制台客户端:

    命令提示符
    localtonet --authtoken <YOUR_TOKEN>

    macOS

    Bash
    brew tap localtonet/tap
    brew install localtonet
    localtonet --authtoken <YOUR_TOKEN>

    Linux

    Bash
    curl -fsSL https://localtonet.com/install.sh | sh
    localtonet --authtoken <YOUR_TOKEN>

    Docker

    Bash
    docker pull localtonet/localtonet
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    Android

    打开 Localtonet 应用,然后扫描令牌的二维码、输入它的 PIN 或粘贴令牌,并选择 Connect。二维码和 PIN 位于我的令牌下。

    控制台客户端会把令牌保存在本地,因此下次只需用 localtonet 即可启动。当你在没有已保存令牌的情况下启动它时,它会询问 Please Enter AuthToken or PIN。

  3. 在控制台中创建并启动隧道 #

    客户端不需要事先知道你的隧道。你在我的隧道下创建隧道并选择设备令牌,用该令牌登录的客户端就会为它提供服务。快速入门会带你完成第一个隧道。

  4. 客户端必须保持运行 #

    当客户端用你的 AuthToken 运行并且隧道已启动时,隧道才会上线。我的令牌会把每台设备显示为在线或离线。离线表示设备已断开连接,即使它的隧道仍然配置着。

    若要在你关闭终端、注销或重启设备后让客户端继续运行,请把它安装为服务:

    平台方法
    Windows在以管理员身份运行的终端中执行 localtonet --install-service --authtoken <YOUR_TOKEN>
    macOS, Linuxsudo localtonet --install-service --authtoken <YOUR_TOKEN>
    DEB、RPM 和 OpenWrt 软件包软件包中已包含服务。设置好令牌后启用它即可。
    Android应用会在后台持续运行,并在手机重启后再次打开。

    详细信息见作为服务运行和各个平台的页面。

让客户端保持最新 #

我的令牌下的客户端列显示每台设备最近上报的版本。有更新的版本时,需要更新标记会链接到下载页面。控制台客户端也会在其隧道表下方显示 New Version available,而 localtonet --version 会输出已安装的版本。

安装指南 #

支持