Tutoriales de VPS
Configurar Fail2Ban: SSH, bloqueos progresivos y firewall
Configura archivos locales, umbrales, bloqueos progresivos y una lista administrativa limitada. Verifica registros, filtros y aplicación real; añade jails Nginx y propios, coordina UFW y Docker y comprende los límites de CDN y persistencia.

Un servicio SSH expuesto a internet suele recibir intentos automáticos de acceso. Comprueba los registros para conocer tu situación:
grep "Failed password" /var/log/auth.log | wc -l
Las claves SSH reducen el riesgo de contraseñas adivinadas. Fail2Ban añade detección de fallos repetidos y solicita a una acción de firewall u otro mecanismo compatible un bloqueo temporal. Complementa autenticación y filtrado de puertos, sin impedir que una inundación distribuida llegue a la red.
- Un filtro lee archivos o el journal.
- Los fallos de una dirección alcanzan
maxretrydentro defindtime. - Una acción aplica el bloqueo durante
bantime.
Fail2Ban delega la aplicación de la medida, normalmente en iptables o nftables. Las acciones antiguas basadas en hosts.deny solo sirven para servicios que admitan TCP wrappers. Detectar un fallo y bloquear realmente una conexión son dos comprobaciones distintas.
sudo grep -c "Failed password" /var/log/auth.log
sudo grep "Failed password" /var/log/auth.log | awk '{print $(NF-3)}' | sort | uniq -c | sort -rn | head -10
El segundo comando agrupa direcciones en un formato concreto de Failed password. Revisa líneas reales porque las posiciones pueden variar. Si falta auth.log, consulta el journal; la ausencia del archivo no demuestra ausencia de ataques.
sudo apt update
sudo apt install -y fail2ban
La versión depende de la distribución y los repositorios. Cifras como 1.0.2 o 1.1.1 son referencias, no una combinación universal de versiones actuales de Ubuntu y upstream. Consulta fail2ban-client --version y el soporte de seguridad del paquete antes de cambiar de origen.
sudo systemctl enable --now fail2ban
sudo systemctl status fail2ban
Que sshd esté habilitado inicialmente depende del paquete. Comprueba los jails activos: tener el servicio instalado no prueba que proteja SSH.
| Archivo | Función |
|---|---|
/etc/fail2ban/jail.conf | Configuración base del paquete |
/etc/fail2ban/jail.d/*.conf | Configuración adicional cargada después |
/etc/fail2ban/jail.local | Ajustes propios |
Conserva jail.conf y utiliza jail.local o archivos locales adicionales. jail.d/*.local se lee después de jail.local, por lo que debes comprobar la configuración efectiva.
Guarda cualquier configuración local existente antes del ejemplo: tee reemplaza el archivo. Añade tu lista real de administración y adapta el puerto SSH:
sudo tee /etc/fail2ban/jail.local > /dev/null <<'EOF'
[DEFAULT]
# 封禁时长(首次)
bantime = 1h
# 统计窗口
findtime = 10m
# 窗口内失败多少次就封
maxretry = 5
# 递增封禁:反复来的 IP 越封越久
bantime.increment = true
bantime.factor = 1
bantime.maxtime = 1w
# 白名单:自己的固定 IP 写这里,避免把自己封了
ignoreip = 127.0.0.1/8 ::1
[sshd]
enabled = true
backend = systemd
EOF
Mantén una sesión abierta y la consola del proveedor disponible. Valida con sudo fail2ban-client -t antes de reiniciar:
sudo systemctl restart fail2ban
sudo fail2ban-client status
| Parámetro | Referencia habitual | Significado |
|---|---|---|
bantime | 10m | Duración del bloqueo |
findtime | 10m | Ventana de observación |
maxretry | 5 | Umbral de fallos |
ignoreip | 127.0.0.1/8 ::1 | Direcciones exentas |
bantime = 10m puede resultar corto para reincidentes, pero una duración mayor también amplía el daño de un falso positivo. Una hora es un punto inicial de política, sin garantía contra atacantes que cambian de dirección.
| Política | Ejemplo | Compromiso |
|---|---|---|
| Tolerante | maxretry=10, findtime=10m, bantime=30m | Menos bloqueos accidentales; admite más fallos |
| Punto de partida equilibrado | maxretry=5, findtime=10m, bantime=1h | Umbral y duración moderados |
| Estricta | maxretry=3, findtime=1h, bantime=1d | Más riesgo en redes compartidas o dinámicas |
Evita la opción estricta si cambias de IP a menudo o varios usuarios legítimos comparten la salida.
bantime.increment = true
bantime.factor = 1
bantime.maxtime = 1w
La fórmula exponencial puede multiplicar la duración aproximadamente por 1, 2, 4, 8 y 16; historial, factores y multiplicadores alternativos cambian el resultado. bantime.maxtime limita el máximo:
bantime.formula = ban.Time * (1<<(ban.Count if ban.Count<20 else 20)) * banFactor
La propia fórmula limita el desplazamiento binario, así que no implica duplicación literalmente ilimitada. Conserva historial suficiente para la política elegida. bantime.rndtime añade variación aleatoria, sin resolver por sí sola una botnet distribuida.
ignoreip = 127.0.0.1/8 ::1 203.0.113.5 198.51.100.0/24
Las direcciones son ejemplos de documentación: reemplázalas. Se admiten IP, CIDR y resolución de nombres compatible. Separa valores por espacios y considera cambios de DNS/dirección.
- Tu dirección fija de administración, si existe.
- El servidor de salto administrativo.
- Fuentes de monitorización que realmente necesitan este acceso.
- Solo las subredes internas de confianza que requieren exención.
No eximas redes amplias sin saber quién puede utilizarlas. ignoreself suele valer true para ignorar direcciones del propio servidor; comprueba el valor efectivo.
Si te bloqueas, entra mediante la consola del proveedor y utiliza fail2ban-client set sshd unbanip 你的IP con tu IP real. Consulta la recuperación de acceso.
[sshd]
backend = systemd
| Backend | Fuente | Consideraciones |
|---|---|---|
systemd | Journal del sistema | Necesita integración y selección de registros correctas |
auto | Selección automática de backend de archivos | Depende de módulos y versión |
pyinotify | Notificaciones de archivos | Requiere la integración Python correspondiente |
polling | Consulta periódica de archivos | Compatible, con retraso de sondeo |
systemd sirve cuando SSH escribe en el journal en vez de /var/log/auth.log. auto no transforma automáticamente una ruta ausente en lectura del journal: revisa errores de arranque y la fuente utilizada.
Con systemd se utiliza journalmatch, no logpath. El filtro normalmente incorpora una selección, pero el ejemplo _SYSTEMD_UNIT=sshd.service debe coincidir con la unidad real; algunos sistemas utilizan ssh.service. Verifica cualquier cambio contra fallos registrados.
sudo fail2ban-client status
# 应该列出 sshd
sudo fail2ban-client status sshd
# 会显示当前封禁数量、总封禁数、以及被封的 IP 列表
# 用 systemd journal
sudo fail2ban-regex systemd-journal /etc/fail2ban/filter.d/sshd.conf
# 或者指定日志文件
sudo fail2ban-regex /var/log/auth.log /etc/fail2ban/filter.d/sshd.conf
Observa Lines: ... matched. Cero coincidencias puede indicar un filtro incorrecto o una muestra sin fallos. Usa un fallo conocido y verifica tiempo, selección del journal y dirección extraída.
sudo fail2ban-regex --print-all-matched systemd-journal /etc/fail2ban/filter.d/sshd.conf | head -30
# 看当前的 iptables 规则里有没有 f2b 链
sudo iptables -L -n | grep -A5 f2b
Una cadena f2b-sshd puede crearse solo cuando llega el primer bloqueo. Su ausencia antes de eso no demuestra fallo; una acción nftables también requiere revisar nft. Comprueba puertos, familia IPv4/IPv6 y recorrido del tráfico.
Prepara consola y desbloqueo. El bucle es interactivo y debe apuntar a tu propio servidor:
# 在测试机上故意输错
for i in $(seq 1 6); do ssh wronguser@your-server; done
Si deshabilitaste contraseñas, utiliza fallos que reconozca el filtro real sin volver a habilitarlas para la prueba.
sudo fail2ban-client status sshd
# 应该能看到那个 IP 出现在 Banned IP list 里
Comprueba la lista y una conexión nueva, y desbloquea después la dirección de prueba.
sudo tail -f /var/log/fail2ban.log
journalctl -u fail2ban -f
Busca Ban, errores de acción y Unban, además del estado del proceso.
sshd es uno de los disponibles. Revisa los filtros instalados:
ls /etc/fail2ban/filter.d/ | head -40
[nginx-http-auth]
enabled = true
port = http,https
logpath = %(nginx_error_log)s
maxretry = 5
bantime = 1h
Verifica la ruta y un fallo conocido. Si el backend global es systemd, selecciona un backend de archivos para este jail basado en error.log.
[nginx-botsearch]
enabled = true
port = http,https
logpath = %(nginx_error_log)s
nginx-botsearch reconoce patrones concretos del registro. No es un limitador general de frecuencia; configura esa función por separado en Nginx.
[wordpress]
enabled = true
filter = wordpress
port = http,https
logpath = /var/log/nginx/access.log
maxretry = 3
bantime = 2h
Este ejemplo necesita un filtro wordpress compatible y registros que distingan accesos fallidos. Un access.log que devuelve HTTP 200 tanto para éxito como para fallo no basta. Un complemento mantenido que limite intentos puede aportar contexto de aplicación; valida la integración antes de activar el jail.
Comprueba el formato del registro de confianza:
sudo tail -20 /var/log/myapp/auth.log
# 2026-09-29 10:23:11 FAILED login from 203.0.113.5 user=admin
Crea /etc/fail2ban/filter.d/myapp.conf:
[Definition]
failregex = ^.*FAILED login from <HOST>.*$
ignoreregex =
<HOST> extrae una dirección, pero hay más requisitos. Restringe el patrón amplio del ejemplo a un prefijo estructurado de confianza para que texto controlado por usuarios no identifique la IP de otra persona. Prueba fechas, IPv4/IPv6, fallos reales y ejemplos negativos como accesos correctos.
sudo fail2ban-regex /var/log/myapp/auth.log /etc/fail2ban/filter.d/myapp.conf
Ajusta con fail2ban-regex antes de habilitar el jail:
[myapp]
enabled = true
filter = myapp
port = http,https
logpath = /var/log/myapp/auth.log
maxretry = 5
findtime = 10m
bantime = 1h
Con una política UFW existente, comprueba banaction. iptables-multiport es un ejemplo común, sin ser el valor actual de todas las distribuciones. Las cadenas y su orden dependen de la acción y el backend efectivos.
limit de UFW limita intentos de conexión; Fail2Ban analiza fallos registrados. Pueden complementarse. Si decides cambiar limit por allow, verifica la regla exacta, el puerto personalizado y el nuevo permiso antes de borrar nada. El ejemplo puede no coincidir con una regla creada con otro nombre:
sudo ufw delete limit ssh
sudo ufw allow OpenSSH
Comprueba reglas iptables/nftables e IPv6:
sudo iptables -L -n | grep f2b # 有输出说明 iptables 兼容层在工作
sudo nft list ruleset | grep f2b # 或者看 nftables 里有没有
Elige una acción compatible como nftables-multiport si corresponde. Algunas crean reglas con el primer bloqueo, por lo que conviene una prueba controlada. No utilices ufw disable como reinicio general: cambiar UFW puede afectar acceso y bloqueos según el conjunto de reglas.
El tráfico publicado con -p 8080:8080 puede pasar por reglas de reenvío que no alcanzan bloqueos del INPUT del anfitrión. Una aplicación privada puede vincularse a 127.0.0.1 y recibir tráfico público mediante un proxy del anfitrión:
ports:
- "127.0.0.1:8080:8080"
Lee los registros correctos y aplica el bloqueo en ese recorrido. Con CDN, el par de red todavía puede ser un nodo CDN, no el visitante; el proxy local no resuelve automáticamente esa diferencia.
No hay bloqueos: revisa el jail, un fallo conocido y los errores de acción:
# 1. jail 启用了吗
sudo fail2ban-client status
# 2. 能匹配到日志吗(最可能的问题)
sudo fail2ban-regex systemd-journal /etc/fail2ban/filter.d/sshd.conf
# 3. server 和 jail 的日志
sudo tail -50 /var/log/fail2ban.log
Cero resultados en fail2ban-regex exige revisar entrada, fechas y filtro.
Desbloqueo demasiado rápido: examina bantime y Unban. 10m es una referencia; reinicios, cambios e historial también influyen.
La dirección sigue conectando: revisa reenvío, IPv6, puertos, conexiones ya establecidas y orden. Con CDN, configura real_ip para confiar solo en cabeceras de proxies conocidos. Cambiar la IP registrada no modifica el origen del paquete: bloquear visitantes detrás de CDN suele requerir aplicación de la medida en el proxy/CDN. Evita bloquear indiscriminadamente nodos compartidos.
Failed to execute ban jail 'sshd' action ... 'iptables': si la acción necesita realmente el comando ausente, instala el paquete compatible:
sudo apt install -y iptables
También puede corresponder una acción nftables; instalar iptables no arregla todos los desajustes.
Lista demasiado larga: investiga su crecimiento antes de vaciarla. El segundo comando desbloquea todos los jails, aunque el comentario ilustrativo diga uno:
# 解封单个
sudo fail2ban-client set sshd unbanip 203.0.113.5
# 全部解封某个 jail
sudo fail2ban-client unban --all
Prefiere desbloqueos dirigidos.
Persistencia al reiniciar: muchos paquetes ya utilizan /var/lib/fail2ban/fail2ban.sqlite3. Comprueba dbfile y permisos en fail2ban.conf/fail2ban.local. Este fragmento con estilo de jail no habilita por sí solo una base de datos:
[DEFAULT]
dbpurgeage = 1d
dbpurgeage pertenece a la configuración del daemon. Un día de historial puede ser insuficiente para una política progresiva de una semana; configura una duración apropiada en fail2ban.local y prueba restauración. bantime.increment necesita historial utilizable: no asumas ni que todo reinicio lo borra ni que toda instalación lo conserva bien.
Usuarios bloqueados por error: una IP de oficina, escuela o red móvil puede representar varias personas. Ajusta maxretry hacia arriba o bantime hacia abajo y mantén una exención administrativa limitada.
CrowdSec y recursos: ofrece otros flujos de detección e inteligencia y requiere componentes de aplicación de medidas. Elige según carga y capacidad operativa. Fail2Ban suele tener un proceso Python y base de datos modestos, pero el consumo depende de jails y volumen incluso en un VPS de 1 GB.
- Ajustes en
jail.localo archivos locales, conservandojail.conf. -
bantimeadecuado al riesgo de bloqueo accidental, sin copiar 10m a ciegas. -
bantime.incremente historialdbpurgeagedel daemon verificados. -
ignoreiplimitado y actualizado. -
backend = systemdo fuente de archivos real comprobada. - Fallo conocido probado con
fail2ban-regex. -
iptables -L -n | grep f2bo acción nftables real inspeccionada. - Bloqueo y conexión nueva comprobados desde un cliente de prueba.
-
limitde UFW coordinado deliberadamente. - Puertos privados Docker vinculados a
127.0.0.1cuando corresponda. - Cabeceras
real_ipde confianza y bloqueo en la frontera correcta.