跳到内容
Localtonet Localtonet 控制台

在 Linux 上安装 Localtonet

获取本页帮助
本页内容 9 个章节
  1. 开始之前
  2. 用脚本安装
  3. 运行安装脚本
  4. 检查安装
  5. 手动安装
  6. 下载并解压
  7. 可选:把它移动到 PATH 中
  8. 启动客户端
  9. 用你的令牌启动
  10. 检查会话
  11. 作为 systemd 服务运行
  12. 安装服务
  13. 检查它是否在运行
  14. 服务命令
  15. 单元及其日志
  16. 升级
  17. 替换客户端
  18. 重启服务
  19. 卸载
  20. 故障排除
  21. 相关页面

在 Linux 上,Localtonet 客户端是一个单独的控制台程序。你可以用安装脚本或 ZIP 压缩包安装它,用 AuthToken 启动它,如果希望每次重启后都自动启动,还可以把它安装为 systemd 服务。

开始之前 #

  • 一个 Localtonet 账户。如果还没有,请免费创建一个。
  • 你的 AuthToken。在控制台的 AuthToken 卡片上选择复制,或者从我的令牌中复制一个令牌。
  • curl 或 wget,以及 unzip。
  • 对于 systemd 服务:root 权限,以及使用 systemd 的发行版。

在 Linux 上运行 Localtonet 的其他方式。在 Debian、Ubuntu、Fedora 和 RHEL 上,你可以安装自带服务的 DEB 或 RPM 软件包。Docker、OpenWrt 路由器以及 Android 上的 Termux 都有单独的指南。

用脚本安装 #

  1. 运行安装脚本 #

    终端
    curl -fsSL https://localtonet.com/install.sh | sh

    脚本会检测你的 CPU(x64、ARM64 或 ARM)以及系统使用的是 glibc 还是 musl,下载匹配的版本并安装到 /usr/local/bin/localtonet。它还会创建链接 /usr/bin/localtonet,这样在 sudo 不搜索 /usr/local/bin 的发行版上,sudo localtonet 也能正常工作。

    当你的用户无法写入安装文件夹时,脚本会使用 sudo,所以它可能会要求你输入密码。如果缺少 unzip,它会尝试用你的发行版的包管理器安装它。

  2. 检查安装 #

    脚本结束时会输出已安装的版本。你可以随时再次输出它:

    终端
    localtonet --version

手动安装 #

如果你更喜欢直接下载,请选择适合你系统的压缩包。每个 ZIP 都包含一个文件 localtonet。

CPUglibc(Debian、Ubuntu、Fedora、RHEL 及大多数其他发行版)musl(Alpine)
x64localtonet-linux-x64.ziplocaltonet-linux-musl-x64.zip
ARM64localtonet-linux-arm64.ziplocaltonet-linux-musl-arm64.zip
ARM(32 位)localtonet-linux-arm.ziplocaltonet-linux-musl-arm.zip

uname -m 会输出你的 CPU 类型:x86_64 是 x64,aarch64 是 ARM64,armv7l 是 ARM。

  1. 下载并解压 #

    示例使用的是 x64 glibc 版本。请把文件名替换为适合你系统的压缩包。

    终端
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. 可选:把它移动到 PATH 中 #

    如果不做这一步,你需要通过路径 ~/localtonet/localtonet 来启动客户端。做了之后,在任何文件夹中都可以直接输入 localtonet。

    终端
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

启动客户端 #

  1. 用你的令牌启动 #

    终端
    localtonet --authtoken <YOUR_TOKEN>

    客户端会为你的用户在本地保存令牌。下次你只需运行 localtonet 即可启动。如果在没有已保存令牌的情况下启动,它会询问 Please Enter AuthToken or PIN。

  2. 检查会话 #

    终端中会显示 Session Status: Connected,下方的表格每个正在运行的隧道占一行:IP/Url、Protocol、Client IP、Client Port、Ping 和 Status。在你于控制台中启动隧道之前,表格是空的,参见快速开始。

    按 Ctrl + C 停止客户端。按 F12 移除已保存的令牌并退出。

当输出不是终端时,例如你把它重定向到文件,客户端会在每次变化时写入一行纯文本,而不是表格。

VPN 需要 root 权限。如果设备属于某个 VPN 管理器网络,而客户端不是以 root 运行的,表格的 VPN 行会显示 Admin rights required.。这时请用 sudo 启动客户端,或者让它作为服务运行。

