Cómo usar SharkTTY

Añade tu primer host

Abre Ajustes, ve a la pestaña Hosts y toca + arriba a la derecha. Un host nuevo tiene cuatro cosas que hay que rellenar y varias que puedes ignorar al principio.

• Nombre visible, Nombre de host y Usuario. El nombre visible es solo para ti; si lo dejas vacío se usa la dirección.
• Puerto SSH. El número se escribe, no se sube con un contador. Déjalo en 22 salvo que tu servidor escuche en otro puerto.
• Autenticación → Método: Contraseña, Clave, Interactivo por teclado / 2FA, o Ninguna.
• Conexión: SSH (directo) o Mosh (acelerado). Puedes cambiarlo después sin perder el resto.

Contraseña tiene dos modos. Guardar contraseña la conserva en el Keychain de iOS de este dispositivo; con la sincronización activada te sigue a través del Keychain de iCloud, de extremo a extremo, nunca por nuestro servidor. Introducir al conectar no guarda nada y la pide cada vez. Si tu servidor lanza sus propias preguntas —un código de un solo uso, un token físico— elige Interactivo por teclado / 2FA: respondes en el momento de conectar y no se guarda nada.

Guarda el host y tócalo para conectar. En la lista de hosts, un toque selecciona y un toque doble conecta directamente.

Claves SSH que no salen del dispositivo

Las claves están en la pestaña Cuenta de Ajustes. Toca + y elige una de tres vías: Generar clave, Añadir pegando texto o Importar desde archivo.

• Al generar: dale a la clave un nombre como id_ed25519, un comentario como me@iPhone y un algoritmo. Ed25519 es la opción recomendada por defecto; ECDSA y RSA están ahí para servidores antiguos, y generar una RSA de 4096 tarda unos segundos en un teléfono.
• Al pegar o importar una clave existente: si la clave privada está cifrada, introduce su frase de contraseña al añadirla. Solo se usa para derivar y guardar la clave pública correspondiente en el dispositivo.
• Para instalarla en el servidor: abre la clave y usa Copiar clave pública o Compartir clave pública, y añade esa línea a ~/.ssh/authorized_keys en el host, o entrégasela a quien administre la máquina.

Las claves privadas se quedan en el Keychain de iOS. Activa Sincronizar vía iCloud en una clave y viajará por el Keychain de iCloud hasta tus otros dispositivos: el mismo canal de extremo a extremo que Apple usa para las contraseñas, no nuestros servidores. Si inicias sesión en una cuenta de SharkTTY, se sincronizan tus hosts, scripts, unidades y plantillas; las contraseñas, las claves privadas y sus frases de contraseña, explícitamente, no.

De vuelta en el editor de hosts, Autenticación → Método → Clave te deja elegir la clave de ese host. Si la lista está vacía, el editor lo dice y te manda antes a la pestaña Cuenta.

La huella de la primera conexión, y qué hacer si cambia

La primera vez que llegas a un servidor, SharkTTY obtiene su clave de host y muestra la huella SHA256 con un botón Confiar y conectar. Compárala con la huella que publicó tu administrador, o con lo que imprime ssh-keygen -lf en el propio servidor. Una vez que la aceptas, queda registrada.

Si esa clave cambia, la conexión se detiene con un aviso en lugar de continuar. La lectura honesta es: el servidor se reinstaló o le rotaron la clave, o hay alguien en medio. Usa Confiar en la nueva clave y reconectar solo cuando sepas cuál de las dos cosas es.

Para volver a fijar un servidor a propósito —después de una reinstalación que hiciste tú— abre el host y usa Borrar la clave del host registrada. La siguiente conexión te pedirá confirmar la nueva huella desde cero.

SSH, Mosh o ET

Los tres te dan un shell interactivo. Se diferencian en lo que necesita el servidor y en lo que pasa cuando la red se mueve bajo tus pies.

Mosh predice lo que escribes para que la pantalla responda antes de que conteste el servidor. Ajustes → Terminal → Modo de predicción predeterminado ofrece Adaptativo, que activa la predicción solo cuando el enlace es lento, además de Siempre y Nunca. Adaptativo es el valor por defecto y le sirve a casi todo el mundo.

