fail2ban protege SSH leyendo los registros de autenticación de sshd y bloqueando en el cortafuegos las IP que fallan demasiadas veces. Para SSH basta un archivo /etc/fail2ban/jail.local con la jaula [sshd] activada, un maxretry bajo y un bantime razonable. El resultado se comprueba con fail2ban-client status sshd.

Cómo bloquea fail2ban la fuerza bruta contra SSH

fail2ban lee los registros de autenticación de sshd y les aplica un filtro de expresiones regulares. Cuando una IP acumula maxretry fallos dentro de findtime, ejecuta una acción que la bloquea en el cortafuegos durante bantime. Pasado ese tiempo, la regla se retira sola.

Conviene tener claro el alcance. fail2ban reduce el ruido y el coste de los intentos automatizados contra el puerto TCP 22, pero no sustituye a la autenticación por clave. Si el servidor acepta contraseñas débiles, un atacante que reparte los intentos entre muchas IP puede seguir probando por debajo del umbral de cada una.

Configurar la jaula sshd de fail2ban en jail.local

La regla básica es no editar nunca /etc/fail2ban/jail.conf, porque las actualizaciones del paquete lo sobrescriben. Los cambios van en /etc/fail2ban/jail.local, que fail2ban lee después y que tiene prioridad.

En Debian o Ubuntu, la instalación y la apertura del archivo son estas:

sudo apt install fail2ban
sudo nano /etc/fail2ban/jail.local

Una configuración mínima y realista para SSH:

[DEFAULT]
ignoreip = 127.0.0.1/8 ::1
bantime  = 1h
findtime = 10m
maxretry = 3
bantime.increment = true

[sshd]
enabled = true
port    = ssh
backend = systemd

port = ssh equivale al 22. Si sshd escucha en otro puerto, pon el número real (port = 2222); si no, el bloqueo se aplicará a un puerto que nadie usa. backend = systemd hace que fail2ban lea el journal en distribuciones que no escriben /var/log/auth.log. Si tu sistema sí genera ese archivo, puedes omitir la línea. Para activar el servicio y recargarlo tras cada cambio:

sudo systemctl enable --now fail2ban
sudo systemctl restart fail2ban

Desde el móvil, guardar y salir de nano exige Ctrl+O y Ctrl+X. El teclado de termi1, una terminal SSH para iOS y Android, incluye Ctrl, Esc, Tab y flechas, así que editar jail.local no obliga a buscar un portátil.

Qué controlan bantime, findtime y maxretry en fail2ban

maxretry es el número de fallos permitidos, findtime la ventana en la que se cuentan y bantime la duración del bloqueo. Los dos últimos admiten sufijos de tiempo como m, h o d.

  • maxretry = 3: con autenticación por clave, un usuario legítimo casi nunca falla tres veces seguidas; un bot sí.
  • findtime = 10m: tres fallos repartidos a lo largo de una hora no cuentan; tres en diez minutos, sí.
  • bantime = 1h: basta para que el bot pase a otro objetivo, sin dejarte fuera un día entero si te equivocas tú.
  • bantime.increment = true: cada reincidencia de la misma IP alarga el bloqueo siguiente.

Un bantime negativo (-1) hace el bloqueo permanente. Es tentador, pero la lista crece sin límite, y una IP dinámica reasignada después a alguien legítimo queda vetada para siempre.

Comprobar fail2ban con fail2ban-client status sshd

El comando sudo fail2ban-client status sshd muestra el estado de la jaula. En la sección Filter aparecen los fallos actuales y totales; en la sección Actions, las IP bloqueadas ahora, el total de bloqueos y la lista de direcciones.

sudo fail2ban-client status
sudo fail2ban-client status sshd
sudo fail2ban-client get sshd bantime
sudo fail2ban-client set sshd unbanip 203.0.113.45
  • status sin argumentos lista las jaulas activas. Si sshd no aparece, falta enabled = true o hay un error de sintaxis; revisa sudo journalctl -u fail2ban.
  • status sshd con el total de fallos siempre a cero, mientras el journal muestra intentos fallidos, suele indicar un backend o una ruta de registro equivocados.
  • get sshd bantime confirma el valor que fail2ban ha cargado de verdad, no el que crees haber escrito.
  • set sshd unbanip retira el bloqueo de una IP concreta.

