在 Linux 上安装 Localtonet
本页内容 9 个章节
在 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 都有单独的指南。
用脚本安装 #
-
运行安装脚本 #
终端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,它会尝试用你的发行版的包管理器安装它。 -
检查安装 #
脚本结束时会输出已安装的版本。你可以随时再次输出它:
终端localtonet --version
手动安装 #
如果你更喜欢直接下载,请选择适合你系统的压缩包。每个 ZIP 都包含一个文件 localtonet。
| CPU | glibc(Debian、Ubuntu、Fedora、RHEL 及大多数其他发行版) | musl(Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM(32 位) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m 会输出你的 CPU 类型:x86_64 是 x64,aarch64 是 ARM64,armv7l 是 ARM。
-
下载并解压 #
示例使用的是 x64 glibc 版本。请把文件名替换为适合你系统的压缩包。
终端wget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
可选:把它移动到 PATH 中 #
如果不做这一步,你需要通过路径
~/localtonet/localtonet来启动客户端。做了之后,在任何文件夹中都可以直接输入localtonet。终端sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
启动客户端 #
-
用你的令牌启动 #
终端localtonet --authtoken <YOUR_TOKEN>客户端会为你的用户在本地保存令牌。下次你只需运行
localtonet即可启动。如果在没有已保存令牌的情况下启动,它会询问Please Enter AuthToken or PIN。 -
检查会话 #
终端中会显示
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 权限。
-
安装服务 #
终端sudo localtonet --install-service --authtoken <YOUR_TOKEN>该命令会为此令牌写入一个 systemd 单元,启用它并立即启动。它会回复单元的名称:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>是你令牌的前 9 个字符。每个令牌都有自己的单元,因此其他服务命令需要使用相同的--authtoken才能找到它。 -
检查它是否在运行 #
终端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>/,服务会运行这个副本。
升级 #
-
替换客户端 #
再次运行安装脚本。重复运行是安全的,它会用当前版本覆盖已安装的客户端。手动安装之后,请下载当前的压缩包并替换
localtonet文件。终端curl -fsSL https://localtonet.com/install.sh | sh -
重启服务 #
正在运行的服务在重启之前会继续使用旧版本。
终端sudo systemctl restart Localtonet_<TOKEN_PREFIX>如果服务运行的是
/usr/local/lib/之下的副本,请移除服务,并用新的客户端重新安装。
在我的令牌下,客户端列显示设备最近一次上报的版本,当有更新版本可用时会显示需要更新徽标。
卸载 #
- 如果你安装了服务,请先移除它:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - 要移除已保存的令牌,请启动客户端并按 F12。
- 删除客户端:脚本安装的话,运行
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 客户端已经在使用相同的令牌运行。请关闭它,或者用另一个令牌启动当前这个。每个令牌只运行一个客户端。