Desarrollo y gestión remota

Esta guía trata cuatro temas: abrir su VelaTerm a otros dispositivos de su red, conectarse a otras máquinas por SSH o mediante un enlace de emparejamiento, compartir conversaciones con sus propios dispositivos a través de una cuenta de VelaTerm y transferir archivos desde y hacia máquinas remotas.

1. Puntos de acceso

Las funciones remotas se encuentran en el lado derecho de la barra de título:

• El icono del globo es «Acceso remoto (navegador)». Permite que un teléfono, una tableta u otro ordenador de su red use este VelaTerm en un navegador web. Mientras el servidor está en ejecución, el icono se resalta con el color de acento y su información sobre herramientas añade «En ejecución · puerto N».
• El icono de la flecha es «Conectar a servidor remoto». Convierte esta máquina en cliente de otra, por SSH, mediante un enlace de emparejamiento o a través de su cuenta de VelaTerm.
• El icono de la persona es la entrada «Cuenta», marcada como «Experimental». Inicia sesión en una cuenta de VelaTerm en este ordenador y le permite compartir conversaciones, a través de Internet, con sus otros dispositivos que tengan la sesión iniciada.

El botón «Compartir», situado junto a ellos, abre «Compartir VelaTerm», que sirve para recomendar VelaTerm a otras personas; no comparte ninguna sesión.

2. Abrir esta máquina a otros dispositivos (acceso remoto)

2.1 Iniciar el servidor

Haga clic en el botón del globo. Elija un «Puerto» (8799 de forma predeterminada; se recuerda el último puerto que usó), una dirección «IP» para el enlace de emparejamiento («Automática (primera dirección LAN)» o una interfaz concreta; las interfaces VPN llevan la marca «VPN») y una contraseña de acceso («Establecer contraseña de acceso») y, a continuación, haga clic en «Iniciar servidor».

La contraseña de acceso es obligatoria para todos los dispositivos que se conectan. Mientras el servidor está en ejecución, el panel indica: «El acceso remoto se reinicia automáticamente al volver a abrir la aplicación. “Detener servidor” lo desactiva». Si el inicio automático falla en un inicio posterior de la aplicación, el panel muestra «Error en el inicio automático:» seguido del motivo.

La casilla «Reflejar el diseño en todos los dispositivos» está activada de forma predeterminada. Cuando está activada, las pestañas, las divisiones y la sesión activa son las mismas en todos los dispositivos conectados, mientras que el foco del teclado es independiente en cada uno. Desactívela si cada dispositivo debe organizar sus propias pestañas.

2.2 Conectar un dispositivo

Cuando el servidor está en ejecución, el panel muestra el estado, la «Huella del certificado (SHA-256)», un enlace de emparejamiento y un código QR:

Para conectar un dispositivo, escanee el código QR con su cámara o envíele el enlace de emparejamiento (por ejemplo, con AirDrop o en un mensaje a usted mismo), abra el enlace en un navegador e introduzca la contraseña de acceso. Se necesitan tanto el enlace de emparejamiento como la contraseña; si se abre la dirección sin el enlace de emparejamiento, aparece «Este servidor requiere un enlace de emparejamiento». El tráfico entre el navegador y esta máquina está cifrado de extremo a extremo.

Hay dos aspectos importantes para la seguridad:

• El enlace de emparejamiento contiene credenciales de acceso. Compártalo solo con sus propios dispositivos. Si cree que se ha filtrado, haga clic en «Regenerar enlace (desconecta todos)»: el enlace anterior deja de funcionar de inmediato y todos los dispositivos conectados se desconectan hasta que abran el nuevo enlace.
• En la primera visita, el navegador advierte de que el certificado no es de confianza, lo cual es normal en un certificado autofirmado. Compare la huella que muestra el navegador con la del panel. Si coinciden, está conectado a su propia máquina.

