Guía operativa — qué hacer, paso a paso, para sacar el máximo partido a SSHBorg.
Pulsa el botón + en la pantalla de hosts para añadir un nuevo servidor.
ubuntu, root, deploy).En la primera conexión, SSHBorg muestra la huella del servidor y te pide que la aceptes. Es una comprobación de seguridad: garantiza que te estás conectando a la máquina correcta y no a un impostor. Verifica que la huella coincida con la que te proporcionó el administrador del servidor antes de aceptarla.
Una vez aceptada, la huella se almacena localmente. Si cambia en una conexión futura, SSHBorg te avisará — podría indicar una reinstalación del servidor, una rotación de claves o un ataque man-in-the-middle.
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pubEl gestor de archivos SFTP te permite explorar, subir, descargar, renombrar y eliminar archivos en tu servidor directamente desde el teléfono. Abre una sesión SFTP desde la pantalla de hosts tocando SFTP.
Toca una carpeta para abrirla. Usa la flecha de retroceso o toca cualquier segmento de la barra de ruta para subir en el árbol de directorios.
Los enlaces simbólicos se muestran con un pequeño distintivo de cadena. Al tocar un enlace simbólico se navega a su destino: si apunta a un directorio se entra en él; si apunta a un archivo se comporta como un archivo normal.
Toca el botón de subida (↑) para seleccionar uno o varios archivos del almacenamiento del teléfono. La subida comienza de inmediato y el progreso se muestra en la parte superior de la pantalla.
Toca cualquier archivo para descargarlo inmediatamente. Para descargar una carpeta completa, toca el icono de descarga que aparece junto a ella — SSHBorg descargará todo el árbol de directorios y lo guardará en la carpeta Descargas del teléfono.
Si un archivo ya existe en el destino, un diálogo te preguntará si deseas sobrescribir, omitir el archivo o cancelar toda la transferencia.
Mantén pulsado cualquier elemento para entrar en el modo de selección y toca otros elementos para ampliar la selección. La barra de herramientas muestra las acciones disponibles:
La autenticación por clave es más segura que las contraseñas y, una vez configurada, no requiere recordar ni escribir nada.
Ve a Ajustes → Claves SSH → Generar nueva clave. SSHBorg admite:
Ponle un nombre significativo a la clave (p. ej. mi-vps o servidor-trabajo) para identificarla más adelante.
Tras generar una clave, pulsa sobre ella para ver la clave pública. Cópiala y pégala en el archivo ~/.ssh/authorized_keys del servidor para el usuario con el que quieres iniciar sesión.
mkdir -p ~/.ssh
chmod 700 ~/.ssh
echo "ssh-ed25519 AAAA...tuclavecopiada..." >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keysPubkeyAuthentication yes en /etc/ssh/sshd_config. Es el valor predeterminado en la mayoría de distribuciones, pero algunas imágenes reforzadas lo deshabilitan.
SSHBorg ofrece una frase de contraseña adicional opcional para tus claves (Ajustes → Claves SSH → pulsa una clave → Activar cifrado). Cuando está activa, la clave se cifra con una frase que SSHBorg no almacena — se te pedirá cada vez que se use la clave.
Es muy recomendable si almacenas credenciales sensibles en tu teléfono o tienes el bloqueo biométrico desactivado.
SSHBorg muestra una barra de sugerencias sobre el teclado mientras escribes en el terminal. Las sugerencias provienen del historial de shell del usuario con el que te conectaste.
Al abrir una sesión de terminal, SSHBorg lee el archivo de historial de shell del servidor remoto. Comprueba las siguientes ubicaciones en orden:
~/.bash_history — predeterminado para shells Bash~/.zsh_history — predeterminado para Zsh (también comprobado como $HISTFILE si está configurado)~/.local/share/fish/fish_history — para usuarios de Fish shellSe usa el primer archivo que existe y es legible. Mientras escribes, los comandos se filtran en tiempo real y se muestran como chips en la barra de sugerencias. Pulsa un chip para insertar el comando.
No aparecen sugerencias
~/.bashrc:
HISTFILE=~/.bash_history
HISTSIZE=10000
HISTFILESIZE=20000~/.zshrc:
HISTFILE=~/.zsh_history
HISTSIZE=10000
SAVEHIST=10000
setopt APPEND_HISTORY SHARE_HISTORYLas sugerencias pertenecen al usuario equivocado
sudo su - root (o cambias a otro usuario con su), la barra de sugerencias sigue mostrando el historial del usuario de inicio de sesión original, no de root. Esto es porque SSHBorg lee el archivo de historial antes de que arranque el shell, usando las credenciales con las que te conectaste.
root (si tu servidor lo permite).
El terminal responde a algunos gestos táctiles además de la escritura:
Cuando el teclado virtual está abierto, aparece sobre él una fila de botones de acceso rápido. Desplaza la barra lateralmente para acceder a todas las teclas.
Ctrl y Alt son conmutadores persistentes — toca uno y luego toca una tecla de letra para enviar la combinación. Se resetean automáticamente tras la siguiente pulsación.
El icono de corrección ortográfica alterna el teclado entre modo terminal y modo palabra. En modo terminal (predeterminado) la autocorrección y las sugerencias de palabras están desactivadas — ideal para comandos y rutas de archivo. En modo palabra el teclado funciona como un campo de texto normal, con sugerencias y autocorrección activadas. Útil cuando se escribe lenguaje natural por SSH, por ejemplo con Claude Code u otras herramientas interactivas.
Desplaza la barra hacia la derecha para acceder a las teclas F1 a F12.
El reenvío del agente SSH permite usar las claves almacenadas en SSHBorg para autenticar conexiones adicionales realizadas desde dentro del servidor remoto — por ejemplo, para git clone de un repo privado, o para saltar a una segunda máquina.
Al añadir o editar un host, activa el interruptor Reenvío de agente. SSHBorg actuará como agente SSH para esa sesión.
El servidor debe permitir el reenvío de agente. Comprueba /etc/ssh/sshd_config:
AllowAgentForwarding yesEste es el valor predeterminado en la mayoría de sistemas. Después de modificarlo, reinicia el demonio SSH:
sudo systemctl restart sshdSi también te conectas a este servidor desde un portátil o escritorio, puedes configurar el reenvío de forma permanente en tu ~/.ssh/config local:
Host myserver
HostName 203.0.113.42
User ubuntu
ForwardAgent yesSSH es una conexión TCP activa entre tu teléfono y el servidor. Si la conexión se interrumpe — aunque sea por un segundo — la sesión y todo lo que se ejecutaba en ella se pierde.
Las redes móviles son especialmente propensas a las caídas de conexión por varias razones:
Un multiplexor de terminal ejecuta una sesión persistente en el servidor, completamente independiente de tu conexión SSH. Si la conexión cae, la sesión y todo lo que ejecuta sigue funcionando. Al reconectarte, te reincorporas y encuentras todo exactamente como lo dejaste.
Es el hábito más útil para quien gestiona servidores desde el teléfono.
tmux está disponible en la mayoría de distribuciones Linux modernas y es la opción recomendada.
# Iniciar una nueva sesión con nombre
tmux new -s work
# Desconectarse de la sesión (dejarla en ejecución)
Ctrl+B, luego D
# Listar sesiones en ejecución
tmux ls
# Reconectarse a una sesión
tmux attach -t work
# Reconectarse a la sesión más reciente
tmux attachscreen es más antiguo pero disponible en prácticamente cualquier sistema Unix, incluyendo imágenes mínimas donde tmux puede no estar instalado.
# Iniciar una nueva sesión con nombre
screen -S work
# Desconectarse de la sesión
Ctrl+A, luego D
# Listar sesiones en ejecución
screen -ls
# Reconectarse a una sesión
screen -r worktmux attach || tmux new -s maintmux attach || tmux new -s main a tu ~/.bashrc o ~/.zshrc en el servidor para que una sesión de multiplexor se inicie automáticamente cada vez que inicies sesión a través de SSHBorg.
Un jump host (también llamado bastion host) es un servidor intermedio a través del cual debes pasar para llegar a un servidor de destino no accesible directamente desde internet. SSHBorg admite cadenas de salto simples y multi-salto de forma nativa.
Si necesitas saltar a través de más de un servidor intermedio (p. ej. internet → bastión → dmz → destino), crea una entrada para cada salto y encadénalas:
La configuración equivalente en un ~/.ssh/config de escritorio tiene este aspecto:
Host bastion
HostName bastion.example.com
User admin
ForwardAgent yes
Host target
HostName 10.0.1.50
User ubuntu
ProxyJump bastion
ForwardAgent yesCon esta configuración, ssh target en tu portátil salta de forma transparente a través del bastión.
SSHBorg te permite mantener abiertas varias sesiones de terminal SSH y gestor de archivos SFTP al mismo tiempo, incluso hacia servidores diferentes.
tmux o screen en el servidor si quieres que sobrevivan incluso a una caída de la conexión SSH.
Activa el bloqueo biométrico en Ajustes → Seguridad → Bloqueo biométrico. Cuando está activo, SSHBorg requiere huella dactilar o reconocimiento facial antes de mostrar cualquier host, credencial o dato de sesión.
Puedes establecer un tiempo de espera por inactividad — tras ese número de minutos en segundo plano, la app se bloquea automáticamente.
Por defecto, SSHBorg bloquea las capturas de pantalla y la grabación de pantalla para evitar que el contenido sensible del terminal se filtre a través de la pantalla de apps recientes o herramientas de captura.
Si necesitas hacer una captura (p. ej. para compartir una salida del terminal), puedes desactivar temporalmente la protección en Ajustes → Seguridad → Permitir capturas.
Todas las credenciales (contraseñas, claves privadas, frases de contraseña) se almacenan cifradas usando el Android Keystore — un enclave seguro respaldado por hardware disponible en Android 10+. Nunca se escriben en almacenamiento externo ni se transmiten a ningún lugar.
SSHBorg puede exportar e importar configuraciones de hosts como archivo JSON. Esto permite transferir la lista de servidores a otro dispositivo o conservar una copia de seguridad portátil de tu configuración.
Ve a Ajustes → Copia de seguridad → Exportar hosts. Elige dónde guardar el archivo usando el selector de archivos del sistema. El archivo se llama sshborg_hosts.json por defecto.
Ve a Ajustes → Copia de seguridad → Importar hosts. Selecciona el archivo .json exportado previamente (o creado manualmente). SSHBorg lo fusionará con la lista de hosts existente:
El archivo exportado es un objeto JSON estándar. También puedes crearlo manualmente para importar en bloque una lista de servidores desde otra fuente.
{
"version": 1,
"exported_at": "2026-05-14T10:00:00Z",
"hosts": [
{
"label": "Mi VPS",
"hostname": "203.0.113.42",
"port": 22,
"username": "ubuntu",
"agentForwarding": false,
"jumpMode": "simple",
"jumpHosts": null,
"jumpHostIdList": null,
"portForwardings": null,
"sftpStartMode": "last",
"sftpStartDir": null
}
]
}label — nombre mostrado en SSHBorg. Se usa como clave única para la fusión al importar. Obligatorio.hostname — dirección o IP del servidor (IPv4 o IPv6). Obligatorio.port — puerto SSH. Por defecto: 22.username — usuario de inicio de sesión. Obligatorio.agentForwarding — true para habilitar el reenvío del agente SSH. Por defecto: false.jumpMode — "simple" (usa el texto de jumpHosts) o "host_list" (usa IDs internos de SSHBorg). Usa "simple" al crear el archivo manualmente.jumpHosts — jump hosts separados por comas en formato [usuario@]host[:puerto]. Solo se usa cuando jumpMode es "simple".portForwardings — reglas de reenvío de puerto local separadas por saltos de línea en sintaxis SSH -L, p. ej. "8080:localhost:8080".sftpStartMode — directorio de inicio SFTP: "last" (recordar el último visitado), "fixed" (usar siempre sftpStartDir), "home" (directorio principal del servidor). Por defecto: "last".sftpStartDir — ruta a usar cuando sftpStartMode es "fixed".label, hostname y username son opcionales. Los campos omitidos adoptan sus valores por defecto.