ET todavía está en pruebas y permanece desactivado hasta que actives el transporte ET (Eternal Terminal) en Ajustes. Una vez activo, aparece como un tercer método de conexión en el editor de hosts. Un detalle que conviene tener en cuenta: igual que el UDP de Mosh, la conexión de datos de ET va directa del dispositivo al puerto de etserver y no se reenvía a través de un host de salto.

Volver a una sesión que dejaste a medias

iOS suspende las apps poco después de que salen de pantalla, así que ningún terminal móvil puede mantener una conexión TCP abierta para siempre. SharkTTY lo resuelve en dos capas.

• La app conserva la última pantalla que vio. Si reabres una pestaña caída, encuentras esa instantánea con un botón Reconectar en lugar de un rectángulo vacío.
• Mosh y ET mantienen viva la sesión en el lado del servidor, así que al reconectar apareces exactamente donde estabas, a mitad de un comando si ahí lo dejaste.

La respuesta más fiable, con cualquier transporte, es un multiplexor en el servidor. Adjunta un script de conexión como tmux new -A -s mobile y cada reconexión vuelve a la misma sesión en vez de abrir un shell nuevo. Los scripts vienen a continuación.

Otra cosa pequeña que ahorra mucha espera: activa las notificaciones del sistema para la campana en Ajustes. Cuando un terminal hace sonar su campana y esa sesión no es la que estás mirando, iOS envía una notificación. Añade printf '\a' al final de un comando largo y el teléfono te avisa cuando termina.

Scripts: los fragmentos con los que conectas

Un script en SharkTTY es un bloque de texto de shell que se ejecuta en el terminal justo después de abrirse la conexión. Ajustes → Scripts, toca + y empieza con un script en blanco o elige Nuevo desde plantilla.

El selector de plantillas está agrupado por los motivos reales por los que la gente vuelve a conectarse:

• Persistencia de sesión: tmux, screen y zellij, cada uno escrito para reconectarse en lugar de crear un duplicado.
• Estado del sistema: un resumen del sistema, o htop como monitor de recursos.
• Registros: seguir el log del sistema, o seguir un archivo concreto.
• Contenedores: contenedores Docker, servicios de Compose, logs de contenedor.
• Servicios: estado y reinicio de servicios.
• Actualizaciones del sistema: plantillas separadas para Debian/Ubuntu, RHEL/Fedora, Alpine y Arch.
• Copia de seguridad: una copia incremental con rsync, o ejecutar tu propio script de respaldo.

Indica la Plataforma de un host y el selector se reduce a las plantillas que encajan con esa máquina, de modo que no te ofrece apt en un Alpine. Puedes editar lo que genera cualquier plantilla y usar Guardar como plantilla para conservar tu versión.

Adjunta un script a un host en el editor y se ejecutará en cada conexión. O deja el host limpio y elige al conectar: en la lista de hosts, Conectar con el script y Conectar directamente son acciones distintas, y un toque doble sobre un script conecta con él.

Escribir: la barra de accesorios y el teclado flotante

Sobre el teclado del sistema hay una barra de accesorios con las teclas que un terminal necesita y iOS no tiene: Esc, Ctrl, Tab y las flechas, además de botones para subir un archivo, mostrar u ocultar el teclado y activar el dispositivo apuntador.

Ajustes → Teclado → Panel de entrada alterna entre el teclado del sistema y Flotante, el teclado en pantalla propio de SharkTTY. El panel flotante es un teclado completo, no una tira: símbolos, Tab, Retorno, modificadores ⌃⌥⌘, una tecla fn y la fila de teclas F, dispuestos como en un teclado real con un Retorno en forma de L de dos filas. Arrástralo a donde quieras, cambia su tamaño y usa el control de opacidad de su panel de ajustes para difuminarlo sobre el terminal, hasta dejarlo completamente opaco si prefieres no ver a través de él.

Disposición, en esos mismos ajustes, cubre Inglés americano, Inglés británico, Japonés (JIS), Francés (AZERTY), Alemán (QWERTZ) y Español. Una tira de candidatos sobre las teclas sugiere palabras probables y comandos habituales mientras escribes. El botón del micrófono de la barra superior tiene dos comportamientos: tócalo para pasar al panel de voz, o mantenlo pulsado para hablar y que el texto vaya directo a la tira de candidatos.

