Saltar al contenido
Localtonet Localtonet Panel

Instala Localtonet en Linux

Ayuda con esta página
En esta página 9 secciones
  1. Antes de empezar
  2. Instalar con el script
  3. Ejecuta el script de instalación
  4. Comprueba la instalación
  5. Instalar manualmente
  6. Descarga y extrae
  7. Opcional: muévelo a tu PATH
  8. Inicia el cliente
  9. Inícialo con tu token
  10. Comprueba la sesión
  11. Ejecutar como servicio de systemd
  12. Instala el servicio
  13. Comprueba que se ejecuta
  14. Comandos de servicio
  15. La unidad y sus registros
  16. Actualización
  17. Sustituye el cliente
  18. Reinicia el servicio
  19. Desinstalación
  20. Solución de problemas
  21. 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.
  • curl o wget, y unzip.
  • 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 #

  1. Ejecuta el script de instalación #

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh

    El 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 que sudo localtonet funcione en las distribuciones donde sudo no busca en /usr/local/bin.

    El script usa sudo cuando tu usuario no puede escribir en la carpeta de instalación, por lo que puede pedirte la contraseña. Si falta unzip, intenta instalarlo con el gestor de paquetes de tu distribución.

  2. Comprueba la instalación #

    El script termina mostrando la versión instalada. Puedes mostrarla de nuevo en cualquier momento:

    Terminal
    localtonet --version

Instalar manualmente #

Si prefieres una descarga directa, toma el archivo para tu sistema. Cada ZIP contiene un solo archivo, localtonet.

uname -m muestra el tipo de tu CPU: x86_64 es x64, aarch64 es ARM64 y armv7l es ARM.

  1. Descarga y extrae #

    El ejemplo usa la versión x64 con glibc. Sustituye el nombre del archivo por el de tu sistema.

    Terminal
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Opcional: muévelo a tu PATH #

    Sin este paso, inicias el cliente con su ruta, ~/localtonet/localtonet. Después podrás escribir localtonet en cualquier carpeta.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Inicia el cliente #

  1. Inícialo con tu token #

    Terminal
    localtonet --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, pregunta Please Enter AuthToken or PIN.

  2. Comprueba la sesión #

    El terminal muestra Session Status: Connected encima de una tabla con una fila por cada túnel en ejecución: IP/Url, Protocol, Client IP, Client Port, Ping y Status. 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.

  1. Instala el servicio #

    Terminal
    sudo 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 --authtoken para encontrarla.

  2. Comprueba que se ejecuta #

    Terminal
    sudo 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>.

ComandoQué hace
--install-serviceEscribe el archivo de unidad, habilita la unidad y la inicia.
--start-serviceInicia la unidad, por ejemplo después de haberla detenido.
--stop-serviceDetiene la unidad. Sigue habilitada y se inicia de nuevo tras un reinicio.
--status-serviceMuestra el estado, por ejemplo Running, Stopped o Error cuando la unidad ha fallado.
--remove-serviceDetiene 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:

Terminal
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

La 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 #

  1. 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.

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Reinicia el servicio #

    Un servicio en ejecución sigue usando la versión antigua hasta que se reinicia.

    Terminal
    sudo 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 #

  1. Si instalaste el servicio, elimínalo: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Para eliminar el token guardado, inicia el cliente y pulsa F12.
  3. Elimina el cliente: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet tras 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.

Soporte