Instalar el cliente de Localtonet
En esta página 5 secciones
- Plataformas compatibles
- Elige el tipo de instalación
- Lo que tienen en común todas las instalaciones
- El cliente inicia sesión con un AuthToken
- Inicias el cliente con ese token
- Creas e inicias los túneles en el panel
- El cliente tiene que seguir en ejecución
- Mantén el cliente actualizado
- Guías de instalación
El cliente de Localtonet se ejecuta en el dispositivo que aloja tu servicio y mantiene abierto el túnel hacia Localtonet. Esta página enumera las plataformas compatibles, te ayuda a elegir el tipo de instalación adecuado y enlaza con la guía de cada una.
Plataformas compatibles #
Todas las descargas están en la página Descargas.
| Plataforma | Qué puedes instalar | Arquitecturas |
|---|---|---|
| Windows | App de Microsoft Store, app de escritorio portátil, cliente de consola | 64 bits (x64), 32 bits (x86), ARM64 |
| macOS | Cliente de consola, con Homebrew o como archivo ZIP | Intel (x64), Apple Silicon (ARM64) |
| Linux | Cliente de consola, con el script de instalación o como archivo ZIP | x64, ARM y ARM64, cada una para glibc y para musl |
| Paquetes para Linux | Paquetes DEB y RPM con servicios de systemd | x64, ARM64 |
| Android | App de Android desde Google Play o como archivo APK | La versión mínima de Android de la app es la 5.0 |
| Termux | Cliente de consola como paquete de Termux | ARM64 |
| Docker | Imagen oficial localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | Paquetes para routers con OpenWrt 24.10 y 25.12+ (experimental) | x64, ARM64 |
| NAS y Home Assistant | Plantillas de configuración de Docker Compose y Home Assistant | AMD64, ARM64 |
| SSH sin instalación | Nada. Usas el cliente SSH que ya tienes. | Cualquier dispositivo con un cliente SSH |
Elige el tipo de instalación #
| Opción | Qué es | Elígela cuando |
|---|---|---|
| Cliente de consola | El programa localtonet para Windows, macOS y Linux. Lo inicias en un terminal con tu AuthToken. Muestra tus túneles en una tabla en vivo y puede instalarse a sí mismo como servicio. | Trabajas en un terminal, o el dispositivo es un servidor sin escritorio. |
| App de escritorio | La app de Localtonet para Windows con una ventana de inicio de sesión, desde Microsoft Store o como ZIP portátil. | En Windows prefieres una ventana de app antes que un terminal. |
| App móvil | La app de Localtonet para Android. Inicias sesión con un código QR, un PIN o el token. | El dispositivo es un teléfono o una tableta Android, por ejemplo para un proxy móvil. |
| Paquete | Paquetes DEB y RPM para Linux, un paquete de Termux para Android y paquetes experimentales para OpenWrt. Los paquetes de Linux y OpenWrt incluyen un servicio que lee el token de un archivo. | Quieres que el gestor de paquetes del sistema instale y elimine el cliente, y un servicio que se inicie con el arranque. |
| Contenedor | La imagen oficial de Docker y las plantillas de configuración para dispositivos NAS y Home Assistant que la usan. | Tus servicios ya se ejecutan en contenedores, o el dispositivo es un NAS. |
| SSH sin instalación | El panel genera un comando ssh que abre el túnel. No hace falta ninguna descarga. Se ofrece para túneles HTTP y TCP. | No puedes o no quieres instalar nada en el dispositivo. |
Lo que tienen en común todas las instalaciones #
-
El cliente inicia sesión con un AuthToken #
Un AuthToken conecta un dispositivo a tu cuenta. Cópialo con Copiar en la tarjeta AuthToken del Panel, o crea un token con nombre para cada dispositivo en Mis tokens. Los tokens se explican en AuthTokens.
Mantén tu token en privado. Cualquiera que tenga el token puede usarlo para iniciar sesión en la app.
-
Inicias el cliente con ese token #
Sustituye
<YOUR_TOKEN>por tu token.Windows
Abre la app de Localtonet y pega tu AuthToken, o ejecuta el cliente de consola en el Símbolo del sistema desde la carpeta que contiene
localtonet.exe:Símbolo del sistemalocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
Abre la app de Localtonet, luego escanea el código QR del token, introduce su PIN o pega el token, y selecciona Connect. El código QR y el PIN están en Mis tokens.
El cliente de consola guarda el token en local, así que la próxima vez puedes iniciarlo solo con
localtonet. Cuando lo inicias sin un token guardado, preguntaPlease Enter AuthToken or PIN. -
Creas e inicias los túneles en el panel #
El cliente no necesita conocer tus túneles de antemano. Creas un túnel en Mis túneles, eliges el token del dispositivo, y el cliente que ha iniciado sesión con ese token lo sirve. El Inicio rápido recorre el primer túnel.
-
El cliente tiene que seguir en ejecución #
Un túnel se activa cuando el cliente se está ejecutando con tu AuthToken y el túnel está iniciado. Mis tokens muestra cada dispositivo como En línea o Sin conexión. Sin conexión significa que el dispositivo está desconectado, aunque sus túneles sigan configurados.
Para mantener el cliente en ejecución después de cerrar el terminal, cerrar sesión o reiniciar el dispositivo, instálalo como servicio:
Plataforma Cómo Windows localtonet --install-service --authtoken <YOUR_TOKEN>en un terminal que se ejecute como administradormacOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>Paquetes DEB, RPM y OpenWrt El paquete contiene el servicio. Lo habilitas después de definir el token. Android La app sigue ejecutándose en segundo plano y se abre de nuevo después de reiniciar el teléfono. Los detalles están en Ejecutar como servicio y en la página de cada plataforma.
Mantén el cliente actualizado #
La columna Cliente de Mis tokens muestra la última versión que informó cada dispositivo. Una insignia Requiere actualización enlaza con la página de Descargas cuando hay una versión más reciente. El cliente de consola también muestra New Version available bajo su tabla de túneles, y localtonet --version imprime la versión instalada.