跳到内容
Localtonet Localtonet 控制台

通过 DEB 或 RPM 软件包安装 Localtonet

获取本页帮助
本页内容 9 个章节
  1. 开始之前
  2. 软件包会安装什么
  3. 步骤
  4. 下载并安装软件包
  5. 设置你的 AuthToken
  6. 检查配置
  7. 启用服务
  8. 启动隧道
  9. 隧道服务还是 VPN 服务
  10. 服务如何运行
  11. 查看日志
  12. 升级
  13. 卸载
  14. 故障排除
  15. 相关页面

DEB 和 RPM 软件包会安装 Localtonet 客户端以及两个 systemd 服务,一个用于隧道,一个用于隧道加 VPN。这些服务从文件中读取你的 AuthToken,无需终端即可运行,因此客户端会在每次开机时启动。

开始之前 #

  • 一个 64 位 Linux 系统:软件包提供 x64 和 ARM64 版本。
  • systemd 247 或更高版本以及 OpenSSL 3,例如 Debian 12、Ubuntu 22.04+ 或 RHEL 9。
  • Root 权限(sudo)。
  • 你的 AuthToken。在控制台的 AuthToken 卡片上选择复制,或从我的令牌中复制一个令牌。

在其他发行版、32 位 ARM 上,或者你不想使用系统软件包时,请使用 Linux 页面中介绍的安装脚本或压缩包。

软件包会安装什么 #

路径含义
/usr/bin/localtonetlocaltonet 命令。
/usr/lib/localtonet/客户端本身。
/usr/lib/systemd/system/localtonet.service隧道服务。
/usr/lib/systemd/system/localtonet-vpn.serviceVPN 和隧道服务。
/etc/localtonet/auth-token令牌文件。只有 root 可以读取。安装时其中是占位符 DUMMY_AUTH_TOKEN。

软件包名为 localtonet。它的依赖项(包括 OpenSSL 3、iproute2(RPM 中为 iproute)、iptables 和 kmod)由你的包管理器安装。安装软件包不会启用或启动任何服务:你需要先设置令牌,再启用所需的服务。

步骤 #

  1. 下载并安装软件包 #

    在本页末尾的列表中选择适合你的发行版和 CPU 的软件包,然后用 apt(DEB)或 dnf(RPM)安装下载的文件。每个软件包下方的安装说明会显示该文件对应的确切命令。

  2. 设置你的 AuthToken #

    以 root 身份用文本编辑器编辑 /etc/localtonet/auth-token,将 DUMMY_AUTH_TOKEN 替换为你的令牌,写在同一行。然后确保只有 root 可以读取该文件:

    终端
    sudo chmod 600 /etc/localtonet/auth-token
  3. 检查配置 #

    终端
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    该检查会读取令牌文件,但不会建立连接。当文件包含一个不带空格的 33 个字符的令牌时,它会回答 Localtonet headless configuration OK.。它不会向 Localtonet 服务器查询该令牌对你的账户是否有效。

  4. 启用服务 #

    对于隧道,请启用隧道服务并查看其日志:

    终端
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    如果这台设备还要加入 VPN 网络,请改为启用 VPN 服务。参见隧道服务还是 VPN 服务。

  5. 启动隧道 #

    现在该令牌在我的令牌下显示为在线。在控制台中为它创建并启动一个隧道,参见快速入门。

隧道服务还是 VPN 服务 #

两个服务运行的是同一个客户端,也都为你的隧道服务。它们的区别在于运行时所拥有的权限。请只启用其中一个:这两个服务互相冲突,启动其中一个会停止另一个。

localtonet.servicelocaltonet-vpn.service
用途隧道VPN 和隧道
运行身份由 systemd 为该服务创建的无特权用户root,仅限于网络权能 CAP_NET_ADMIN 和 CAP_NET_RAW
TUN 模块不使用在客户端启动前通过 modprobe tun 加载
工作目录/var/lib/localtonet/var/lib/localtonet-vpn

要将设备从隧道服务切换到 VPN 服务:

终端
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

若要切换回来,请以同样的方式禁用 localtonet-vpn.service 并启用 localtonet.service。VPN 网络本身在控制台中设置,参见 VPN 管理器。

服务如何运行 #

行为详情
无头模式两个服务都会启动 localtonet --headless。在此模式下,客户端从不提示输入,也不会把令牌保存在自己的设置中。
令牌systemd 会将 /etc/localtonet/auth-token 传给服务。文件缺失时,服务不会启动。
开机启动已启用的服务会在网络就绪后启动。
重启发生故障十秒后,systemd 会重启客户端。如果客户端因令牌文件无效而停止,则不会重启它。请修复文件,然后自己重启服务。

查看日志 #

在无头模式下,客户端会向日志(journal)写入纯文本行,每次变化一行:

终端
sudo journalctl -u localtonet.service -f
行含义
Connection: Connected会话的状态。其他取值有 Connecting 和 Disconnected。
AuthTokenName: …客户端登录所用令牌的名称。
OPEN …, ADDED …在这台设备上运行的隧道,包括其公共地址、协议和本地目标。
STATUS …某个隧道的状态发生了变化。
CLOSED …某个隧道被停止或移除。
Authentication failed: AuthToken was rejected.文件中的令牌未被接受。请从“我的令牌”重新复制。

