TheDuffman85/crowdsec-web-ui

O que é?

Recursos principais

• 01Histórico de alertas pesquisável, com contexto do CrowdSec e detalhes de IP, AS e localização
• 02Gerenciamento de decisões ativas e expiradas, incluindo bloqueios manuais com durações personalizadas
• 03Conexão com várias LAPIs do CrowdSec e visualização de escopo combinado
• 04Visualizações opcionais de métricas do Prometheus para LAPI, bouncers, AppSec e parsers
• 05Regras de notificação enviadas por Email, Gotify, MQTT, ntfy ou webhooks
• 06Login com senha, TOTP, passkey e SSO via OIDC, com funções baseadas em grupos

Casos de uso

• Operadores que executam o CrowdSec em vários servidores e querem um único dashboard para todas as LAPIs
• Equipes que precisam revisar alertas e bloquear ou desbloquear IPs manualmente sem usar a linha de comando
• Administradores de homelabs ou equipes pequenas que querem receber notificações push sobre novos alertas e decisões
• Organizações que integram o acesso ao CrowdSec a um provedor de identidade OIDC existente

Início rápido

1. 1

   Gere uma senha aleatória com openssl

   openssl rand -hex 32
2. 2

   Registre a Web UI como uma máquina no seu contêiner do CrowdSec

   docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null
3. 3

   Inicie a Web UI com Docker Compose usando o arquivo docker-compose.yml incluído

   docker compose up -d
4. 4

   Abra http://localhost:3000 no navegador e crie a conta inicial de administrador

Antes de usar

• !Você precisa de um CrowdSec LAPI em execução para se conectar.
• !Licenciado sob a AGPL-3.0, uma licença de copyleft forte.
• !Implantações públicas devem ficar atrás de HTTPS e de um proxy reverso reforçado, pois o aplicativo não gerencia TLS.
• !Instalações migradas anteriores à autenticação permanecem sem autenticação até que você a habilite.

Em coleções

Tópicos

Perguntas frequentes

O que é crowdsec-web-ui?

Dashboard web self-hosted para CrowdSec que permite investigar alertas, gerenciar decisões, consultar métricas de execução e enviar notificações. O CrowdSec Web UI é um dashboard self-hosted que se conecta a uma ou mais Local APIs (LAPIs) do CrowdSec. Ele permite que operadores consultem o histórico de alertas com busca e filtros rápidos, inspecionem o contexto do CrowdSec por trás de cada alerta e visualizem decisões ativas e expiradas. É possível adicionar bloqueios manuais com durações e motivos personalizados, além de executar ações de limpeza na mesma interface.

crowdsec-web-ui é gratuito? Qual é a licença?

crowdsec-web-ui é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

crowdsec-web-ui ainda é mantido?

Manutenção ativa. O último commit de crowdsec-web-ui foi em 6 de nov. de 2026.

Para que posso usar crowdsec-web-ui?

Operadores que executam o CrowdSec em vários servidores e querem um único dashboard para todas as LAPIs Equipes que precisam revisar alertas e bloquear ou desbloquear IPs manualmente sem usar a linha de comando Administradores de homelabs ou equipes pequenas que querem receber notificações push sobre novos alertas e decisões Organizações que integram o acesso ao CrowdSec a um provedor de identidade OIDC existente

Como instalar crowdsec-web-ui?

Gere uma senha aleatória com openssl: openssl rand -hex 32 Registre a Web UI como uma máquina no seu contêiner do CrowdSec: docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null Inicie a Web UI com Docker Compose usando o arquivo docker-compose.yml incluído: docker compose up -d Abra http://localhost:3000 no navegador e crie a conta inicial de administrador

Onde consigo crowdsec-web-ui?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/TheDuffman85/crowdsec-web-ui