Instala Localtonet en Linux
En esta página 9 secciones
- Antes de empezar
- Instalar con el script
- Ejecuta el script de instalación
- Comprueba la instalación
- Instalar manualmente
- Descarga y extrae
- Opcional: muévelo a tu PATH
- Inicia el cliente
- Inícialo con tu token
- Comprueba la sesión
- Ejecutar como servicio de systemd
- Instala el servicio
- Comprueba que se ejecuta
- Comandos de servicio
- La unidad y sus registros
- Actualización
- Sustituye el cliente
- Reinicia el servicio
- Desinstalación
- Solución de problemas
- Páginas relacionadas
En Linux, el cliente de Localtonet es un único programa de consola. Instálalo con el script de instalación o desde un archivo ZIP, inícialo con tu AuthToken e instálalo como servicio de systemd si debe iniciarse después de cada reinicio.
Antes de empezar #
- Una cuenta de Localtonet. Crea una gratis si no tienes ninguna.
- Tu AuthToken. Selecciona Copiar en la tarjeta AuthToken del Panel, o copia un token de Mis tokens.
curlowget, yunzip.- Para el servicio de systemd: acceso root y una distribución que use systemd.
Otras formas de ejecutar Localtonet en Linux. En Debian, Ubuntu, Fedora y RHEL puedes instalar un paquete DEB o RPM que incluye sus propios servicios. Hay guías aparte para Docker, para routers OpenWrt y para Termux en Android.
Instalar con el script #
-
Ejecuta el script de instalación #
Terminalcurl -fsSL https://localtonet.com/install.sh | shEl script detecta tu CPU (x64, ARM64 o ARM) y si el sistema usa glibc o musl, descarga la versión correspondiente y la instala en
/usr/local/bin/localtonet. También crea el enlace/usr/bin/localtonet, para quesudo localtonetfuncione en las distribuciones dondesudono busca en/usr/local/bin.El script usa
sudocuando tu usuario no puede escribir en la carpeta de instalación, por lo que puede pedirte la contraseña. Si faltaunzip, intenta instalarlo con el gestor de paquetes de tu distribución. -
Comprueba la instalación #
El script termina mostrando la versión instalada. Puedes mostrarla de nuevo en cualquier momento:
Terminallocaltonet --version
Instalar manualmente #
Si prefieres una descarga directa, toma el archivo para tu sistema. Cada ZIP contiene un solo archivo, localtonet.
| CPU | glibc (Debian, Ubuntu, Fedora, RHEL y la mayoría de las demás) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32 bits) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m muestra el tipo de tu CPU: x86_64 es x64, aarch64 es ARM64 y armv7l es ARM.
-
Descarga y extrae #
El ejemplo usa la versión x64 con glibc. Sustituye el nombre del archivo por el de tu sistema.
Terminalwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Opcional: muévelo a tu PATH #
Sin este paso, inicias el cliente con su ruta,
~/localtonet/localtonet. Después podrás escribirlocaltoneten cualquier carpeta.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Inicia el cliente #
-
Inícialo con tu token #
Terminallocaltonet --authtoken <YOUR_TOKEN>El cliente guarda el token localmente para tu usuario. La próxima vez puedes iniciarlo solo con
localtonet. Si lo inicias sin un token guardado, preguntaPlease Enter AuthToken or PIN. -
Comprueba la sesión #
El terminal muestra
Session Status: Connectedencima de una tabla con una fila por cada túnel en ejecución:IP/Url,Protocol,Client IP,Client Port,PingyStatus. La tabla está vacía hasta que inicias un túnel en el panel; consulta Inicio rápido.Pulsa Ctrl + C para detener el cliente. Pulsa F12 para eliminar el token guardado y salir.
Cuando la salida no es un terminal, por ejemplo cuando la rediriges a un archivo, el cliente escribe una línea de texto plano por cada cambio en lugar de la tabla.
La VPN necesita root. Si el dispositivo forma parte de una red de Gestor de VPN y el cliente se ejecuta sin root, la fila VPN de la tabla muestra Admin rights required. En ese caso, inicia el cliente con sudo o como servicio.
Ejecutar como servicio de systemd #
Un servicio inicia Localtonet después de cada reinicio, lo mantiene en ejecución después de cerrar sesión y no necesita un terminal abierto. Los comandos de servicio necesitan root.
-
Instala el servicio #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>El comando escribe una unidad de systemd para este token, la habilita y la inicia de inmediato. Responde con el nombre de la unidad:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>son los primeros 9 caracteres de tu token. Cada token tiene su propia unidad, así que los demás comandos de servicio necesitan el mismo--authtokenpara encontrarla. -
Comprueba que se ejecuta #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Un servicio en ejecución responde
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. En el panel, el token aparece como En línea en Mis tokens.
Comandos de servicio #
Ejecuta cada comando con sudo y añade --authtoken <YOUR_TOKEN>.
| Comando | Qué hace |
|---|---|
--install-service | Escribe el archivo de unidad, habilita la unidad y la inicia. |
--start-service | Inicia la unidad, por ejemplo después de haberla detenido. |
--stop-service | Detiene la unidad. Sigue habilitada y se inicia de nuevo tras un reinicio. |
--status-service | Muestra el estado, por ejemplo Running, Stopped o Error cuando la unidad ha fallado. |
--remove-service | Detiene y deshabilita la unidad y elimina el archivo de unidad. |
El servicio se instala con las opciones que pases junto con --install-service. Las opciones se enumeran en la Referencia de la CLI.
La unidad y sus registros #
El archivo de unidad es /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd reinicia el cliente cinco segundos después de un fallo. Como es una unidad de systemd normal, también puedes gestionarla con systemctl y leer su salida con journalctl:
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fLa unidad inicia el archivo localtonet desde la ruta que tenía cuando instalaste el servicio. Hay una excepción: si esa ruta está dentro de /root/, el comando de instalación copia el archivo a /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ y el servicio ejecuta la copia.
Actualización #
-
Sustituye el cliente #
Ejecuta de nuevo el script de instalación. Se puede volver a ejecutar con seguridad y sobrescribe el cliente instalado con la versión actual. Tras una instalación manual, descarga el archivo actual y sustituye el archivo
localtonet.Terminalcurl -fsSL https://localtonet.com/install.sh | sh -
Reinicia el servicio #
Un servicio en ejecución sigue usando la versión antigua hasta que se reinicia.
Terminalsudo systemctl restart Localtonet_<TOKEN_PREFIX>Si el servicio ejecuta una copia dentro de
/usr/local/lib/, elimina el servicio e instálalo de nuevo con el cliente nuevo.
En Mis tokens, la columna Cliente muestra la última versión que informó el dispositivo y una insignia Requiere actualización cuando hay una más reciente disponible.
Desinstalación #
- Si instalaste el servicio, elimínalo:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Para eliminar el token guardado, inicia el cliente y pulsa F12.
- Elimina el cliente:
sudo rm /usr/local/bin/localtonet /usr/bin/localtonettras la instalación con el script, o la carpeta en la que extrajiste el archivo.
Solución de problemas #
Script de instalación: Unsupported architecture
El script tiene versiones para x64 (x86_64), ARM64 (aarch64) y ARM de 32 bits (armv7l). Las versiones para Linux no admiten otros tipos de CPU.
Script de instalación: Neither curl nor wget found
Instala curl o wget con tu gestor de paquetes y ejecuta el script de nuevo.
Script de instalación: Failed to install 'unzip'
El script no pudo instalar unzip por sí mismo. Instálalo con tu gestor de paquetes y ejecuta el script de nuevo.
Instalado, pero no se encuentra en el PATH
Abre un shell nuevo o inicia el cliente con su ruta completa, /usr/local/bin/localtonet.
sudo: localtonet: command not found
Tras una instalación manual, el cliente no está en la ruta de búsqueda de sudo. Usa la ruta completa, por ejemplo sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, o mueve primero el archivo a /usr/local/bin.
Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.
El comando se ejecutó sin root. Repítelo con sudo. Lo mismo se aplica a --start-service, --stop-service y --remove-service.
Install failed: Systemd unit already exists for 'Localtonet_…'
Ya hay instalado un servicio para este token. Compruébalo con --status-service. Para instalarlo de nuevo, ejecuta antes --remove-service.
Los comandos de servicio fallan en un sistema sin systemd
El modo de servicio usa systemd. En sistemas que no lo tienen, inicia el cliente de otra forma, por ejemplo en un contenedor de Docker. El cliente de consola tiene un modo headless para esto: --headless se ejecuta sin prompts y lee el token de un archivo indicado con --authtoken-file. Consulta la Referencia de la CLI.
Wrong Token!
El cliente espera el AuthToken de 33 caracteres de Mis tokens, o un PIN de 6 dígitos que no haya caducado. Copia el token de nuevo e introdúcelo en el prompt.
This token is used in another localtonet application!
Otro cliente de Localtonet de esta máquina ya se está ejecutando con el mismo token. Ciérralo, o inicia este con otro token. Usa un cliente en ejecución por token.