Si la máquina tiene varias interfaces de red (cable, Wi-Fi, VPN), el panel muestra la dirección preferida y enumera las demás en «N enlaces más». Elija la dirección que esté en la misma red que el dispositivo que va a conectar.

Los enlaces de emparejamiento siguen siendo válidos cuando VelaTerm se reinicia. Solo «Regenerar enlace (desconecta todos)» los sustituye.

2.3 Qué puede hacer el cliente de navegador

La página de inicio de sesión y la interfaz principal en un dispositivo conectado:

Un cliente de navegador trabaja con las mismas sesiones activas que la aplicación de escritorio: el mismo árbol de proyectos y la misma salida de terminal y de conversación, y ambas partes pueden escribir. Con «Reflejar el diseño en todos los dispositivos» activado, la barra de título del equipo anfitrión muestra «Reflejado por N»; haga clic en este elemento para ver los «Clientes conectados» con sus nombres, direcciones y horas de conexión. Son los propios clientes los que comunican sus nombres, así que considérelos etiquetas y no una prueba de identidad.

Cuando el mismo terminal está abierto en varios dispositivos, su tamaño se ajusta a uno de ellos. Los demás dispositivos muestran una copia a escala con el distintivo «⤢ Espejo … · clic para ajustar a esta ventana» en la esquina superior derecha del terminal; haga clic en él para ajustar el terminal a la ventana actual.

Los clientes de navegador no disponen de pestañas de navegador ni de la opción de pegado nativo de imágenes. Pueden subir y descargar archivos en la pestaña Files (§5).

2.4 Dispositivos emparejados

Haga clic en «Dispositivos emparejados» en el panel del servidor en ejecución para ver todos los dispositivos que se han conectado, con su hora de «Última conexión»:

Para bloquear un dispositivo, haga clic en «Bloquear» y después en «Confirmar bloqueo». El dispositivo se desconecta de inmediato y no puede volver a conectarse hasta que abra un nuevo enlace de emparejamiento; los demás dispositivos no se ven afectados. Para desconectar todos los dispositivos a la vez, use «Regenerar enlace (desconecta todos)».

2.5 Detener el servidor

Haga clic en «Detener servidor», en la parte inferior del panel. Los clientes de navegador se desconectan, y las sesiones en ejecución continúan porque pertenecen a la aplicación de escritorio. Al detener el servidor también se desactiva el inicio automático; la próxima vez que lo inicie, vuelva a introducir la contraseña de acceso.

3. Conectarse a otras máquinas

Haga clic en el botón de conexión de la barra de título. El panel tiene tres pestañas: «SSH», «URL» y «Remote».

3.1 SSH: la máquina remota solo necesita SSH

Use esta opción con una máquina remota que no tenga ningún componente de VelaTerm. La máquina remota puede ejecutar Linux (x86_64 o ARM64), macOS (Apple silicon o Intel) o Windows (x86_64); las máquinas Windows pueden usar el servidor OpenSSH de Microsoft o un servidor SSH de Cygwin o MSYS2. Al conectarse, toda la configuración se realiza automáticamente: VelaTerm detecta el sistema remoto, copia en él el servidor de VelaTerm correspondiente, lo inicia de forma que siga ejecutándose por sí solo, reenvía un puerto local hacia él y abre una ventana remota que inicia sesión automáticamente.

Introduzca user@host[:port] y haga clic en «Conectar». Detalles que conviene conocer:

Verificación de la clave del host. La primera conexión a un host muestra su «Huella de la clave del host SSH» con la nota «Primera conexión a este host: verifica la huella antes de continuar». Compruébela y haga clic en «Huella correcta, conectar»; la clave se guarda en known_hosts y no se le vuelve a preguntar. Si cambia la clave de un host conocido, aparece una advertencia en rojo: «⚠ La clave de este host ha cambiado: podría ser una reinstalación del servidor o un ataque de intermediario. Continúa solo si estás seguro». Averigüe el motivo antes de confirmar.

