Saltar al contenido
Localtonet Localtonet Panel

Terminal de dispositivos

Gratis Desktop v8.6+ Windows, Linux y macOS

Ayuda con esta página
En esta página 13 secciones
  1. Cómo funciona
  2. Antes de empezar
  3. Añadir un dispositivo
  4. Abre Añadir dispositivo
  5. Elige el token
  6. Ejecuta el comando en el equipo
  7. Introduce el código y aprueba
  8. Sin nadie delante del equipo
  9. Opciones del comando
  10. La lista de dispositivos
  11. Abrir una terminal en el navegador
  12. Selecciona Terminal
  13. Introduce el código de tu aplicación de autenticación
  14. Conectar con ssh
  15. Claves SSH
  16. Con el cliente de Localtonet
  17. Claves de acceso para scripts y agentes de IA
  18. Elio
  19. Historial de conexiones
  20. Cambiar el nombre, quitar o desactivar un dispositivo
  21. Notas de seguridad
  22. Solución de problemas
  23. Páginas relacionadas

Mis dispositivos muestra tus equipos con el uso de CPU, memoria y disco, y abre un shell real en cualquiera de ellos desde tu navegador. Lo activas con un comando en la propia máquina; ningún puerto del equipo tiene que escuchar en Internet.

Cómo funciona #

Ejecutas localtonet --terminal enable en la máquina y apruebas en tu panel el código corto que imprime. A partir de ese momento, un botón Terminal abre un shell en esa máquina en una pestaña del navegador. Al mismo shell se llega desde cualquier terminal con un comando ssh que muestra el panel.

  • El dispositivo solo hace conexiones salientes. No hay que abrir ningún puerto de entrada ni instalar un servidor SSH.
  • Para abrir un shell desde el navegador necesitas un código nuevo de tu aplicación de autenticación cada vez.
  • Solo el comando local puede activar la terminal. No se puede activar desde el panel.

Antes de empezar #

  • Localtonet en la máquina. Versión mínima de la aplicación Localtonet necesaria para usar esta función: Desktop v8.6. Descárgala en la página Descargas.
  • Un AuthToken para esa máquina. Da a cada equipo su propio token: si usas un mismo token en un segundo equipo, el primero se desconecta. La terminal funciona con tokens de tu cuenta personal, no con tokens de equipo. Consulta AuthTokens.
  • Autenticación de dos factores. Para abrir un shell tu cuenta necesita una aplicación de autenticación. Si aún no la has configurado, Mis dispositivos muestra Activar la autenticación en dos pasos. Consulta Cuenta y seguridad.

Mis dispositivos está en el menú de tu panel personal. No aparece mientras tengas un equipo seleccionado.

Añadir un dispositivo #

  1. Abre Añadir dispositivo #

    Abre Mis dispositivos y selecciona Añadir dispositivo.

  2. Elige el token #

    Elige un token existente, o selecciona Generar nuevo token para crear uno y ponerlo en el comando. Si Localtonet ya se ejecuta en este equipo, elige su token. La lista marca los tokens que están en línea o que ya se usan en otro dispositivo. Un token que está conectado en este momento muestra una advertencia: úsalo solo si Localtonet se ejecuta en este mismo equipo.

  3. Ejecuta el comando en el equipo #

    Copia el comando del cuadro de diálogo y ejecútalo en una terminal del equipo que quieres añadir. Si Localtonet se ejecuta allí como servicio, usa una terminal de administrador o sudo.

    En el equipo
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    El comando imprime un código de aprobación y se queda esperando:

    Salida
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    Si lo ejecutas como administrador o root, primero pregunta Run shells as user: y te sugiere tu propia cuenta. Sin esos privilegios, los shells se ejecutan con la cuenta que ejecutó el comando.

  4. Introduce el código y aprueba #

    De vuelta en el cuadro de diálogo, escribe el código de aprobación en 2. Introduce el código que muestra. Las mayúsculas y el guion se añaden solos, y puedes pegar la línea completa que imprimió el comando. Introduce el código de 6 dígitos de tu aplicación de autenticación y selecciona Aprobar dispositivo.

    Entonces el comando imprime en el equipo Terminal enabled. Shells will run as … y el dispositivo aparece en la lista. Figura como en línea mientras Localtonet se ejecuta en él.

El código de aprobación es válido durante 15 minutos. Tiene 8 caracteres y nunca contiene I, L, O, U, 0 ni 1. Si caduca, el comando lo indica: vuelve a ejecutarlo.

Tras la aprobación, un comando que lanzaste a mano en una consola sigue como una ejecución normal de Localtonet. En un script, o cuando Localtonet ya se ejecuta en el dispositivo con este token, el comando termina en cuanto la terminal queda activada.

Sin nadie delante del equipo #

Para una máquina en la que nadie puede leer un código, por ejemplo un servidor que configuras con un script, usa una clave de un solo uso en lugar del código de aprobación.

  1. En el cuadro de diálogo Añadir un dispositivo, elige el token e introduce el código de tu aplicación de autenticación.
  2. Abre ¿Nadie puede leer un código en esa computadora? y selecciona Crear clave de un solo uso. La clave es válida durante una hora y solo funciona una vez.
  3. Copia el comando y sustituye ACCOUNT por la cuenta de usuario con la que deben ejecutarse los shells en ese equipo.
