Documentación
Solución de problemas
Errores comunes y cómo solucionarlos — conexión, autenticación, monitoreo, bóveda.
Conexión
Conexión rechazada
El servidor está rechazando a nivel de red — todavía no es autenticación. Revisa en orden:
# 1. Is the host reachable at all
ping <host>
# 2. Is the SSH port actually open
nc -vz <host> 22
Causas comunes: puerto incorrecto (muchos hosts se mueven fuera del 22), un firewall o grupo de seguridad
que bloquea tu IP, o que sshd no esté en ejecución.
La conexión se queda colgada y luego expira
Los paquetes salen y no llega nada de vuelta — generalmente un firewall que descarta en lugar de rechazar. Si estás en una VPN, revisa eso primero.
Discrepancia de clave de host
La aplicación se detiene y muestra ambas huellas digitales. No la descartes por reflejo.
Una clave de host cambia por dos razones muy distintas: el servidor fue reinstalado (normal), o alguien está interceptando tu conexión (no normal). Confírmalo a través de un canal separado — la consola del proveedor, un colega que acaba de reinstalar la máquina — antes de elegir Olvidar clave de host y reconectar para confiar en la nueva.
Autenticación
Contraseña incorrecta o clave rechazada
-
Para una clave SSH: ¿pegaste la clave privada, no el archivo
.pub? Si tiene una frase de contraseña, ¿la ingresaste? -
¿Está realmente la clave pública correspondiente en
~/.ssh/authorized_keysde la cuenta correcta en el servidor? -
Revisa los permisos de archivo en el lado del servidor — la causa más comúnmente pasada por alto:
chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys -
¿El servidor siquiera permite el inicio de sesión por contraseña? Muchas instalaciones tienen por defecto
PasswordAuthentication no.
Los registros del lado del servidor te dicen exactamente por qué:
sudo journalctl -u sshd -n 50
Monitoreo
Activado pero aún sin datos
- ¿Está bloqueada la bóveda? El sondeo necesita credenciales; una bóveda bloqueada detiene todas las tareas — revisa la barra de estado.
- Aún no le toca. Las tareas comienzan en unos 15 segundos, y la primera muestra aparece después del primer sondeo exitoso. Presiona Sondear ahora para saltarte la espera.
- ¿Realmente hay una credencial de monitoreo seleccionada? Este es un campo distinto de la credencial predeterminada de la VM.
Falta el porcentaje de CPU o la tasa de red
Ambos se derivan entre dos sondeos. El primer sondeo no tiene nada con qué comparar, así que estos dos campos están vacíos hasta que llega el segundo.
Marcada como inaccesible, pero el SSH manual sigue funcionando
Un sondeo se descarta si no responde en 20 segundos. Una máquina muy cargada puede superar eso mientras una sesión interactiva aún se siente bien. Revisa la carga, y aumenta el intervalo de sondeo si el host simplemente es lento por naturaleza.
Bóveda
Pide la contraseña cada vez que se abre la aplicación
El llavero del sistema operativo no está disponible. En Linux, eso significa que no hay un Secret Service (GNOME Keyring, KWallet) en ejecución y desbloqueado. También es esperado si presionaste Bloquear bóveda la última vez.
Olvidé la contraseña maestra
No se puede recuperar, por diseño. Consulta Bóveda de contraseñas → Olvidé la contraseña maestra.
Cambio de contraseña interrumpido
Cambiar la contraseña maestra se ejecuta dentro de una transacción. Si se interrumpe, la transacción se revierte y la bóveda permanece en su estado anterior — desbloquea con la contraseña anterior e inténtalo de nuevo.
¿Sigues atascado?
Incluye esto cuando envíes un correo al soporte — determina si la respuesta tarda cinco minutos o cinco días:
- versión de la aplicación y sistema operativo,
- qué hiciste y qué pasó,
- el mensaje de error, textual,
- la distribución de Linux del servidor, si el problema está de ese lado.
No incluyas claves privadas, contraseñas ni el contenido de
authorized_keys. Ninguna parte del soporte los necesita.