En termi1 puedes dictar «desbloquea la IP 203.0.113.45 en fail2ban»: la IA escribe el comando en el prompt sin pulsar Intro, y en el modo «Revisar» nunca lo ejecuta por ti. En una conexión etiquetada como producción, Production Guard retiene antes de llegar al prompt lo que detiene o cambia algo, como un systemctl restart.

fail2ban frente a otras defensas de SSH: tabla comparativa

La defensa que corta de raíz la fuerza bruta contra contraseñas es PasswordAuthentication no, documentada en la referencia oficial de sshd_config. fail2ban es una capa complementaria.

MedidaQué frenaQué no frenaRiesgo de quedarte fuera
fail2ban con jaula sshdBots que repiten intentos desde una misma IPAtaques repartidos entre muchas IPMedio si fallas varias veces seguidas
Solo claves (PasswordAuthentication no)Adivinar contraseñasEl ruido en los registrosBajo si guardas otra clave autorizada
Mover SSH fuera del puerto 22Los escaneos automáticos más básicosUn escaneo completo de puertosBajo; recuerda actualizar port en jail.local
Red privada en malla sin puerto públicoCualquier intento directo desde InternetAccesos desde dentro de la mallaBajo mientras la malla funcione

Evitar que fail2ban bloquee tu propia conexión SSH desde el móvil

ignoreip es la lista de direcciones que fail2ban nunca bloquea y la principal protección contra el autobaneo. El problema del móvil es que la IP cambia: la wifi de la oficina puede tener IP fija, pero la de datos móviles no se puede añadir de antemano.

  1. Ten una vía alternativa antes de tocar la configuración. La consola web del proveedor u otra red te permiten ejecutar unbanip si te bloqueas.
  2. Usa claves, no contraseñas. Sin contraseñas que teclear no hay erratas que sumen fallos. termi1 genera la clave en el propio móvil, la guarda en el almacén seguro del sistema y la clave privada no sale del dispositivo.
  3. Entra por una red privada en malla. Con una red privada en malla sin puertos como Prialo, o con Tailscale, llegas por una IP de la malla que no cambia. Añade su rango a ignoreip o deja de exponer el 22 a Internet.
  4. Ten en cuenta cómo funciona Mosh. Mosh arranca mosh-server mediante una conexión SSH inicial, y los fallos de esa autenticación cuentan en la jaula sshd. Después, el tráfico va por UDP en los puertos 60000-61000, que esa jaula no vigila. Que termi1 mantenga la sesión con Mosh al pasar de wifi a datos significa menos reconexiones y menos ocasiones de fallar.
  5. Deja el trabajo largo en tmux. Si una regla te corta, lo que estaba corriendo sigue ahí cuando vuelves a entrar.

Preguntas frecuentes

¿Dónde se configura fail2ban para SSH?

fail2ban se configura para SSH en /etc/fail2ban/jail.local, dentro de una sección [sshd] con enabled = true. El archivo jail.conf no se toca, porque las actualizaciones del paquete lo sobrescriben. Tras cada cambio hay que reiniciar el servicio con sudo systemctl restart fail2ban.

¿Qué valor de bantime conviene para SSH?

Un bantime de una hora, combinado con bantime.increment = true, equilibra bien protección y comodidad. El bot se marcha, cada reincidencia recibe un bloqueo más largo y, si te bloqueas por error, no pierdes el acceso durante días. Un valor -1 hace los bloqueos permanentes.

¿Cómo desbloquear una IP en fail2ban?

Una IP se desbloquea en fail2ban con sudo fail2ban-client set sshd unbanip seguido de la dirección. Antes conviene confirmar con sudo fail2ban-client status sshd que aparece en la lista de IP bloqueadas. Si la bloqueada es la tuya, ejecútalo desde otra red o desde la consola del proveedor.

¿fail2ban protege también las conexiones Mosh?

fail2ban protege la fase SSH de Mosh, porque mosh-server se arranca mediante una conexión SSH inicial cuyos fallos registra sshd. El tráfico posterior viaja por UDP en los puertos 60000-61000 y la jaula sshd no lo vigila, así que ese rango debe restringirse en el cortafuegos.