Instala Localtonet en OpenWrt
Experimental OpenWrt 24.10 y 25.12+ x64 y ARM64
En esta página 12 secciones
- Antes de empezar
- Versiones y arquitecturas compatibles
- Qué no es compatible
- Comprueba la arquitectura
- OpenWrt 24.10 (opkg)
- Almacenamiento y memoria
- Qué instala el paquete
- Archivo de token y configuración
- El archivo de token
- La configuración UCI
- El servicio
- Registros
- Actualizar y eliminar
- OpenWrt 24.10 (opkg)
- VPN en OpenWrt
- Solución de problemas
- Páginas relacionadas
Ejecuta el cliente de Localtonet directamente en un router OpenWrt. El paquete instala el cliente, un archivo de token, una configuración UCI y un servicio que se inicia con el router.
Los paquetes de OpenWrt son experimentales. Son archivos sin firmar que instalas a mano, no paquetes de un feed firmado de OpenWrt. Comprueba la compatibilidad del firmware, tus túneles y la VPN en tu propio dispositivo antes de depender de ellos.
Antes de empezar #
- Un router con una versión de OpenWrt y una arquitectura de CPU compatibles (consulta la sección siguiente).
- Acceso root al router por SSH.
- Acceso a internet en el router durante la instalación. El gestor de paquetes descarga las dependencias de los feeds de paquetes de tu propio firmware.
- Suficiente almacenamiento y memoria libres (consulta Almacenamiento y memoria).
- Un AuthToken de Mis tokens que no use ningún otro dispositivo.
Versiones y arquitecturas compatibles #
OpenWrt cambió de gestor de paquetes entre versiones, así que hay dos formatos de paquete. Elige el de tu firmware:
| Versión de OpenWrt | Formato de paquete | Gestor de paquetes | Arquitecturas |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 y posteriores | APK v3 | apk | x64, ARM64 |
APK aquí significa un paquete de OpenWrt. Estos archivos .apk no son aplicaciones de Android y no se pueden instalar en un teléfono. Para Android, consulta Android.
Qué no es compatible #
- Routers MIPS, MIPSEL y ARMv7. No hay paquetes para estas arquitecturas.
- Instalar desde un feed de paquetes. Los paquetes son archivos locales; tu router no los encuentra ni los actualiza con
opkg updateoapk update. - Forzar un paquete en otra arquitectura. No anules nunca la comprobación de arquitectura del gestor de paquetes.
Comprueba la arquitectura #
La arquitectura del paquete debe coincidir con tu firmware. Pregunta al router qué arquitecturas acepta:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archUn router x64 informa x86_64. Los routers ARM64 informan un nombre que empieza por aarch64_, y ese nombre varía entre compilaciones de firmware. Cada paquete incluye un breve archivo de instrucciones que indica la arquitectura exacta para la que se compiló, por ejemplo x86_64 o aarch64_generic. En la página de Descargas, elige tu paquete en OpenWrt y abre Instrucciones de instalación del paquete para leerla. Compara esa arquitectura con la que informa tu router. Si no coinciden, no instales el paquete.
Almacenamiento y memoria #
El paquete contiene el cliente junto con su propio entorno de ejecución, por lo que es mucho más grande que un paquete típico de OpenWrt. Comprueba el router antes de instalar:
df -h
free- Flash (overlay). Los archivos del programa se instalan en
/usr/lib/localtonet. Un router con un chip flash pequeño puede necesitar extroot (almacenamiento externo como overlay raíz) para que quepan. - RAM y
/tmp. Cuando el cliente se inicia, descomprime sus bibliotecas nativas en/tmp/localtonet/bundle. En OpenWrt,/tmpse mantiene en RAM, así que este espacio sale de la memoria del router.
Qué instala el paquete #
| Ruta | Qué es |
|---|---|
/usr/bin/localtonet | El comando localtonet. |
/usr/lib/localtonet | Los archivos del programa. |
/etc/localtonet/auth-token | El archivo de token. Contiene el marcador de posición DUMMY_AUTH_TOKEN hasta que lo reemplazas. Solo lo puede leer root. |
/etc/config/localtonet | La configuración UCI del servicio. |
/etc/init.d/localtonet | El script del servicio (procd). |
El paquete depende de libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft y ip6tables-nft. El gestor de paquetes instala los que faltan desde los feeds de tu firmware, por lo que las instrucciones de instalación actualizan primero las listas de paquetes. kmod-tun debe coincidir con el kernel del firmware instalado, así que tómalo siempre de los feeds de ese firmware.
Archivo de token y configuración #
Instalar el paquete no conecta nada. El servicio permanece apagado hasta que haces dos cosas: poner tu token en el archivo de token y activar el servicio en UCI. Los comandos exactos para tu paquete están en sus Instrucciones de instalación, al final de esta página; esta sección explica lo que hacen.
El archivo de token #
/etc/localtonet/auth-token contiene tu AuthToken en una sola línea y nada más. Reemplaza el marcador de posición DUMMY_AUTH_TOKEN por tu token, por ejemplo con vi. Mantén el archivo legible solo por root (modo 600).
Las instrucciones de instalación ejecutan después el cliente una vez con --headless --authtoken-file /etc/localtonet/auth-token --check-config. Esto comprueba el archivo sin conectarse a Localtonet:
| Salida | Significado |
|---|---|
Localtonet headless configuration OK. | El archivo contiene un token con formato correcto: 33 caracteres, sin espacios. La comprobación no demuestra que el token sea válido para tu cuenta. |
Invalid Localtonet headless configuration. Check the token file or environment settings. | El archivo no existe, aún contiene el marcador de posición, o el token no tiene 33 caracteres. |
La configuración UCI #
El servicio lee sus ajustes de /etc/config/localtonet. Una instalación nueva contiene:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Opción | Qué hace | Valores |
|---|---|---|
enabled | Si el servicio inicia el cliente. Mientras vale 0, iniciar el servicio no hace nada. | 0 (predeterminado) o 1 |
token_file | Ruta del archivo del que el cliente lee el token. | Predeterminado: /etc/localtonet/auth-token |
Muestra los valores actuales en cualquier momento:
uci show localtonetEl servicio #
El cliente se ejecuta como un servicio procd llamado localtonet. Instalar el paquete lo registra para iniciarse al arrancar, pero solo inicia el cliente cuando enabled vale 1 y el archivo de token no está vacío. Después de poner enabled en 1 y confirmar el cambio, reinicia el servicio una vez; a partir de entonces se inicia con el router.
| Comando | Qué hace |
|---|---|
/etc/init.d/localtonet restart | Detiene e inicia el cliente. Ejecútalo después de cambiar el archivo de token o la configuración. |
/etc/init.d/localtonet stop | Detiene el cliente hasta el próximo reinicio del servicio o del router. |
/etc/init.d/localtonet disable | Deja de iniciar el servicio al arrancar. |
/etc/init.d/localtonet enable | Vuelve a iniciar el servicio al arrancar. |
Para apagar el cliente pero mantener el paquete instalado:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartSi el cliente se detiene inesperadamente, procd lo inicia de nuevo.
Cuando el cliente esté conectado, crea e inicia túneles en el panel con el token del router. La Dirección IP local de un túnel puede ser 127.0.0.1 para un servicio del propio router, o la dirección LAN de cualquier dispositivo detrás del router, por ejemplo 192.168.1.20.
Registros #
El cliente escribe en el registro del sistema de OpenWrt. Muestra sus líneas o síguelas en directo:
logread -e localtonet
logread -f -e localtonet| Línea | Significado |
|---|---|
Localtonet - headless log | El cliente se inició. |
Connection: … | El estado de la conexión con Localtonet. |
AuthTokenName: … | El nombre del token con el que inició sesión el router. |
OPEN …, ADDED …, STATUS …, CLOSED … | Se encontró, añadió, cambió de estado o eliminó un túnel de este token. |
Authentication failed: AuthToken was rejected. | Localtonet no aceptó el token del archivo de token. |
AuthToken file missing | El servicio está activado, pero el archivo de token no existe o está vacío. |
Actualizar y eliminar #
Para actualizar, instala el paquete más reciente sobre el anterior y reinicia el servicio. Se conservan el archivo de token y la configuración UCI. Ambos archivos figuran también en la lista de archivos que OpenWrt conserva durante una actualización de firmware, pero el propio paquete hay que instalarlo de nuevo después de flashear un firmware nuevo.
Para eliminar el cliente:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetEliminar el paquete detiene el servicio y lo quita de la secuencia de arranque.
VPN en OpenWrt #
El paquete incorpora lo que la función de VPN necesita en el router: kmod-tun, ip-full, bash, iptables-nft y ip6tables-nft. El enrutamiento y el comportamiento del firewall dependen de tu firmware y de tus propias reglas de firewall, así que prueba la VPN en tu dispositivo antes de depender de ella. Consulta Gestor de VPN para conocer la función en sí.
Solución de problemas #
El gestor de paquetes rechaza el paquete por su arquitectura
El paquete se compiló para una arquitectura distinta de la de tu firmware. Compara la salida de opkg print-architecture o apk --print-arch con la arquitectura indicada en el archivo de instrucciones del paquete (Instrucciones de instalación del paquete en la página de Descargas). No fuerces la instalación. Los routers MIPS, MIPSEL y ARMv7 no son compatibles.
apk se niega a instalar el archivo por no ser de confianza
Los paquetes APK son archivos locales sin firmar. Instalar uno requiere la opción --allow-untrusted, como se muestra en las instrucciones de instalación del paquete.
La instalación falla porque no se encuentra una dependencia
Actualiza primero las listas de paquetes (opkg update o apk update) y asegúrate de que el router tiene acceso a internet. Las dependencias proceden de los feeds de tu propio firmware.
El servicio está activado pero no aparece nada en el registro
Comprueba uci show localtonet. Si enabled sigue en 0, ponlo en 1, confirma el cambio y reinicia el servicio. Si el registro muestra AuthToken file missing, pon tu token en el archivo indicado por token_file.
El cliente no se inicia o el router se queda sin memoria
Comprueba el espacio flash y la memoria libres con df -h y free. El cliente necesita espacio en /usr/lib/localtonet y en /tmp.
Páginas relacionadas #
OpenWrt
Experimental. Elige IPK para OpenWrt 24.10 o APK v3 para 25.12+. Estos archivos APK son paquetes de OpenWrt, no apps de Android.
Solo x64 y ARM64. La arquitectura del paquete debe coincidir con tu firmware; revisa las instrucciones de instalación del paquete y opkg print-architecture o apk --print-arch. Estos paquetes no son compatibles con MIPS, MIPSEL ni ARMv7. Comprueba el almacenamiento y la RAM disponibles antes de instalar.
-
OpenWrt 24.10 · x64 · IPK
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-openwrt-24.10-x64.ipk.Ejecuta estos comandos en el router como root. Confirma que la arquitectura del paquete coincide con tu firmware antes de instalar.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPara actualizar, instala el nuevo paquete y ejecuta
/etc/init.d/localtonet restart. Tu configuración se conserva. -
OpenWrt 24.10 · ARM64 · IPK
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-openwrt-24.10-arm64.ipk.Ejecuta estos comandos en el router como root. Confirma que la arquitectura del paquete coincide con tu firmware antes de instalar.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPara actualizar, instala el nuevo paquete y ejecuta
/etc/init.d/localtonet restart. Tu configuración se conserva. -
OpenWrt 25.12+ · x64 · APK v3
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-openwrt-25.12-x64.apk.Ejecuta estos comandos en el router como root. Confirma que la arquitectura del paquete coincide con tu firmware antes de instalar.
Este paquete APK local no está firmado, así que la instalación requiere
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPara actualizar, instala el nuevo paquete y ejecuta
/etc/init.d/localtonet restart. Tu configuración se conserva. -
OpenWrt 25.12+ · ARM64 · APK v3
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-openwrt-25.12-arm64.apk.Ejecuta estos comandos en el router como root. Confirma que la arquitectura del paquete coincide con tu firmware antes de instalar.
Este paquete APK local no está firmado, así que la instalación requiere
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPara actualizar, instala el nuevo paquete y ejecuta
/etc/init.d/localtonet restart. Tu configuración se conserva.
Lee las instrucciones de instalación de tu paquete antes de instalar. Los paquetes no están firmados; la compatibilidad del firmware, los túneles y la VPN deben validarse en el dispositivo de destino. Nunca fuerces una arquitectura que no coincida.