Guía del usuario

Te damos la bienvenida a Pockterm

Qué es Pockterm y cómo está organizado

Pockterm es un cliente SSH completo para iPhone. Puedes conectarte a servidores, usar un terminal interactivo, transferir archivos por SFTP y crear túneles de redirección de puertos.

Usa las pestañas de la parte inferior para moverte entre Hosts, Fragmentos, Llavero y Redirección de puertos.

Todo permanece en tu dispositivo; consulta Tus datos y privacidad para más detalles.

Añadir un host

Crea un servidor al que puedas conectarte

Crear un host

• En la pestaña Hosts, toca + y luego Host nuevo.
• Introduce una Etiqueta, la Dirección (nombre de host o IP) y el Puerto (22 por omisión).
• Elige Credenciales para que Pockterm sepa cómo iniciar sesión. Si aún no tienes ninguna, toca Credenciales nuevas.
• Toca Guardar.

Acciones del host

• Toca un host para conectarte.
• Desliza a la izquierda para Editar, Destacar o Eliminar.
• Desliza a la derecha y toca Archivos para explorarlo por SFTP.

Credenciales y claves SSH

Cómo inicia sesión Pockterm

Las Credenciales son un nombre de usuario más una forma de autenticarse: una contraseña o una clave SSH.

Generar una clave

• En la pestaña Llavero, toca +, elige Generar clave Ed25519… y ponle una etiqueta a la clave.
• Pockterm crea un par de claves Ed25519 y guarda la clave privada en el Llavero de iOS.
• Añade la línea de clave pública que se muestra al archivo ~/.ssh/authorized_keys del servidor.

Importar una clave que ya tienes

• En la pestaña Llavero, toca + y elige Importar clave existente…
• Pega el archivo de clave privada completo, incluidas las líneas BEGIN y END. Se admiten claves Ed25519 y RSA en formato OpenSSH.
• O toca Elegir archivo… para seleccionar la clave en Archivos.
• Si la clave tiene frase de contraseña, Pockterm la pide una vez y la guarda en el Llavero junto a la clave.

Una clave que empieza por -----BEGIN RSA PRIVATE KEY----- está en el formato PEM antiguo. Conviértela con ssh-keygen -p -f <file> —reescribe el archivo sin cambiar la clave— y luego impórtala.

Crear credenciales

• En el editor de un host, elige Credenciales nuevas.
• Introduce el nombre de usuario y elige Contraseña o Clave.
• Para Clave, selecciona una de tus claves.

El terminal

Conectarse y trabajar en una sesión

Toca un host para abrir una sesión de terminal.

• La barra encima del teclado incluye esc, ctrl, tab, las teclas de flecha y más.
• Abre varios hosts a la vez: cada sesión es una pestaña en la parte superior. Toca su nombre para cambiar, o la ✕ roja para cerrarla.
• Toca el botón de fragmento para ejecutar un comando guardado en la sesión.

Fragmentos

Guarda y ejecuta comandos reutilizables

Los fragmentos son comandos que usas a menudo.

• En la pestaña Fragmentos, toca + para guardar un comando con una etiqueta.
• Mientras estés conectado, toca el botón de fragmento en el terminal para ejecutar uno.
• Asigna a un host un Fragmento de inicio para ejecutarlo automáticamente al conectar.

Grupos, favoritos y búsqueda

Mantén ordenada una lista larga de hosts

• En el menú Hosts, elige Gestionar grupos. Los grupos pueden anidarse, y los hosts heredan las credenciales y el puerto predeterminados de su grupo.
• Asigna un host a un grupo en el editor de hosts.
• Destaca un host (desliza a la izquierda) para fijarlo en la sección Favoritos.
• Desliza hacia abajo para buscar por etiqueta o dirección. Los hosts que has usado hace poco aparecen en Recientes.

Importar desde ssh_config

Importar hosts existentes

• En el menú Hosts, elige Importar desde ssh_config.
• Pega el texto de tu configuración o toca Elegir archivo.
• Revisa los hosts detectados, desactiva los que no quieras y toca Importar.