En el equipo
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

Con una clave válida el dispositivo se aprueba al instante y no se muestra ningún código.

Opciones del comando #

OpciónQué hace
--terminal enableActiva la terminal remota en este equipo e inicia el emparejamiento.
--terminal disableLa desactiva en este equipo y quita el dispositivo de tu cuenta.
--terminal statusIndica si la terminal está activada y con qué cuenta se ejecutan los shells.
--terminal-user <ACCOUNT>La cuenta con la que se ejecutan los shells, cuando activas como root o administrador. Es obligatoria en ese caso cuando el comando se ejecuta sin consola, por ejemplo desde un script.
--pairing-key <PAIRING_KEY>La clave de un solo uso del panel, de modo que no hace falta un código de aprobación.

La lista de dispositivos #

La lista se actualiza sola mientras la página está abierta.

ColumnaQué muestra
DispositivoEl nombre del equipo, su sistema operativo y arquitectura, y la cuenta con la que se ejecutan los shells.
EstadoEn línea significa que Localtonet se está ejecutando en el equipo y está conectado.
CPUCarga actual del procesador. Se muestra mientras el dispositivo está en línea.
MemoriaMemoria en uso sobre el total. Se muestra mientras el dispositivo está en línea.
DiscoEspacio de disco en uso sobre el total. Se muestra mientras el dispositivo está en línea.
AccionesTerminal, Claves, historial de conexiones, cambiar nombre y quitar.

Abrir una terminal en el navegador #

  1. Selecciona Terminal #

    Selecciona Terminal en la fila del dispositivo. El botón solo funciona mientras el dispositivo está en línea. El cuadro de diálogo te indica con qué cuenta se ejecuta el shell.

  2. Introduce el código de tu aplicación de autenticación #

    Introduce el código de 6 dígitos de tu aplicación de autenticación y selecciona Abrir terminal. El shell se abre en una pestaña nueva del navegador.

Conectar con ssh #

El cuadro de diálogo Terminal también muestra un comando bajo O desde cualquier terminal, sin instalar nada. Funciona desde cualquier equipo con un cliente ssh. El comando tiene esta forma, donde <DEVICE> es el nombre de tu dispositivo y <NODE> es el servidor de Localtonet al que está conectado:

Cualquier terminal
ssh -p 24 <DEVICE>@<NODE>

Copia el comando del cuadro de diálogo: muestra el comando exacto para tu dispositivo.

  • El cuadro de diálogo muestra la Huella del servidor. ssh muestra una huella la primera vez que te conectas. Si coincide, has llegado a Localtonet.
  • Si no has añadido una clave SSH, ssh muestra un enlace para aprobar en tu navegador. La página Aprobar conexión indica el dispositivo y la dirección IP desde la que se hizo la solicitud. Introduce el código de tu aplicación de autenticación, selecciona Permitir conexión y vuelve a tu terminal. La solicitud caduca a los 5 minutos.

Aprueba una conexión solo si acabas de ejecutar tú mismo el comando ssh. Quien haya hecho la solicitud obtiene un shell en ese equipo.

Claves SSH #

Añade la clave SSH pública de tu propio equipo para que ssh, scp y sftp se conecten sin pedir aprobación en el navegador.

  1. En Mis dispositivos, selecciona Claves SSH.
  2. Escribe un Nombre y pega una línea de tu archivo de clave pública, por ejemplo ~/.ssh/id_ed25519.pub, en Clave pública. Nunca pegues tu clave privada.
  3. Introduce el código de tu aplicación de autenticación y selecciona Añadir clave.

Los tipos de clave aceptados son ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 y ssh-rsa. Una clave se aplica a todos los dispositivos de tu cuenta. Selecciona Quitar junto a una clave para que deje de funcionar. El cuadro de diálogo también muestra un ejemplo de scp para uno de tus dispositivos:

Cualquier terminal
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

Con el cliente de Localtonet #

Si Localtonet está instalado en el equipo desde el que te conectas, localtonet ssh también conecta, y la sesión permanece cifrada hasta el dispositivo.

Cualquier terminal
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

Sin una clave imprime Approve this connection in your browser con un enlace, y continúa cuando apruebas. Todo lo que va después de -- se ejecuta como un único comando en el dispositivo en lugar de abrir un shell.

Claves de acceso para scripts y agentes de IA #

Una clave de acceso permite que un script o un agente de IA llegue a un equipo sin navegador. Quien la tenga puede ejecutar comandos allí, así que mantenla privada.

  1. Selecciona Claves en la fila del dispositivo.
  2. Escribe un Nombre, establece Válida durante (días) e introduce el código de tu aplicación de autenticación. La clave deja de funcionar pasados esos días, 3650 como máximo.
  3. Selecciona Crear clave y copia la clave ahora. No se volverá a mostrar.