Autenticación. Se usa su configuración de SSH existente (ssh-agent, ~/.ssh/config y las claves) tal como está. La solicitud de «Contraseña SSH» solo aparece cuando falla la autenticación por clave. «Recordar contraseña» guarda la contraseña en el llavero del sistema, nunca en la base de datos, y la usa la próxima vez.

Reflejar la aplicación de escritorio remota. Esta opción está desactivada de forma predeterminada y se recuerda para cada host. Actívela cuando la máquina remota también ejecute la aplicación de escritorio de VelaTerm y quiera ver exactamente lo que esta muestra: las mismas pestañas, divisiones y sesión activa, de modo que los cambios realizados en cualquiera de los dos lados aparecen en ambos. Si la aplicación de escritorio no se está ejecutando en la máquina remota, VelaTerm abre directamente su base de datos o, si no existe, una base de datos independiente. Sin esta opción, el servidor remoto usa su propio directorio de datos (~/.velaterm/data, o %USERPROFILE%\.velaterm\data en Windows), independiente de cualquier aplicación de escritorio instalada allí.

Si mantiene pulsada la tecla Option (Alt en Windows y Linux) mientras hace clic en el botón de conexión, aparece una opción más cuando el reflejo está desactivado: «Usar la base de datos de la app de escritorio remota». Esta opción permite que el servidor remoto abra la base de datos de la aplicación de escritorio remota sin conectarse a la aplicación en ejecución. Se recomienda que ambos usen la misma versión de VelaTerm.

Hosts recientes. Los hosts a los que se ha conectado aparecen en «Hosts recientes» («Ver todos (N)» muestra la lista completa). Al hacer clic en una entrada solo se rellena el formulario; revíselo y haga clic en «Conectar». Un icono de llave indica que hay una contraseña guardada, y × («Olvidar este host») elimina el host y su contraseña guardada.

Progreso. La primera conexión copia el servidor (decenas de MB), y el botón muestra «Preparando servidor…», «Transfiriendo servidor…» e «Iniciando servidor…» con un porcentaje. Las conexiones posteriores reutilizan el servidor que ya está en la máquina remota y son mucho más rápidas.

3.2 URL: la otra máquina tiene activado el acceso remoto

Use esta opción cuando el VelaTerm de otra máquina tenga activado el acceso remoto (§2) y usted disponga de su enlace de emparejamiento. En comparación con abrir el enlace en un navegador web, obtiene una ventana dedicada, inicio de sesión automático con una contraseña guardada en el llavero del sistema y comprobaciones de huella gestionadas por la aplicación.

Pegue el enlace de emparejamiento, introduzca la «Contraseña de acceso» definida en la otra máquina y haga clic en «Conectar». La primera conexión muestra la huella del certificado TLS de la otra máquina; compárela con la «Huella del certificado (SHA-256)» que aparece en el panel de esa máquina. Las conexiones posteriores con la huella sin cambios se establecen directamente, y una huella modificada genera una advertencia en rojo. Los enlaces de emparejamiento recientes aparecen debajo del formulario, igual que los hosts SSH.

3.3 Remote: sus dispositivos con sesión iniciada en la misma cuenta

La pestaña «Remote» enumera los dispositivos con sesión iniciada en su cuenta de VelaTerm (§4). Cada dispositivo muestra «En línea» o «Sin conexión» y lo que comparte; por ejemplo, «Todo el espacio de trabajo», un proyecto o una conversación, o «Este dispositivo no tiene contenido compartido». Cuando un dispositivo está en línea y comparte contenido, «Ver contenido compartido →» abre ese contenido en una ventana nueva. Si no ha iniciado sesión, la pestaña muestra un enlace «Iniciar sesión en VelaTerm».

4. Uso compartido mediante su cuenta de VelaTerm (experimental)

