cs-firewall-bouncer-docker
Imagen Dockerizada del CrowdSec Firewall Bouncer basada en Alpine Linux para protección de redes locales mediante integración con APIs externas y automatización de actualizaciones de seguridad.
Ficha actualizada 24 sept 2026, 0:20 · upstream 24 sept 2026, 0:13 · release v0.0.37
Qué es cs-firewall-bouncer-docker
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una implementación contenerizada del CrowdSec Firewall Bouncer, herramienta diseñada para gestionar reglas de firewall basadas en inteligencia colectiva. La imagen se construye sobre Alpine Linux y permite ejecutar el binario crowdsec-firewall-bouncer dentro de un entorno Docker con configuración sustituida mediante variables de entorno.
El sistema implementa un flujo de releases robusto que sincroniza automáticamente las versiones upstream, gestionando canales estables (vX.Y.Z), candidatos a release (vX.Y.Z-rcN) y parches de imagen (vX.Y.Z+patchN). Cada publicación incluye pruebas de humo en ambas arquitecturas antes del commit, garantizando estabilidad operativa. El proceso ignora inconsistencias en los marcadores prerelease de GitHub para mantener consistencia entre canales.
La configuración se realiza mediante un archivo YAML montado en /config/crowdsec-firewall-bouncer.yaml donde los placeholders ${VAR} se sustituyen con valores de entorno del contenedor usando envsubst. Esto permite una gestión flexible de credenciales API y parámetros sin recompilar la imagen.
- Protección de redes locales mediante reglas de firewall gestionadas por CrowdSec
- Integración con APIs externas para sincronización de listas de IPs maliciosas
- Despliegue en entornos Docker con network_mode: host para compatibilidad iptables/nftables
- Automatización de actualizaciones de seguridad mediante canales estables y candidatos
- Sistema automatizado de releases que gestiona versiones upstream, canales y checksums SHA256 por arquitectura
- Pruebas de humo obligatorias antes de cada commit con ejecución en amd64 y verificación arm64
- Configuración flexible mediante variables de entorno con sustitución automática de placeholders
- Soporte multi-arquitectura (amd64/arm64) con construcción independiente por plataforma
- Requiere network_mode: host que limita la portabilidad entre entornos Docker aislados
- Necesita capacidades especiales NET_ADMIN y NET_RAW para funcionamiento correcto del firewall
- Dependencia de RELEASE_TOKEN (PAT con scope contents:write) para automatización de releases en GitHub
- No incluye Docker Compose nativo, solo proporciona ejemplo de configuración
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar la imagen ghcr.io/shgew/cs-firewall-bouncer-docker:stable. Montar el archivo de configuración en /config/crowdsec-firewall-bouncer.yaml con permisos ro. Configurar network_mode: host y añadir capacidades NET_ADMIN, NET_RAW. Definir variables API_URL y API_KEY en el entorno del contenedor. Verificar que Docker Engine use iptables por defecto o configurar nftables experimentalmente si es necesario.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.