如果其中某一行会包含令牌,客户端会改写为 [redacted]。

升级 #

下载新的软件包,并以与第一次相同的方式安装,然后重启你所使用的服务。你的令牌文件会被保留。

隧道服务
sudo systemctl restart localtonet
VPN 服务
sudo systemctl restart localtonet-vpn.service

在我的令牌下,客户端列会显示设备最近一次报告的版本,并在有更新版本时显示需要更新标记。

卸载 #

Debian、Ubuntu
sudo apt remove localtonet
Fedora、RHEL
sudo dnf remove localtonet

卸载软件包会停止并禁用两个服务。令牌文件属于配置文件,包管理器会小心处理这类文件:卸载后,请检查 /etc/localtonet/auth-token 或它的保存副本是否仍然存在,如果不希望令牌留在机器上,请将其删除。

故障排除 #

Invalid Localtonet headless configuration. Check the token file or environment settings.

令牌文件无法使用。请检查 /etc/localtonet/auth-token 是否存在、占位符 DUMMY_AUTH_TOKEN 是否已删除,以及文件是否只包含 33 个字符的令牌(不带空格,且在同一行)。请使用 sudo 运行检查,因为只有 root 可以读取该文件。

服务已启用但没有运行

运行 systemctl status localtonet.service。/etc/localtonet/auth-token 缺失时服务不会启动,并且因令牌文件无效而停止后也不会被重启。请修复文件,运行配置检查,然后运行 sudo systemctl restart localtonet.service。

日志显示:Authentication failed: AuthToken was rejected.

文件格式正确,但令牌未被接受。请从我的令牌重新复制令牌,将其保存到令牌文件中,然后重启服务。

我启动 VPN 服务时,隧道服务停止了

这是预期行为。这两个服务互相冲突,因此一个启动时 systemd 会停止另一个。VPN 服务同样会为你的隧道提供服务。

软件包无法在我的发行版上安装

这些软件包需要 systemd 247 或更高版本以及 OpenSSL 3。在较旧的版本上,包管理器无法满足这些依赖。请改用 Linux 页面中的安装脚本或压缩包。

下面列出了这些软件包。在软件包下方选择安装说明,即可看到包含其文件名的命令。

Linux 软件包

适用于 x64 和 ARM64 的可安装 DEB 与 RPM 软件包。需要 systemd 247 或更高版本以及 OpenSSL 3,例如 Debian 12、Ubuntu 22.04+ 或 RHEL 9。

  • Debian / Ubuntu · x64
    安装说明

    1. 安装下载的软件包。在包含 localtonet-linux-x64.deb 的目录中打开终端。

    sudo apt install ./localtonet-linux-x64.deb

    2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token,将 DUMMY_AUTH_TOKEN 替换为你的令牌(单独一行)。然后保护该文件并检查配置:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. 启动服务。配置检查通过后:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    如需使用 VPN,请切换到 VPN 服务:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    升级时,安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

    如果你使用 VPN,请改为重启 localtonet-vpn.service。

  • Debian / Ubuntu · ARM64
    安装说明

    1. 安装下载的软件包。在包含 localtonet-linux-arm64.deb 的目录中打开终端。

    sudo apt install ./localtonet-linux-arm64.deb

    2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token,将 DUMMY_AUTH_TOKEN 替换为你的令牌(单独一行)。然后保护该文件并检查配置:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. 启动服务。配置检查通过后:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    如需使用 VPN,请切换到 VPN 服务:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    升级时,安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

    如果你使用 VPN,请改为重启 localtonet-vpn.service。

  • Fedora / RHEL · x64
    安装说明

    1. 安装下载的软件包。在包含 localtonet-linux-x64.rpm 的目录中打开终端。

    sudo dnf install ./localtonet-linux-x64.rpm

    2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token,将 DUMMY_AUTH_TOKEN 替换为你的令牌(单独一行)。然后保护该文件并检查配置:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. 启动服务。配置检查通过后:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    如需使用 VPN,请切换到 VPN 服务:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    升级时,安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

    如果你使用 VPN,请改为重启 localtonet-vpn.service。

  • Fedora / RHEL · ARM64
    安装说明

    1. 安装下载的软件包。在包含 localtonet-linux-arm64.rpm 的目录中打开终端。

    sudo dnf install ./localtonet-linux-arm64.rpm

    2. 设置你的 AuthToken。以 root 身份编辑 /etc/localtonet/auth-token,将 DUMMY_AUTH_TOKEN 替换为你的令牌(单独一行)。然后保护该文件并检查配置:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. 启动服务。配置检查通过后:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    如需使用 VPN,请切换到 VPN 服务:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    升级时,安装新的软件包并运行 sudo systemctl restart localtonet。你的配置会被保留。

    如果你使用 VPN,请改为重启 localtonet-vpn.service。

支持