在 OpenWrt 上安装 Localtonet
实验性 OpenWrt 24.10 和 25.12+ x64 和 ARM64
本页内容 12 个章节
直接在 OpenWrt 路由器上运行 Localtonet 客户端。该软件包会安装客户端、令牌文件、UCI 配置,以及一个随路由器启动的服务。
OpenWrt 软件包目前处于实验阶段。它们是需要你手动安装的未签名文件,不是来自已签名 OpenWrt 软件源的软件包。在依赖它们之前,请先在你自己的设备上检查固件兼容性、你的隧道和 VPN。
开始之前 #
- 一台运行受支持的 OpenWrt 版本和 CPU 架构的路由器(见下一节)。
- 通过 SSH 获得路由器的 root 权限。
- 安装期间路由器可以访问互联网。软件包管理器会从你固件自带的软件源下载依赖项。
- 足够的可用存储空间和内存(见存储与内存)。
- 来自我的令牌、且没有其他设备使用的 AuthToken。
受支持的版本和架构 #
OpenWrt 在不同版本之间更换了软件包管理器,因此有两种软件包格式。请选择与你的固件对应的一种:
| OpenWrt 版本 | 软件包格式 | 软件包管理器 | 架构 |
|---|---|---|---|
| 24.10 | IPK | opkg | x64、ARM64 |
| 25.12 及更高版本 | APK v3 | apk | x64、ARM64 |
这里的 APK 指的是 OpenWrt 软件包。这些 .apk 文件不是 Android 应用,无法安装到手机上。Android 请参见 Android。
不支持的情况 #
- MIPS、MIPSEL 和 ARMv7 路由器。这些架构没有对应的软件包。
- 通过软件源安装。这些软件包是本地文件;你的路由器无法通过
opkg update或apk update找到或更新它们。 - 强行把软件包装到不同的架构上。切勿绕过软件包管理器的架构检查。
检查架构 #
软件包的架构必须与你的固件相符。请向路由器查询它接受哪些架构:
OpenWrt 24.10(opkg) #
opkg print-architectureOpenWrt 25.12+(apk)
apk --print-archx64 路由器会报告 x86_64。ARM64 路由器报告的名称以 aarch64_ 开头,且该名称因固件构建而异。每个软件包都附带一个简短的说明文件,写明它所构建的确切软件包架构,例如 x86_64 或 aarch64_generic。在下载页面的 OpenWrt 下选择你的软件包,打开软件包安装说明即可阅读。请把该架构与路由器报告的架构进行比较。如果不一致,请不要安装该软件包。
存储与内存 #
该软件包包含客户端及其自带的运行时,因此比典型的 OpenWrt 软件包大得多。安装之前请检查路由器:
df -h
free- 闪存(overlay)。程序文件安装在
/usr/lib/localtonet下。闪存芯片较小的路由器可能需要 extroot(把外部存储用作根 overlay)才能容纳它们。 - 内存与
/tmp。客户端启动时,会把它的原生库解压到/tmp/localtonet/bundle。在 OpenWrt 上,/tmp位于内存中,因此这部分空间来自路由器的内存。
软件包会安装什么 #
| 路径 | 说明 |
|---|---|
/usr/bin/localtonet | localtonet 命令。 |
/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 读取它的设置。全新安装时它的内容如下:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| 选项 | 作用 | 取值 |
|---|---|---|
enabled | 服务是否启动客户端。当它为 0 时,启动服务不会有任何效果。 | 0(默认)或 1 |
token_file | 客户端读取令牌的文件的路径。 | 默认 /etc/localtonet/auth-token |
随时显示当前的值:
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 | 重新在开机时启动该服务。 |
要关闭客户端但保留已安装的软件包:
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 系统日志。显示它的日志行,或实时跟踪:
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) #
opkg remove localtonetOpenWrt 25.12+(apk)
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.ipk2. 设置你的 AuthToken。以 root 身份编辑
/etc/localtonet/auth-token,将DUMMY_AUTH_TOKEN替换为你的令牌(单独一行)。然后保护该文件并检查配置:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. 启动服务。配置检查通过后:
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.ipk2. 设置你的 AuthToken。以 root 身份编辑
/etc/localtonet/auth-token,将DUMMY_AUTH_TOKEN替换为你的令牌(单独一行)。然后保护该文件并检查配置:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. 启动服务。配置检查通过后:
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.apk2. 设置你的 AuthToken。以 root 身份编辑
/etc/localtonet/auth-token,将DUMMY_AUTH_TOKEN替换为你的令牌(单独一行)。然后保护该文件并检查配置:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. 启动服务。配置检查通过后:
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.apk2. 设置你的 AuthToken。以 root 身份编辑
/etc/localtonet/auth-token,将DUMMY_AUTH_TOKEN替换为你的令牌(单独一行)。然后保护该文件并检查配置:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. 启动服务。配置检查通过后:
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 需要在目标设备上验证。切勿强制安装架构不匹配的软件包。