Sirius Scan

Sirius est un scanner de vulnérabilités open-source avec découverte automatique, détection basée sur les CVE et une interface web moderne. Clonez, exécutez quatre commandes, commencez à scanner.

Démarrage rapide

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

Ouvrez http://localhost:3000 et connectez-vous :

C'est tout. Les six services démarrent automatiquement. L'installateur génère des secrets sécurisés lors du premier lancement et peut être relancé sans risque.

Par défaut, l'installateur ne définit pas IMAGE_TAG, donc Compose tire latest depuis GHCR. Pour épingler une version (par exemple v1.0.0 dans .env), ne le faites qu'après que ce tag existe pour les six images conteneur ; vérifiez avec bash scripts/verify-ghcr-public-access.sh v1.0.0 depuis un shell qui n'est pas connecté à ghcr.io.

Prérequis : Docker Engine 20.10+ avec Compose V2, 4 Go de RAM, 10 Go de disque. Fonctionne sur Linux, macOS et Windows (WSL2).

Ce que fait Sirius

• Découverte réseau — énumération automatique des hôtes et services via Nmap
• Détection de vulnérabilités — scanning basé sur les CVE avec score CVSS
• Tableaux de bord des risques — progression en temps réel des scans, tendances de sévérité et conseils de correction
• Agents distants — scanning distribué sur plusieurs environnements via gRPC
• Terminal interactif — console PowerShell pour scripts avancés et automatisation
• API REST — intégration avec les workflows de sécurité existants (authentification X-API-Key sur le port 9001)

Options de déploiement

L'étape de l'installateur est toujours la même. Seule la commande docker compose up change.

Installation non interactive (CI / Terraform / automatisation)

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

Rotation des secrets

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

Vérifier l'installation

docker compose ps                    # les 6 services doivent afficher "healthy" ou "running"
curl http://localhost:3000            # l'interface répond
curl http://localhost:9001/health     # l'API répond

Services attendus : sirius-ui (3000), sirius-api (9001), sirius-engine (5174, 50051), sirius-postgres (5432), sirius-rabbitmq (5672, 15672), sirius-valkey (6379).

Architecture

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

Interface

Tableau de bord	Scanner	Navigateur de vulnérabilités

Environnement	Détails de l'hôte	Terminal

API

Sirius expose des points de terminaison REST sur le port 9001, protégés par la clé API de service interne. Préférez le fichier secret Docker (SIRIUS_API_KEY_FILE, par défaut /run/secrets/sirius_api_key) ; SIRIUS_API_KEY reste une variable d'environnement de repli prise en charge. L'installateur écrit ./secrets/sirius_api_key.txt (mode 0644 pour que les UID d'applications non-root puissent lire le secret monté en bind) et configure les deux.

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"

Documentation complète de l'API : Référence API REST

Recommandations de sécurité

Pour les déploiements en production :

1. Rotation des secrets — exécutez l'installateur avec --force pour regénérer tous les identifiants
2. Restreindre les ports — n'exposez que le port 3000 (interface) ; gardez 5432, 6379, 5672 en interne
3. Utiliser un proxy inverse — placez nginx ou Traefik devant avec TLS
4. Maintenir les images à jour — docker compose pull && docker compose up -d

Dépannage

Solutions rapides pour les problèmes courants :

Pour les manuels opérationnels détaillés, les procédures de vérification et la récupération d'urgence, voir Opérations & Dépannage.

Contribuer

Voir CONTRIBUTING.md pour la configuration de développement, les normes de codage et les directives pour les PR.

Liens rapides : Problèmes | Discussions | Discord

Pour aller plus loin

• Guide d'installation
• Visite de l'interface
• Guide de scanning
• Architecture Docker
• Architecture système
• Guide CI/CD
• Opérations & Dépannage

Licence

MIT