El informe del ratón decide quién recibe tu trackpad. Activado, los clics y arrastres de un trackpad o ratón conectados llegan a los programas que los entienden: vim, tmux, htop, less. Desactivado, el puntero selecciona texto. Solo cambia algo mientras un programa haya pedido de verdad soporte de ratón. En iPad, los teclados y trackpads externos funcionan en toda la app.

Entrada de voz, e IA que convierte lo dicho en comandos

Mantén pulsado el micrófono para hablar. El reconocimiento se ejecuta en el dispositivo: gratis, sin conexión e inmediato, sin enviar nada a ninguna parte. Lo que ha oído aparece en el panel de voz como texto editable, e Insertar lo escribe en el terminal.

Las grabaciones se guardan por segmentos, así que puedes recortar uno y reconocer de nuevo solo esa parte en vez de repetirlo todo. El Historial conserva grabaciones anteriores para escucharlas o volver a procesarlas. En iPad, el panel de voz flota y se amplía igual que el teclado transparente.

La IA es opcional y va aparte del reconocimiento. Añade un proveedor en Ajustes con tu propia clave —se admiten los formatos de API de OpenAI, Claude, Gemini, Kimi y GLM— y configura un modelo de chat, más un modelo de transcripción si ese proveedor lo tiene. Claude es solo de chat y no tiene API de audio, así que ahí las grabaciones recurren al reconocimiento en el dispositivo. Las claves de proveedor se quedan en el Keychain de este dispositivo y nunca se sincronizan.

Con un proveedor conectado, los modos de prompt reescriben lo que dijiste como texto limpio o como un comando listo para ejecutar, y Adjuntar contexto del terminal deja que el modelo vea lo que hay en pantalla antes de responder. El panel de chat pone una conversación junto a la sesión para que puedas preguntar sin salir de ella.

Si prefieres no aportar una clave, hay modelos oficiales en la nube disponibles al iniciar sesión con una cuenta de SharkTTY. Se pagan con Puntos, que se compran mediante compra integrada y se comparten entre tus dispositivos. El reconocimiento en el dispositivo sigue siendo gratis en cualquier caso.

Mover archivos

Hay dos maneras de llevar un archivo a un servidor, y sirven para momentos distintos.

• Desde dentro de una sesión: el botón Subir archivo de la barra de accesorios envía el archivo directamente al directorio de trabajo. El tope es de 64 MB por archivo, y el host necesita una credencial que la app pueda reutilizar: un servidor que solo entra con un código de un solo uso no sirve por esta vía.
• Desde la lista de hosts: Explorar archivos por SFTP abre un gestor de archivos en ese servidor, con creación de carpetas, subida, descarga y confirmación de sobrescritura cuando los nombres coinciden.

La pestaña Archivos de Ajustes conecta como unidades el almacenamiento al que llega el dispositivo: iCloud Drive, una carpeta compartida, una carpeta local de la app o un servidor WebDAV por URL. Una vez conectada, la unidad se explora en el mismo gestor de archivos, que es como un archivo llega de un NAS a un servidor sin un portátil de por medio.

Varias sesiones en una pantalla

Las conexiones se abren como pestañas que puedes renombrar. Ordenar todas las conexiones las muestra juntas; Dividir izquierda/derecha y Dividir arriba/abajo colocan dos en paralelo; Enfocar esta conexión devuelve una al tamaño completo. En iPad, esta es la diferencia entre mirar un despliegue y mirar un log mientras el despliegue corre.

Los escritorios remotos viven en el mismo espacio de trabajo que los terminales, así que una sesión de Mac y tres shells pueden compartir la cuadrícula.

Llegar a un host a través de un bastión

Configura Host de salto (ProxyJump) en el editor de hosts para conectar primero al bastión y llegar al host real a través de él. El host de salto se autentica con su propia clave o contraseña guardada, sin interacción; todavía no se admite un bastión que exija inicio de sesión interactivo por teclado.

Por el host de salto viaja únicamente la conexión SSH. El UDP de Mosh y la conexión de datos de ET van directos del dispositivo al destino, algo que conviene comprobar antes de depender de cualquiera de los dos desde fuera de la red.