跳到内容
Localtonet Localtonet 控制台

在 OpenWrt 上安装 Localtonet

实验性 OpenWrt 24.10 和 25.12+ x64 和 ARM64

获取本页帮助
本页内容 12 个章节
  1. 开始之前
  2. 受支持的版本和架构
  3. 不支持的情况
  4. 检查架构
  5. OpenWrt 24.10(opkg)
  6. 存储与内存
  7. 软件包会安装什么
  8. 令牌文件和配置
  9. 令牌文件
  10. UCI 配置
  11. 服务
  12. 日志
  13. 升级与移除
  14. OpenWrt 24.10(opkg)
  15. OpenWrt 上的 VPN
  16. 故障排除
  17. 相关页面

直接在 OpenWrt 路由器上运行 Localtonet 客户端。该软件包会安装客户端、令牌文件、UCI 配置,以及一个随路由器启动的服务。

OpenWrt 软件包目前处于实验阶段。它们是需要你手动安装的未签名文件,不是来自已签名 OpenWrt 软件源的软件包。在依赖它们之前,请先在你自己的设备上检查固件兼容性、你的隧道和 VPN。

开始之前 #

  • 一台运行受支持的 OpenWrt 版本和 CPU 架构的路由器(见下一节)。
  • 通过 SSH 获得路由器的 root 权限。
  • 安装期间路由器可以访问互联网。软件包管理器会从你固件自带的软件源下载依赖项。
  • 足够的可用存储空间和内存(见存储与内存)。
  • 来自我的令牌、且没有其他设备使用的 AuthToken。

受支持的版本和架构 #

OpenWrt 在不同版本之间更换了软件包管理器,因此有两种软件包格式。请选择与你的固件对应的一种:

OpenWrt 版本软件包格式软件包管理器架构
24.10IPKopkgx64、ARM64
25.12 及更高版本APK v3apkx64、ARM64

这里的 APK 指的是 OpenWrt 软件包。这些 .apk 文件不是 Android 应用,无法安装到手机上。Android 请参见 Android。

不支持的情况 #

  • MIPS、MIPSEL 和 ARMv7 路由器。这些架构没有对应的软件包。
  • 通过软件源安装。这些软件包是本地文件;你的路由器无法通过 opkg update 或 apk update 找到或更新它们。
  • 强行把软件包装到不同的架构上。切勿绕过软件包管理器的架构检查。

检查架构 #

软件包的架构必须与你的固件相符。请向路由器查询它接受哪些架构:

OpenWrt 24.10(opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+(apk)

Bash
apk --print-arch

x64 路由器会报告 x86_64。ARM64 路由器报告的名称以 aarch64_ 开头,且该名称因固件构建而异。每个软件包都附带一个简短的说明文件,写明它所构建的确切软件包架构,例如 x86_64 或 aarch64_generic。在下载页面的 OpenWrt 下选择你的软件包,打开软件包安装说明即可阅读。请把该架构与路由器报告的架构进行比较。如果不一致,请不要安装该软件包。

存储与内存 #

该软件包包含客户端及其自带的运行时,因此比典型的 OpenWrt 软件包大得多。安装之前请检查路由器:

Bash
df -h
free
  • 闪存(overlay)。程序文件安装在 /usr/lib/localtonet 下。闪存芯片较小的路由器可能需要 extroot(把外部存储用作根 overlay)才能容纳它们。
  • 内存与 /tmp。客户端启动时,会把它的原生库解压到 /tmp/localtonet/bundle。在 OpenWrt 上,/tmp 位于内存中,因此这部分空间来自路由器的内存。

软件包会安装什么 #

路径说明
/usr/bin/localtonetlocaltonet 命令。
/usr/lib/localtonet程序文件。
/etc/localtonet/auth-token令牌文件。在你替换之前,其中包含占位符 DUMMY_AUTH_TOKEN。仅 root 可读。
/etc/config/localtonet服务的 UCI 配置。
/etc/init.d/localtonet服务脚本(procd)。

该软件包依赖 libc、libgcc1、libstdcpp6、libopenssl3、zlib、ca-bundle、kmod-tun、ip-full、bash、iptables-nft 和 ip6tables-nft。软件包管理器会从你固件的软件源安装缺少的那些,这就是安装说明先刷新软件包列表的原因。kmod-tun 必须与已安装固件的内核匹配,所以务必从该固件自己的软件源获取。

令牌文件和配置 #

安装软件包不会连接任何东西。在你做完两件事之前,服务一直处于关闭状态:把你的令牌写入令牌文件,并在 UCI 中启用该服务。适用于你的软件包的确切命令,在本页末尾它的安装说明中;本节解释这些命令的作用。

令牌文件 #

/etc/localtonet/auth-token 在一行中保存你的 AuthToken,除此之外没有别的内容。请把占位符 DUMMY_AUTH_TOKEN 替换为你的令牌,例如用 vi。请保持文件仅 root 可读(权限 600)。

随后,安装说明会用 --headless --authtoken-file /etc/localtonet/auth-token --check-config 运行一次客户端。这会在不连接 Localtonet 的情况下检查该文件:

输出含义
Localtonet headless configuration OK.文件中包含格式正确的令牌:33 个字符,没有空格。该检查并不能证明令牌对你的账户有效。
Invalid Localtonet headless configuration. Check the token file or environment settings.文件不存在、仍然是占位符,或者令牌不是 33 个字符。

UCI 配置 #

服务从 /etc/config/localtonet 读取它的设置。全新安装时它的内容如下:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
选项作用取值
enabled服务是否启动客户端。当它为 0 时,启动服务不会有任何效果。0(默认)或 1
token_file客户端读取令牌的文件的路径。默认 /etc/localtonet/auth-token

随时显示当前的值:

Bash
uci show localtonet

服务 #

客户端作为名为 localtonet 的 procd 服务运行。安装软件包会把它注册为开机启动,但只有在 enabled 为 1 且令牌文件不为空时,它才会启动客户端。把 enabled 设为 1 并提交更改后,请重启一次服务;此后它会随路由器一起启动。

命令作用
/etc/init.d/localtonet restart停止并重新启动客户端。更改令牌文件或配置之后请运行它。
/etc/init.d/localtonet stop停止客户端,直到下次重启或重新启动路由器。
/etc/init.d/localtonet disable不再在开机时启动该服务。
/etc/init.d/localtonet enable重新在开机时启动该服务。

要关闭客户端但保留已安装的软件包:

Bash
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restart

如果客户端意外停止,procd 会再次启动它。

客户端连接后,请在控制台中使用路由器的令牌创建并启动隧道。隧道的本地 IP 地址可以是 127.0.0.1(用于路由器自身上的服务),也可以是路由器后面任意设备的局域网地址,例如 192.168.1.20。

日志 #

客户端会写入 OpenWrt 系统日志。显示它的日志行,或实时跟踪:

Bash
logread -e localtonet
logread -f -e localtonet
日志行含义
Localtonet - headless log客户端已启动。
Connection: …与 Localtonet 的连接状态。
AuthTokenName: …路由器所登录的令牌的名称。
OPEN …, ADDED …, STATUS …, CLOSED …此令牌的某个隧道被发现、添加、状态改变或被移除。
Authentication failed: AuthToken was rejected.Localtonet 不接受令牌文件中的令牌。
AuthToken file missing服务已启用,但令牌文件不存在或为空。

升级与移除 #

要升级,请在旧软件包之上安装较新的软件包,然后重启服务。令牌文件和 UCI 配置会被保留。这两个文件也在 OpenWrt 固件升级期间保留的文件列表中,但刷入新固件后,软件包本身需要重新安装。

要移除客户端:

OpenWrt 24.10(opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12+(apk)

Bash
apk del localtonet

移除软件包会停止服务,并把它从启动序列中去掉。

OpenWrt 上的 VPN #

该软件包会引入 VPN 功能在路由器上所需的组件:kmod-tun、ip-full、bash、iptables-nft 和 ip6tables-nft。路由和防火墙的行为取决于你的固件和你自己的防火墙规则,所以在依赖 VPN 之前,请先在你的设备上测试。功能本身请参见 VPN 管理器。

故障排除 #

软件包管理器因为架构原因拒绝该软件包

该软件包是为与你的固件不同的架构构建的。请把 opkg print-architecture 或 apk --print-arch 的输出,与软件包说明文件中写明的架构(下载页面上的软件包安装说明)进行比较。不要强行安装。MIPS、MIPSEL 和 ARMv7 路由器不受支持。

apk 因为文件不受信任而拒绝安装

APK 软件包是未签名的本地文件。安装它需要使用 --allow-untrusted 选项,如该软件包的安装说明所示。

安装因为找不到某个依赖项而失败

请先刷新软件包列表(opkg update 或 apk update),并确保路由器可以访问互联网。依赖项来自你固件自己的软件源。

服务已启用,但日志里什么都没有

请检查 uci show localtonet。如果 enabled 仍为 0,请把它设为 1,提交并重启服务。如果日志中显示 AuthToken file missing,请把你的令牌放入 token_file 所指定的文件中。

客户端无法启动,或者路由器内存耗尽

请用 df -h 和 free 检查可用的闪存空间和内存。客户端需要 /usr/lib/localtonet 下和 /tmp 中有足够的空间。

OpenWrt

实验性。OpenWrt 24.10 请选择 IPK,25.12+ 请选择 APK v3。这些 APK 文件是 OpenWrt 软件包,而不是 Android 应用。

仅支持 x64 和 ARM64。软件包架构必须与你的固件匹配;请查看软件包的安装说明以及 opkg print-architecture 或 apk --print-arch 的输出。这些软件包不支持 MIPS、MIPSEL 和 ARMv7。安装前请检查可用存储空间和内存。

  • OpenWrt 24.10 · x64 · IPK
    安装说明

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

    以 root 身份在路由器上运行以下命令。安装前请确认软件包架构与你的固件匹配。

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-x64.ipk

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

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

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    升级时,安装新的软件包并运行 /etc/init.d/localtonet restart。你的配置会被保留。

  • OpenWrt 24.10 · ARM64 · IPK
    安装说明

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

    以 root 身份在路由器上运行以下命令。安装前请确认软件包架构与你的固件匹配。

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-arm64.ipk

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

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

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    升级时,安装新的软件包并运行 /etc/init.d/localtonet restart。你的配置会被保留。

  • OpenWrt 25.12+ · x64 · APK v3
    安装说明

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

    以 root 身份在路由器上运行以下命令。安装前请确认软件包架构与你的固件匹配。

    此本地 APK 软件包未签名,因此安装时需要 --allow-untrusted。

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk

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

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

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    升级时,安装新的软件包并运行 /etc/init.d/localtonet restart。你的配置会被保留。

  • OpenWrt 25.12+ · ARM64 · APK v3
    安装说明

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

    以 root 身份在路由器上运行以下命令。安装前请确认软件包架构与你的固件匹配。

    此本地 APK 软件包未签名,因此安装时需要 --allow-untrusted。

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk

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

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

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    升级时,安装新的软件包并运行 /etc/init.d/localtonet restart。你的配置会被保留。

安装前请阅读对应软件包的安装说明。软件包未签名;固件兼容性、隧道和 VPN 需要在目标设备上验证。切勿强制安装架构不匹配的软件包。

支持