El uso compartido mediante la cuenta le permite continuar desde sus otros dispositivos, a través de Internet, las conversaciones de IA que se ejecutan en un ordenador, sin abrir puertos ni estar en la misma red. El contenido compartido pasa por velaterm.com cifrado de extremo a extremo. Esta función es experimental.

4.1 Iniciar sesión

Haga clic en el botón de la cuenta de la barra de título. El cuadro de diálogo «Cuenta» muestra «Iniciar sesión en VelaTerm»; haga clic en esta opción para continuar en su navegador web. Mientras VelaTerm espera, muestra «Completa el inicio de sesión en el navegador y vuelve a VelaTerm». Puede desplegar «Detalles de la solicitud de inicio de sesión» para comparar la solicitud con lo que muestra el sitio web.

Una vez iniciada la sesión, el cuadro de diálogo muestra su nombre y «ID de cuenta:», un botón «Cuenta» que abre la página de su cuenta en velaterm.com y «Cerrar sesión». Al cerrar la sesión, este ordenador se desconecta y deja de compartir todo lo que compartía.

4.2 Compartir contenido

En «Compartir contenido», elija un «Ámbito compartido»: «Todo el espacio de trabajo», «Proyecto» o «Conversación». Si elige «Proyecto» o «Conversación», seleccione el elemento en la lista y haga clic en «Compartir contenido». Cada elemento compartido aparece en «Uso compartido activo» con su estado («Uso compartido activo» o «Contenido compartido no disponible») y un botón «Dejar de compartir». Puede compartir varios elementos a la vez. Los elementos compartidos se mantienen después de un reinicio y solo están disponibles mientras este ordenador ejecuta VelaTerm y está conectado a Internet.

Solo se comparten las conversaciones de IA. Los terminales normales y las páginas de navegador nunca se comparten, y un dispositivo que visualiza contenido compartido no puede abrir terminales, archivos, ajustes ni pestañas nuevas.

4.3 Abrir el contenido compartido desde otro dispositivo

En otro dispositivo con sesión iniciada en la misma cuenta, abra la pestaña «Remote» del botón de conexión (§3.3) y haga clic en «Ver contenido compartido →». Puede leer las conversaciones compartidas. También puede enviar mensajes, interrumpir al agente y responder a sus solicitudes de permiso, pero solo en las sesiones que el ordenador que comparte muestra en la vista de conversación; en las demás sesiones, la ventana explica que el equipo anfitrión debe pasar primero la sesión a la vista de conversación.

Tenga en cuenta que un agente de IA actúa con los permisos del usuario del ordenador que comparte: puede ejecutar comandos y modificar archivos en él. Cualquier persona que pueda continuar una conversación compartida puede dirigir al agente, así que comparta contenido solo con dispositivos que usted controle y use «Dejar de compartir» cuando ya no necesite el acceso.

5. Transferir archivos

En los clientes de navegador y en las ventanas remotas URL y SSH, la pestaña Files del panel derecho permite mover archivos entre su dispositivo y la máquina que ejecuta las sesiones. La aplicación de escritorio local no lo necesita y no muestra estas acciones.

• Subir: haga clic con el botón derecho en una carpeta, o en un archivo dentro de ella, y elija «Subir archivos…»; haga clic en el botón de subida del encabezado de Files («Subir archivos a esta carpeta»), o arrastre archivos al árbol de archivos. No se pueden subir carpetas.
• Descargar: haga clic con el botón derecho en un archivo y elija «Descargar». En un navegador web, el archivo pasa por el gestor de descargas del propio navegador. En una ventana remota URL o SSH, un cuadro de diálogo de guardado pregunta dónde almacenar el archivo (de forma predeterminada, la carpeta Descargas).

