¿Cómo instalar y configurar Fail2ban en un VPS Debian o Ubuntu?
Instalar Fail2ban, escribir un jail.local para SSH y nginx, banear y desbanear una IP, leer el estado de las jaulas y evitar los errores habituales con
Fail2ban lee los registros de sus servicios y banea durante un tiempo determinado las direcciones IP que acumulan fallos: contraseñas SSH probadas en bucle, escaneos de páginas de administración, inicios de sesión web fallidos. En un VPS expuesto a Internet, los intentos en el puerto 22 empiezan pocos minutos después de la entrega. Esta guía instala Fail2ban en Debian 12 / 13 o Ubuntu 22.04 / 24.04, protege SSH y nginx y después muestra cómo comprobar, banear y desbanear una dirección.
Procedimiento paso a paso
-
Instalar Fail2ban
Actualice la lista de paquetes y luego instale fail2ban junto con nftables y python3-systemd, que le permiten banear con nftables y leer el diario de systemd. El servicio arranca de inmediato con la configuración por defecto.
-
Crear el archivo jail.local
No modifique nunca /etc/fail2ban/jail.conf, que se sustituye en cada actualización. Escriba sus ajustes en /etc/fail2ban/jail.local: duración del baneo, ventana de observación, número de fallos, direcciones que no deben banearse nunca y acción de nftables.
-
Proteger SSH
Active la jaula [sshd] con backend = systemd: en Debian, SSH escribe en el diario de systemd y a menudo el archivo /var/log/auth.log no existe. Si SSH escucha en un puerto distinto del 22, indíquelo con port.
-
Añadir las jaulas de nginx
Si nginx se ejecuta en el VPS, active nginx-http-auth para las contraseñas de autenticación HTTP fallidas y nginx-botsearch para los bots que buscan páginas de administración. Ambas jaulas leen /var/log/nginx/error.log.
-
Probar y reiniciar
Compruebe la sintaxis con fail2ban-client -t, reinicie con systemctl restart fail2ban y luego liste las jaulas activas con fail2ban-client status.
-
Comprobar, banear y desbanear
fail2ban-client status sshd muestra los fallos contabilizados y las direcciones baneadas. fail2ban-client set sshd unbanip 198.51.100.7 libera una dirección y fail2ban-client set sshd banip 198.51.100.7 la banea manualmente.
Instalación en Debian y Ubuntu
apt update
apt install -y fail2ban nftables python3-systemd
systemctl enable --now fail2ban
fail2ban-client version
/etc/fail2ban/jail.local
[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 5
bantime.increment = true
bantime.maxtime = 1w
ignoreip = 127.0.0.1/8 ::1 203.0.113.10
banaction = nftables-multiport
banaction_allports = nftables-allports
[sshd]
enabled = true
port = ssh
backend = systemd
journalmatch = _SYSTEMD_UNIT=ssh.service + _COMM=sshd + _COMM=sshd-session
maxretry = 4
[nginx-http-auth]
enabled = true
[nginx-botsearch]
enabled = true
Probar y aplicar la configuración
fail2ban-client -t
systemctl restart fail2ban
fail2ban-client status
fail2ban-client status sshd
Banear, desbanear y listar direcciones
fail2ban-client banned
fail2ban-client set sshd banip 198.51.100.7
fail2ban-client set sshd unbanip 198.51.100.7
fail2ban-client unban 198.51.100.7
nft list table inet f2b-table
Comprobar que un filtro reconoce los fallos
fail2ban-regex systemd-journal sshd
fail2ban-regex /var/log/nginx/error.log nginx-botsearch
tail -n 50 /var/log/fail2ban.log
Variante con UFW
[DEFAULT]
banaction = ufw
banaction_allports = ufw
Antes de empezar
Conéctese como root con ssh root@IP, o anteponga sudo a cada comando. Anote la dirección IP pública desde la que administra el VPS y añádala a ignoreip: de lo contrario, equivocarse varias veces al escribir su propia contraseña basta para banearse a sí mismo.
- Fail2ban complementa el acceso SSH con clave, no lo sustituye: una vez instalada la clave, desactive la autenticación por contraseña (vea « ¿Qué proteger antes de mi primer despliegue de VPS? »).
- Las direcciones 203.0.113.10 y 198.51.100.7 de los ejemplos son direcciones de documentación: sustitúyalas por las suyas.
- Si se queda bloqueado, la consola noVNC del panel de ACLClouds no pasa por SSH: siempre le permite desbanear su dirección.
Entender los ajustes de jail.local
Una jaula asocia un filtro (las expresiones que reconocen un fallo en un registro), una fuente de registros y una acción de baneo. La sección [DEFAULT] fija los valores comunes y cada jaula puede sobrescribirlos.
- maxretry, findtime y bantime: aquí, 5 fallos en 10 minutos suponen un baneo de una hora; para SSH bastan 4 fallos.
- bantime.increment = true alarga el baneo con cada reincidencia, hasta bantime.maxtime (una semana).
- ignoreip acepta direcciones y rangos separados por espacios, tanto en IPv4 como en IPv6.
- banaction = nftables-multiport crea la tabla inet f2b-table en nftables y bloquea en ella las direcciones baneadas, tanto en IPv4 como en IPv6, en los puertos de la jaula.
- backend = systemd y journalmatch hacen que la jaula [sshd] lea el diario de systemd y no un archivo. La línea journalmatch cubre Ubuntu y Debian, incluido OpenSSH 10 en Debian 13, donde los mensajes proceden de sshd-session.
Fail2ban con nftables o UFW
Debian 12 y 13 usan nftables. La acción nftables-multiport funciona ahí sin más ajustes, aunque UFW esté instalado: Fail2ban guarda sus reglas en su propia tabla. En Ubuntu, puede preferir la acción ufw (bloque « Variante con UFW ») para ver los baneos en ufw status.
Fail2ban bloquea el tráfico que entra en el propio VPS. Los puertos publicados por Docker pasan por la cadena FORWARD y escapan a estas reglas: para proteger un servicio en un contenedor, use banaction = iptables-multiport y añada chain = DOCKER-USER en su jaula.
Errores habituales que conviene evitar
La mayoría de las instalaciones que « no banean nada » tienen una de estas causas. fail2ban-client status sshd permite distinguirlas: si Total failed sigue en 0 mientras llegan intentos, el filtro no está leyendo el registro correcto.
- Modificar jail.conf en lugar de jail.local: los cambios desaparecen con la siguiente actualización del paquete.
- Activar una jaula de nginx sin tener nginx instalado: falta el archivo de registro y Fail2ban se niega a arrancar.
- Cambiar el puerto SSH sin actualizar port en [sshd]: la dirección se banea en el puerto 22, no en el nuevo.
- Olvidar su propia dirección en ignoreip y banearse a sí mismo al hacer pruebas.
- Escribir backend = systemd en [DEFAULT]: las jaulas de nginx, que leen archivos, dejan de ver nada.
Verificación rápida
- systemctl is-active fail2ban responde active.
- fail2ban-client status lista sshd y, si nginx está instalado, las jaulas de nginx.
- fail2ban-regex systemd-journal sshd encuentra líneas coincidentes.
- Su propia dirección IP figura en ignoreip.
- nft list table inet f2b-table muestra las direcciones baneadas.
Preguntas frecuentes
Fail2ban no arranca y muestra Have not found any log file for sshd jail: ¿qué hago?
La jaula busca /var/log/auth.log, que no existe cuando SSH solo escribe en el diario de systemd, algo habitual en Debian. Añada backend = systemd en la sección [sshd] de jail.local, instale python3-systemd y vuelva a ejecutar systemctl restart fail2ban.
¿Cómo desbanear una dirección IP con Fail2ban?
Ejecute fail2ban-client set sshd unbanip 198.51.100.7 sustituyendo la jaula y la dirección, o fail2ban-client unban 198.51.100.7 para quitarla de todas las jaulas. Si es su propia dirección y SSH ya no responde, conéctese por la consola noVNC del panel para lanzar el comando.
¿Cómo ver las direcciones baneadas?
fail2ban-client status sshd muestra el número de direcciones baneadas y su lista para una jaula; fail2ban-client banned las muestra para todas las jaulas. En el lado del cortafuegos, nft list table inet f2b-table muestra los conjuntos de direcciones bloqueadas.
En Ubuntu 24.04, Fail2ban se detiene con No module named 'asynchat': ¿por qué?
La primera versión de Fail2ban incluida en Ubuntu 24.04 no era compatible con Python 3.12. La corrección está publicada en los repositorios: ejecute apt update && apt install --only-upgrade fail2ban y después systemctl restart fail2ban.
Llegan intentos pero Total failed sigue en 0: ¿qué compruebo?
El filtro no lee los mensajes correctos. Pruébelo con fail2ban-regex systemd-journal sshd: la línea Lines: ... matched debe ser mayor que 0. Si no, compruebe backend = systemd y la línea journalmatch de la jaula [sshd], y luego el nombre del servicio con systemctl status ssh.
¿Basta Fail2ban para proteger un VPS?
No. Reduce el ruido de los ataques de fuerza bruta y aligera los registros, pero una clave SSH, el acceso por contraseña desactivado, un cortafuegos que solo deje pasar los puertos necesarios y las actualizaciones periódicas siguen siendo imprescindibles.