Solución de Problemas

Esta guía cubre problemas comunes y sus soluciones. Si no encuentras tu problema aquí, por favor contacta a soporte.

Problemas de Conexión

La Conexión SSH Falla

Síntomas: No se puede conectar al servidor SSH, tiempo de espera de conexión

Soluciones:

Verifica que el servidor esté accesible: prueba ping hostname
Verifica que el puerto SSH sea correcto (predeterminado: 22)
Comprueba que el firewall permita conexiones SSH
Verifica que el servicio SSH esté ejecutándose en el servidor
Prueba conectar con otro cliente SSH para aislar el problema

Autenticación Rechazada

Síntomas: "Permiso denegado", "Autenticación fallida"

Soluciones:

Verifica que el nombre de usuario sea correcto
Comprueba que la contraseña sea correcta
Si usas autenticación por clave:
- Verifica que la clave privada sea correcta
- Comprueba que la clave pública esté en authorized_keys del servidor
- Verifica los permisos del archivo de clave (debe ser 600)
- Asegúrate de que la frase de paso de la clave sea correcta
Verifica los logs del servidor: /var/log/auth.log

Conexión se Cae

Síntomas: La conexión se desconecta después de un tiempo

Soluciones:

Habilita keep-alive SSH en la configuración de conexión
Comprueba la estabilidad de tu conexión de red
Verifica la configuración de timeout del servidor
Revisa si hay firewalls intermedios que cierran conexiones inactivas

El Jump Host No Funciona

Síntomas: No se puede conectar a través del jump host

Soluciones:

Verifica que puedas conectar al jump host directamente
Comprueba que el jump host pueda alcanzar el host de destino
Verifica las credenciales para ambos hosts
Asegúrate de que el jump host permita port forwarding

Problemas del Terminal

El Terminal No Responde

Síntomas: No puedes escribir, el terminal está congelado

Soluciones:

La sesión puede estar bloqueada - prueba Ctrl+Q
Un proceso puede estar esperando entrada - prueba Enter
Cierra la pestaña y reconecta
Reinicia la aplicación

Caracteres Incorrectos

Síntomas: Caracteres extraños, salida corrupta

Soluciones:

El servidor puede tener diferentes configuraciones de locale
Prueba: export LANG=en_US.UTF-8
Verifica que la fuente del terminal soporte los caracteres
Escribe reset para reiniciar el estado del terminal

Los Colores No Aparecen

Síntomas: El terminal muestra solo texto sin colores

Soluciones:

Verifica que TERM esté configurado: echo $TERM
Prueba: export TERM=xterm-256color
Comprueba la configuración de colores de tu shell
Verifica el tema del terminal en configuración

Problemas de la Aplicación

La Aplicación No Inicia

Síntomas: Termial no se abre o se cierra inmediatamente

Soluciones:

Reinicia tu computadora
Verifica actualizaciones disponibles
En macOS: intenta lanzar desde Terminal para ver errores
Reinstala la aplicación
Verifica los requisitos del sistema

Uso Alto de Memoria

Síntomas: La aplicación usa demasiada memoria

Soluciones:

Cierra pestañas de terminal que no uses
Reduce el tamaño del scrollback en configuración
Reinicia la aplicación periódicamente
Actualiza a la última versión

La Aplicación se Congela

Síntomas: Toda la aplicación deja de responder

Soluciones:

Espera unos segundos - puede estar procesando
Forzar cierre y reiniciar
Verifica los recursos del sistema (CPU, memoria)
Actualiza a la última versión

Problemas de Sincronización en la Nube

Los Datos No se Sincronizan

Síntomas: Los cambios no aparecen en otros dispositivos

Soluciones:

Verifica la conexión a internet
Asegúrate de haber iniciado sesión
Verifica el estado de sincronización en configuración
Prueba sincronización manual
Verifica que la sincronización esté habilitada

Frase de Paso de Cifrado Olvidada

Síntomas: No puedes acceder a datos sincronizados

Soluciones:

Prueba frases de paso que podrías haber usado
Si no puedes recordarla, debes restablecer:
- Ve a Configuración → Cuenta
- Haz clic en ¿Olvidaste la frase de paso?
- Esto eliminará todos los datos sincronizados
- Configura una nueva frase de paso
- Re-añade tus datos

Conflictos de Sincronización

Síntomas: Datos incorrectos o faltantes después de sincronizar

Soluciones:

Los cambios más recientes generalmente ganan
Re-añade elementos faltantes
Verifica todos los dispositivos por inconsistencias
Contacta soporte si el problema persiste

Problemas del Asistente IA

La IA No Responde

Síntomas: El asistente IA no da respuestas

Soluciones:

Verifica la conexión a internet
Verifica que la IA esté habilitada en configuración
Comprueba si has alcanzado límites de uso
Prueba cerrar y abrir el panel de IA
Reinicia la aplicación

Sugerencias de IA Incorrectas

Síntomas: La IA sugiere comandos incorrectos

Soluciones:

Proporciona más contexto en tu pregunta
Especifica tu sistema operativo si es relevante
La IA hace sugerencias de mejor esfuerzo - siempre verifica
Usa modo contexto para dar contexto de salida del terminal

Problemas de SFTP

No se Puede Navegar Archivos

Síntomas: El navegador de archivos no carga

Soluciones:

Verifica que la conexión SSH esté activa
Comprueba permisos en el servidor
Verifica que SFTP esté habilitado en el servidor
Prueba navegar a un directorio diferente

La Transferencia de Archivos Falla

Síntomas: Las subidas o descargas fallan

Soluciones:

Verifica el espacio disponible en disco
Comprueba permisos de archivos
Verifica estabilidad de la conexión
Intenta archivos más pequeños primero
Revisa límites de tamaño de archivo

Obtener Ayuda

Si ninguna de estas soluciones funciona:

Verifica los registros de la aplicación
- Ayudan a diagnosticar problemas
- Accesibles desde configuración
Busca problemas conocidos
- Visita nuestro sitio de soporte
- Revisa issues conocidos
Contacta soporte
- Envía una solicitud de soporte
- Incluye:
  - Tu sistema operativo y versión
  - Versión de Termial
  - Pasos para reproducir el problema
  - Mensajes de error (si los hay)
  - Extractos de registros relevantes