Las subidas, y las descargas en ventanas remotas, aparecen en la lista «Transferencias» con su tamaño, velocidad y tiempo restante. Haga clic en el botón de cancelar para detener un elemento, y en «Limpiar» para quitar los elementos terminados. Si la conexión se interrumpe durante una subida, el elemento muestra «Reconectando…» y VelaTerm sigue reintentándolo durante aproximadamente un minuto. Una subida interrumpida nunca deja un archivo parcial en el destino, y si vuelve a subir el mismo archivo, la subida continúa donde se quedó.

6. Usar VelaTerm en un teléfono

Abra un enlace de emparejamiento (§2.2) en el navegador del teléfono; por ejemplo, escaneando el código QR del panel de acceso remoto. En un teléfono, VelaTerm cambia a un diseño pensado para pantallas táctiles pequeñas. El diseño se elige al cargar la página: se usa en dispositivos táctiles cuyo lado más corto de la pantalla mide menos de 768 píxeles. Añada ?view=mobile o ?view=desktop a la dirección para elegir el diseño usted mismo (una tableta puede usar ?view=mobile), o elija «Cambiar a versión de escritorio» en el menú «Más acciones» (•••); la elección se recuerda.

El diseño para móviles tiene dos niveles:

• Lista de sesiones: el árbol de proyectos con un cuadro de búsqueda («Buscar sesiones / grupos…») y filtros de estado («En curso», «Pendiente», «Visto»). Las sesiones se crean en la aplicación de escritorio o en el navegador de un ordenador y aparecen aquí automáticamente.
• Página de sesión: toque una sesión para abrirla y use «‹ Atrás» para volver a la lista. Las sesiones en la vista de conversación muestran la conversación completa. Las sesiones de Claude Code, Codex, OpenCode, Pi y OMP que se ejecutan en la vista de terminal muestran su conversación con un cuadro de mensaje que escribe en el terminal. Las demás sesiones muestran el terminal con una barra de teclas: Esc, Tab, Ctrl (que abre una fila de combinaciones con Ctrl, como ^C, ^D, ^R y ^W), las teclas de flecha, ^C, un botón de teclado y un botón de cámara para enviar una imagen. Deslice el dedo para desplazarse, toque para mostrar el teclado y mantenga pulsada una palabra para seleccionarla y elegir «Copiar».

El diseño para móviles no muestra pestañas de navegador, pestañas de documento ni paneles divididos, no tiene atajos de teclado y mantiene su propia vista en lugar de seguir «Reflejar el diseño en todos los dispositivos». Las sesiones de Kiro ofrecen su historial como vista de solo lectura.

VelaTerm para iOS está disponible en el App Store, y VelaTerm para Android, en Google Play.

7. Desconexión, cierre y qué se conserva

7.1 Tres capas de estado

Que «todo siga ahí después de una desconexión» depende de la capa:

Solo la tercera capa requiere atención: mientras el proceso del servidor remoto siga en ejecución, sus sesiones en ejecución continúan.

7.2 Cerrar una ventana remota

SSH: el servidor remoto lo inició esta conexión, por lo que al cerrar la ventana se abre «Disconnect remote» con tres opciones. «Stop server» apaga el servidor en la máquina remota y termina sus sesiones en ejecución. «Keep running» solo desconecta esta ventana; la siguiente conexión a esa máquina reutiliza el servidor con todas las sesiones intactas. «Cancel» mantiene la ventana abierta. Elija «Keep running» si los agentes deben seguir trabajando mientras usted no está.

SSH conectado a la aplicación de escritorio remota: cuando «Reflejar la aplicación de escritorio remota» ha conectado la ventana a una aplicación de escritorio en ejecución, al cerrar la ventana simplemente se desconecta; la aplicación de escritorio sigue en ejecución.

URL: usted era un invitado de un VelaTerm que ya estaba en ejecución. Cerrar la ventana solo significa que usted sale; el otro lado sigue en ejecución, y todo seguirá ahí cuando vuelva.

7.3 Pérdidas de conexión