Pockterm lee los ajustes Host, HostName, User y Port. Se crean credenciales de contraseña para cada nombre de usuario, de modo que puedas rellenar el secreto después.

Transferir archivos (SFTP)

Explorar, descargar y subir archivos

Todos los hosts tienen un explorador de archivos SFTP. SFTP funciona sobre la misma conexión SSH, así que no hay nada más que configurar.

Abrir el explorador

• Mantén pulsado un host y elige Explorar archivos.
• O ajusta el Protocolo del host a SFTP (Archivos): al tocarlo se abrirá el explorador en lugar de un terminal.
• ¿Ya estás en una sesión? Toca el botón de carpeta en la barra superior del terminal.

Descargar un archivo

• Mantén pulsado el archivo y luego elige Descargar.
• Se abre en la hoja de compartir, así que puedes enviarlo a donde quieras; elige Guardar en Archivos para conservarlo, incluso en iCloud Drive.

Subir un archivo

• Toca + y luego Subir un archivo.
• Eso abre el selector de archivos del propio iPhone, así que puedes subir directamente desde iCloud Drive, En mi iPhone o cualquier otra ubicación de Archivos.
• El archivo se guarda en la carpeta que estás viendo en ese momento.

Gestionar archivos

• Mantén pulsado un archivo para renombrarlo, cambiar sus Permisos o eliminarlo.
• Toca + para crear una carpeta. Desliza hacia abajo para actualizar el listado.
• Toca .. en la parte superior para subir un directorio.

Las transferencias se envían por fragmentos, así que ni siquiera un archivo grande agotará la memoria. Mientras una está en curso, la barra de ruta muestra cuánto se ha transferido y el tamaño total.

Redirección de puertos

Tunelizar conexiones a través de SSH

La redirección de puertos encamina conexiones de red a través de un servidor SSH.

• Local: un puerto de tu dispositivo se redirige a un host al que el servidor puede llegar.
• Remoto: un puerto del servidor se redirige de vuelta a tu dispositivo.
• Dinámico: un proxy SOCKS5 en tu dispositivo envía cada conexión a través del servidor.

Ejecutar una redirección

• En la pestaña Redirección de puertos, toca + para añadir una.
• Toca una fila para editarla.
• Toca ▶ para iniciar; el estado indica cuándo está activa. Toca ⏹ para detenerla.

Verificar claves de host

Confiar en los servidores de forma segura

La primera vez que te conectas a un servidor, Pockterm muestra la huella de su clave y te pide que la aceptes. Esto se llama confianza en el primer uso.

• Acéptala solo si la huella coincide con la que esperas del propietario del servidor.
• Una vez aceptada, la clave se recuerda y no se te volverá a preguntar.
• Si más adelante un servidor presenta una clave distinta, Pockterm te avisa antes de continuar: puede significar que el servidor se reinstaló, o que algo va mal.

Tus datos y privacidad

Dónde se guarda todo

Pockterm no tiene cuentas, y los datos de tus conexiones permanecen en tu dispositivo.

• Los hosts, grupos, fragmentos y redirecciones se guardan en tu dispositivo.
• Las contraseñas y las claves privadas se guardan en el Llavero de iOS.
• Las claves de host aceptadas se recuerdan en tu dispositivo para los avisos descritos en Verificar claves de host.
• Las conversaciones con el asistente se guardan en tu dispositivo, una por host, así que el chat sigue ahí cuando vuelves a conectarte. Toca la papelera en el asistente para eliminar una.

El Asistente de IA es la única excepción: cuando lo usas, la salida relevante del terminal (y cualquier archivo que adjuntes) se envía al proveedor de modelos que configures —Anthropic, OpenAI, OpenRouter o Hugging Face— usando tu propia clave API. No se envía nada hasta que usas el asistente, y tu clave se guarda en el Llavero de iOS. Consulta la política de privacidad de tu proveedor para saber cómo tratan esos datos.