Voltar às atualizações
New releaseJul 31, 2026

Sirius v1.1.0

Scanner de vulnerabilidades de código aberto com descoberta automatizada de rede, detecção baseada em CVE, pontuação CVSS, painéis de risco, agentes remotos via gRPC e uma interface web moderna para equipes de segurança empresarial.

Compartilhar

Sirius Scan

CI Release Registry License: MIT Discord

Sirius Scan Dashboard

Sirius é um scanner de vulnerabilidades de código aberto com descoberta automatizada, detecção baseada em CVE e uma interface web moderna. Clone o repositório, configure o certificado TLS do agente e comece a escanear.

Início Rápido

Antes de iniciar a stack, provisione o certificado e a chave do servidor do agente conforme descrito em Agent gRPC TLS configuration. O instalador não os cria.

git clone https://github.com/SiriusScan/Sirius.git
cd Sirius
docker compose -f docker-compose.installer.yaml run --rm sirius-installer
docker compose up -d

Abra http://localhost:3000 e faça login:

Email[email protected]
Senhaimpressa pelo instalador (procure por INITIAL_ADMIN_PASSWORD na saída)

Todos os seis serviços iniciam automaticamente assim que a configuração necessária estiver presente. O instalador gera os segredos da aplicação na primeira execução e pode ser executado novamente com segurança.

Por padrão, o instalador deixa IMAGE_TAG sem definir, então o Compose baixa a tag latest do GHCR. Para fixar uma versão (por exemplo, v1.0.0 no .env), faça isso somente depois que essa tag existir para todas as seis imagens de contêiner; verifique com bash scripts/verify-ghcr-public-access.sh v1.0.0 a partir de um shell que não esteja autenticado no ghcr.io.

Requisitos: Docker Engine 20.10+ com Compose V2, 4 GB de RAM, 10 GB de disco. Funciona em Linux, macOS e Windows (WSL2).

O que o Sirius faz

  • Descoberta de Rede -- enumeração automatizada de hosts e serviços via Nmap
  • Detecção de Vulnerabilidades -- varredura baseada em CVE com pontuação CVSS
  • Painéis de Risco -- progresso de varredura em tempo real, tendências de severidade e orientações de remediação
  • Agentes Remotos -- varredura distribuída em múltiplos ambientes via gRPC
  • Terminal Interativo -- console PowerShell para scripts e automação avançados
  • API REST -- integração com fluxos de trabalho de segurança existentes (autenticação X-API-Key na porta 9001)

Opções de Implantação

A etapa do instalador é sempre a mesma. Apenas o comando docker compose up muda.

ModoComandoCaso de uso
Padrãodocker compose up -dA maioria dos usuários -- baixa a pilha completa de release do GHCR
Desenvolvimentodocker compose -f docker-compose.yaml -f docker-compose.dev.yaml up -dRecarregamento ao vivo para trabalho local no código
Compilação a partir do Código-Fontedocker compose -f docker-compose.yaml -f docker-compose.build.yaml up -d --buildCompilações locais explícitas de toda a pilha
Produçãodocker compose -f docker-compose.yaml -f docker-compose.prod.yaml up -dConfigurações reforçadas, pull_policy: always

Configuração não interativa (CI / Terraform / automação)

docker compose -f docker-compose.installer.yaml run --rm sirius-installer --non-interactive --no-print-secrets
docker compose up -d

Rotacionar segredos

docker compose -f docker-compose.installer.yaml run --rm sirius-installer --force
docker compose up -d --force-recreate

Verificar a Instalação

docker compose ps                    # all 6 services should show "healthy" or "running"
curl http://localhost:3000            # UI responds
curl http://localhost:9001/health     # API responds

Serviços esperados: sirius-ui (3000), sirius-api (9001), sirius-engine (5174, 50051), sirius-postgres (5432), sirius-rabbitmq (5672, 15672), sirius-valkey (6379).

Arquitetura

graph TD
    subgraph clients [Clients]
        UI["Sirius UI (Next.js)"]
        CLI["Terminal and Agent Runtime"]
    end

    subgraph core [Core Services]
        API["Sirius API (Go/Gin)"]
        Engine["Sirius Engine"]
    end

    subgraph infra [Infrastructure]
        MQ["RabbitMQ"]
        DB["PostgreSQL"]
        Cache["Valkey"]
    end

    UI -->|"HTTP/WebSocket"| API
    CLI -->|"gRPC"| Engine
    API -->|"AMQP publish"| MQ
    MQ -->|"Queue consume"| Engine
    API -->|"SQL read/write"| DB
    Engine -->|"SQL read/write"| DB
    API -->|"Session/cache ops"| Cache
    Engine -->|"Scan state cache ops"| Cache
ServiçoTecnologiaPortasFinalidade
sirius-uiNext.js 14, React, Tailwind3000Interface web
sirius-apiGo, Gin9001API REST e lógica de negócios
sirius-engineGo + agente gRPC embutido5174, 50051Scanner, terminal, serviços de agente
sirius-postgresPostgreSQL 155432Dados de vulnerabilidades e varreduras
sirius-rabbitmqRabbitMQ5672, 15672Mensageria entre serviços
sirius-valkeyValkey (compatível com Redis)6379Dados de cache e sessão

Interface

PainelScannerNavegador de Vulnerabilidades
PainelScannerVulnerabilidades
AmbienteDetalhes do HostTerminal
AmbienteHostTerminal

API

O Sirius expõe endpoints REST na porta 9001, protegidos pela chave de API do serviço interno. Prefira o arquivo de segredo do Docker (SIRIUS_API_KEY_FILE, padrão /run/secrets/sirius_api_key); SIRIUS_API_KEY continua sendo um fallback de variável de ambiente suportado. O instalador grava ./secrets/sirius_api_key.txt (modo 0644 para que UIDs de aplicativos não-root possam ler o segredo montado via bind) e configura ambos.

curl http://localhost:9001/health -H "X-API-Key: $SIRIUS_API_KEY"
curl http://localhost:9001/api/v1/scan/get/all -H "X-API-Key: $SIRIUS_API_KEY"

Documentação completa da API: Referência da API REST

Recomendações de Segurança

Para implantações em produção:

  1. Rotacione os segredos -- execute o instalador com --force para regenerar todas as credenciais
  2. Restrinja as portas -- exponha apenas a porta 3000 (UI); mantenha 5432, 6379, 5672 internas
  3. Use um proxy reverso -- coloque nginx ou Traefik à frente com TLS
  4. Mantenha as imagens atualizadas -- docker compose pull && docker compose up -d

Solução de Problemas

Correções rápidas para problemas comuns:

Categorias