Formas de usar la clave:

  • ssh. Ejecuta el comando ssh que muestra el cuadro de diálogo. Cuando ssh lo pida, pega la clave.
  • Cliente de Localtonet. Pasa la clave con la opción --key, como en el ejemplo siguiente.
  • MCP. Los agentes de IA conectados al servidor MCP de Localtonet pueden pasar la clave a la herramienta RunDeviceCommand.
Script
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

El cuadro de diálogo lista las claves del dispositivo con su fecha de caducidad. Selecciona Quitar para revocar una.

Elio #

El botón Elio de Mis dispositivos trata sobre Elio, el cliente SSH gratuito y de código abierto de Localtonet. Lo descargas desde elio.sh, inicias sesión desde Elio y apruebas la solicitud en el panel con tu código de dos factores. Elio puede entonces ver los nombres y el estado de tus dispositivos. Para abrir un shell en uno de ellos sigue haciendo falta la clave de acceso de ese dispositivo o una aprobación. El cuadro de diálogo lista las copias de Elio con sesión iniciada; quitar una cierra su sesión.

Historial de conexiones #

Selecciona el botón del reloj en la fila de un dispositivo para ver sus últimas conexiones. Cada línea muestra cuándo ocurrió, cómo se hizo y desde qué dirección IP. El cómo es uno de estos: la terminal del navegador, ssh con tu clave SSH, ssh con una clave de acceso, ssh aprobado en el navegador, localtonet ssh con una clave de acceso o aprobado en el navegador, y un agente de IA a través de MCP con una clave de acceso. La lista guarda las 50 conexiones más recientes.

Localtonet guarda únicamente este registro. Los comandos que escribes y su salida no se almacenan. Usa la lista para detectar una conexión que no hiciste tú: si encuentras alguna, quita las claves de acceso y las claves SSH que ya no necesites.

Cambiar el nombre, quitar o desactivar un dispositivo #

AcciónDóndeResultado
Cambiar nombreEl botón del lápiz en la fila.Cambia el nombre que aparece en la lista y que se usa en el comando ssh. Usa letras, números, puntos, guiones o guiones bajos.
QuitarEl botón de la papelera en la fila.Quita el equipo de tu cuenta. Sus claves dejan de funcionar y hay que aprobarlo de nuevo para que vuelva.
DesactivarEn el propio equipo.Desactiva la terminal localmente y quita el dispositivo de tu cuenta.
En el equipo
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

Desactivar siempre funciona en el equipo, incluso cuando no se puede acceder al panel. En ese caso el comando te indica que quites también el dispositivo en el panel.

Notas de seguridad #

  • Un shell en una máquina da acceso total a todo lo que puede hacer su cuenta. Elige con cuidado la cuenta con la que se ejecutan los shells; una cuenta sin privilegios limita lo que puede cambiar una sesión.
  • Todo lo que puede llevar a un shell pide un código nuevo de la aplicación de autenticación: aprobar un dispositivo, abrir una terminal, crear una clave de acceso, añadir una clave SSH y aprobar una conexión ssh.
  • Una clave de acceso o una clave SSH añadida se conecta sin ese código. Da a las claves una validez corta, guárdalas como contraseñas y quita las que ya no uses.
  • Tras demasiados intentos en poco tiempo, el panel responde Demasiados intentos. Espera un minuto e inténtalo de nuevo.
  • Revisa de vez en cuando el historial de conexiones. Una conexión que no reconoces significa que se usó una clave o una aprobación que no esperabas.
  • Quitar un dispositivo, o ejecutar --terminal disable en él, pone fin al acceso de todas sus claves.

Solución de problemas #

Ese código de aprobación es incorrecto o ha caducado

Comprueba el código con el que imprimió el comando. Un código es válido durante 15 minutos y pertenece a la cuenta del token que va en el comando. Vuelve a ejecutar el comando para obtener un código nuevo.

Remote terminal is available on personal tokens only

El token del comando pertenece a un equipo. Crea un token en tu cuenta personal y usa ese.

The pairing key is not valid or has expired

Una clave de un solo uso funciona una vez y durante una hora. Crea una nueva en el cuadro de diálogo Añadir un dispositivo.

Choose the account for shells with --terminal-user

El comando se ejecuta como root o administrador sin consola, así que no puede preguntar. Añade --terminal-user <ACCOUNT>.

El botón Terminal está desactivado, o Este dispositivo está sin conexión

La terminal solo se abre mientras el dispositivo está en línea. Inicia Localtonet en ese equipo con el mismo token.

Ese código de autenticación no es correcto

Introduce el código de 6 dígitos que muestra tu aplicación de autenticación para Localtonet. No es tu contraseña ni el código que se muestra en el equipo, y cambia cada 30 segundos.

Esta solicitud ha caducado. Empieza de nuevo desde Mis dispositivos

Una solicitud para abrir una terminal o para aprobar una conexión ssh dura poco. Selecciona Terminal de nuevo, o vuelve a ejecutar el comando ssh.

Eso no parece una clave pública SSH

Pega la línea completa de tu archivo .pub, empezando por el tipo de clave.

The terminal is already enabled on this device

No hay nada que hacer. Para emparejar la máquina de nuevo, ejecuta primero --terminal disable y luego --terminal enable.

Soporte