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.localUna 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 = systemdport = 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 fail2banDesde 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
sshdno aparece, faltaenabled = trueo hay un error de sintaxis; revisasudo journalctl -u fail2ban. - status sshd con el total de fallos siempre a cero, mientras el journal muestra intentos fallidos, suele indicar un
backendo 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.
| Medida | Qué frena | Qué no frena | Riesgo de quedarte fuera |
|---|---|---|---|
| fail2ban con jaula sshd | Bots que repiten intentos desde una misma IP | Ataques repartidos entre muchas IP | Medio si fallas varias veces seguidas |
| Solo claves (PasswordAuthentication no) | Adivinar contraseñas | El ruido en los registros | Bajo si guardas otra clave autorizada |
| Mover SSH fuera del puerto 22 | Los escaneos automáticos más básicos | Un escaneo completo de puertos | Bajo; recuerda actualizar port en jail.local |
| Red privada en malla sin puerto público | Cualquier intento directo desde Internet | Accesos desde dentro de la malla | Bajo 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.
- Ten una vía alternativa antes de tocar la configuración. La consola web del proveedor u otra red te permiten ejecutar
unbanipsi te bloqueas. - 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.
- 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
ignoreipo deja de exponer el 22 a Internet. - Ten en cuenta cómo funciona Mosh. Mosh arranca
mosh-servermediante 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. - 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.