作为 systemd 服务运行 #

服务会在每次重启后启动 Localtonet,在你退出登录后保持运行,并且不需要打开终端。服务命令需要 root 权限。

  1. 安装服务 #

    终端
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    该命令会为此令牌写入一个 systemd 单元,启用它并立即启动。它会回复单元的名称:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> 是你令牌的前 9 个字符。每个令牌都有自己的单元,因此其他服务命令需要使用相同的 --authtoken 才能找到它。

  2. 检查它是否在运行 #

    终端
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    服务正在运行时,会回复 [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running。在控制台的我的令牌下,该令牌显示为在线。

服务命令 #

请在每条命令前加上 sudo,并添加 --authtoken <YOUR_TOKEN>。

命令作用
--install-service写入单元文件,启用该单元并启动它。
--start-service启动该单元,例如在你停止它之后。
--stop-service停止该单元。它仍保持启用状态,重启后会再次启动。
--status-service输出状态,例如 Running、Stopped,或单元失败时的 Error。
--remove-service停止并禁用该单元,然后删除单元文件。

服务会使用你与 --install-service 一起传入的选项来安装。这些选项列在 CLI 参考中。

单元及其日志 #

单元文件是 /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service。客户端失败五秒后,systemd 会重新启动它。因为它是普通的 systemd 单元,所以你也可以用 systemctl 管理它,并用 journalctl 读取它的输出:

终端
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

该单元会从你安装服务时 localtonet 文件所在的路径启动它。有一个例外:如果该路径位于 /root/ 之下,安装命令会把文件复制到 /usr/local/lib/Localtonet_<TOKEN_PREFIX>/,服务会运行这个副本。

升级 #

  1. 替换客户端 #

    再次运行安装脚本。重复运行是安全的,它会用当前版本覆盖已安装的客户端。手动安装之后,请下载当前的压缩包并替换 localtonet 文件。

    终端
    curl -fsSL https://localtonet.com/install.sh | sh
  2. 重启服务 #

    正在运行的服务在重启之前会继续使用旧版本。

    终端
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    如果服务运行的是 /usr/local/lib/ 之下的副本,请移除服务,并用新的客户端重新安装。

在我的令牌下,客户端列显示设备最近一次上报的版本,当有更新版本可用时会显示需要更新徽标。

卸载 #

  1. 如果你安装了服务,请先移除它:sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. 要移除已保存的令牌,请启动客户端并按 F12。
  3. 删除客户端:脚本安装的话,运行 sudo rm /usr/local/bin/localtonet /usr/bin/localtonet;否则删除你解压压缩包的文件夹。

故障排除 #

安装脚本:Unsupported architecture

脚本提供 x64(x86_64)、ARM64(aarch64)和 32 位 ARM(armv7l)的版本。Linux 版本不支持其他 CPU 类型。

安装脚本:Neither curl nor wget found

请用你的包管理器安装 curl 或 wget,然后再次运行脚本。

安装脚本:Failed to install 'unzip'

脚本无法自行安装 unzip。请用你的包管理器安装它,然后再次运行脚本。

Installed but not found in PATH

请打开一个新的 shell,或者用完整路径 /usr/local/bin/localtonet 启动客户端。

sudo: localtonet: command not found

手动安装之后,客户端不在 sudo 的搜索路径中。请使用完整路径,例如 sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>,或者先把文件移动到 /usr/local/bin。

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

该命令不是以 root 运行的。请加上 sudo 重复该命令。--start-service、--stop-service 和 --remove-service 同样如此。

Install failed: Systemd unit already exists for 'Localtonet_…'

此令牌的服务已经安装。请用 --status-service 检查。如果要重新安装,请先运行 --remove-service。

在没有 systemd 的系统上,服务命令会失败

服务模式使用 systemd。在没有它的系统上,请用其他方式启动客户端,例如在 Docker 容器中。控制台客户端为此提供了无头模式:--headless 不显示提示,并从 --authtoken-file 指定的文件中读取令牌。参见 CLI 参考。

Wrong Token!

客户端需要来自我的令牌的 33 个字符的 AuthToken,或者一个尚未过期的 6 位 PIN。请重新复制令牌,并在提示处输入。

This token is used in another localtonet application!

这台机器上的另一个 Localtonet 客户端已经在使用相同的令牌运行。请关闭它,或者用另一个令牌启动当前这个。每个令牌只运行一个客户端。

支持