Cuando se pierde la conexión de red, aparece una barra roja en la parte superior de la ventana remota con «Conexión perdida, reconectando…» y VelaTerm vuelve a intentarlo automáticamente. Las sesiones en ejecución no se ven afectadas; en el modo SSH, el servidor remoto se ejecuta con independencia de la conexión SSH.

En las ventanas SSH, VelaTerm también reconstruye el túnel SSH por sí solo («Enlace SSH perdido, reconstruyendo el túnel…»). Si deja de intentarlo, la barra indica «El enlace SSH está caído — pulsa “Reconectar ahora” para reintentar»; haga clic en «Reconectar ahora». Si el propio servidor remoto se ha detenido, reconectar desde la ventana no sirve de nada: vuelva a la ventana principal y conéctese de nuevo. La conexión comprueba si el servidor remoto sigue en ejecución, lo reutiliza si es así (con todas las sesiones) y solo inicia uno nuevo si no lo está.

Si una máquina remota entra en suspensión, cierra la sesión del usuario o se reinicia, el servidor en modo SSH y sus sesiones en ejecución terminan. El árbol de proyectos se almacena en el disco y no se ve afectado.

7.4 Referencia rápida

8. La seguridad de un vistazo

• Las contraseñas (contraseñas SSH y contraseñas de acceso remoto) solo se guardan en el llavero del sistema, nunca en la base de datos, y únicamente cuando usted elige «Recordar contraseña». La contraseña del acceso remoto solo se guarda como hash, para que el servidor pueda reiniciarse automáticamente.
• El acceso desde el navegador en la red local usa TLS con un certificado autofirmado. Los enlaces de emparejamiento contienen las credenciales del cifrado de extremo a extremo, y el servidor rechaza las conexiones sin enlace de emparejamiento.
• Las claves de host SSH y los certificados TLS remotos se consideran de confianza desde el primer uso: los destinos conocidos y sin cambios se conectan directamente, los destinos nuevos piden una confirmación y las huellas modificadas muestran una advertencia en rojo. Investigue antes de confirmar.
• Puede bloquear dispositivos concretos en cualquier momento (§2.4) y regenerar el enlace de emparejamiento cuando lo desee.
• El uso compartido mediante la cuenta se limita a las conversaciones de IA, pero los agentes de esas conversaciones actúan con sus permisos en el ordenador que comparte (§4.3).

Si la barra de título muestra un distintivo «⚠ vX ≠ vY», la interfaz y el servicio de VelaTerm al que está conectada informan de versiones distintas, y es posible que algunas funciones no funcionen correctamente entre sí. Actualice VelaTerm para que ambos ejecuten la misma versión.

9. Preguntas frecuentes

La ventana está conectada, pero la barra lateral sigue vacía o la barra roja no desaparece. Probablemente el servidor remoto se ha detenido. Vuelva a la ventana principal y conéctese de nuevo (§7.3).

El servidor no se inicia en el puerto 8799. Otro programa está usando ese puerto. Elija otro puerto en el panel y vuelva a iniciar el servidor.

El navegador indica que el certificado no es de confianza. Es lo normal con un certificado autofirmado. Compruebe la huella y continúe (§2.2).

Un agente de una máquina remota debe seguir trabajando mientras no estoy. En el modo SSH, elija «Keep running» al cerrar la ventana. La sesión continúa en la máquina remota, y puede volver a conectarse más tarde y retomarla donde estaba.

Un terminal se ve diminuto en mi teléfono. Es una copia a escala que sigue el tamaño de otro dispositivo. Toque «clic para ajustar a esta ventana» en el distintivo de la esquina superior derecha del terminal para ajustarlo a su teléfono.

«Ver contenido compartido» no aparece para mi ordenador. El botón solo aparece cuando ese ordenador está en línea, tiene la sesión iniciada en la misma cuenta y comparte algo. Abra VelaTerm en él y compruebe «Uso compartido activo» en su cuadro de diálogo «Cuenta».