通过 DEB 或 RPM 软件包安装 Localtonet
本页内容 9 个章节
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/localtonet | localtonet 命令。 |
/usr/lib/localtonet/ | 客户端本身。 |
/usr/lib/systemd/system/localtonet.service | 隧道服务。 |
/usr/lib/systemd/system/localtonet-vpn.service | VPN 和隧道服务。 |
/etc/localtonet/auth-token | 令牌文件。只有 root 可以读取。安装时其中是占位符 DUMMY_AUTH_TOKEN。 |
软件包名为 localtonet。它的依赖项(包括 OpenSSL 3、iproute2(RPM 中为 iproute)、iptables 和 kmod)由你的包管理器安装。安装软件包不会启用或启动任何服务:你需要先设置令牌,再启用所需的服务。
步骤 #
-
下载并安装软件包 #
在本页末尾的列表中选择适合你的发行版和 CPU 的软件包,然后用
apt(DEB)或dnf(RPM)安装下载的文件。每个软件包下方的安装说明会显示该文件对应的确切命令。 -
设置你的 AuthToken #
以 root 身份用文本编辑器编辑
/etc/localtonet/auth-token,将DUMMY_AUTH_TOKEN替换为你的令牌,写在同一行。然后确保只有 root 可以读取该文件:终端sudo chmod 600 /etc/localtonet/auth-token -
检查配置 #
终端sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config该检查会读取令牌文件,但不会建立连接。当文件包含一个不带空格的 33 个字符的令牌时,它会回答
Localtonet headless configuration OK.。它不会向 Localtonet 服务器查询该令牌对你的账户是否有效。 -
启用服务 #
对于隧道,请启用隧道服务并查看其日志:
终端sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.service如果这台设备还要加入 VPN 网络,请改为启用 VPN 服务。参见隧道服务还是 VPN 服务。
-
启动隧道 #
隧道服务还是 VPN 服务 #
两个服务运行的是同一个客户端,也都为你的隧道服务。它们的区别在于运行时所拥有的权限。请只启用其中一个:这两个服务互相冲突,启动其中一个会停止另一个。
localtonet.service | localtonet-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 localtonetsudo systemctl restart localtonet-vpn.service在我的令牌下,客户端列会显示设备最近一次报告的版本,并在有更新版本时显示需要更新标记。
卸载 #
sudo apt remove localtonetsudo 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.deb2. 设置你的 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-config3. 启动服务。配置检查通过后:
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.deb2. 设置你的 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-config3. 启动服务。配置检查通过后:
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.rpm2. 设置你的 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-config3. 启动服务。配置检查通过后:
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.rpm2. 设置你的 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-config3. 启动服务。配置检查通过后:
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。