Skip to main content

​
Guide de Démarrage

1
Invitez Guardian sur votre serveur
2
Cliquez sur le bouton ci-dessous et sélectionnez votre serveur. Le bot nécessite les permissions suivantes — ne décochez aucune d’entre elles.
3
4
Guardian nécessite la permission Administrateur lors de la configuration initiale pour créer rôles et salons. Une fois le setup terminé, vous pouvez réduire les permissions à la liste minimale (voir Permissions Minimales ci-dessous).
5
Lancez /setup
6
Dans n’importe quel salon où Guardian peut écrire, tapez :
7
/setup
8
Guardian va automatiquement :
9
  • Créer le rôle Guardian-Quarantine (aucune permission — restreint les nouveaux comptes)
  • Créer le salon privé #guardian-logs pour le staff
  • Configurer les seuils de détection de raid multi-fenêtres
  • Se connecter aux bases de données anti-phishing (PhishTank, Google Safe Browsing, VirusTotal)
  • Activer le système de quarantaine pour les comptes de moins de 24 heures
    • 10
    L’intégralité du processus prend moins de 5 secondes.
    11
    Lancez /guardian doctor après le setup pour vérifier que chaque composant est opérationnel et que la hiérarchie des rôles est correcte.
    12
    Vérifiez avec /guardian health
    13
    /guardian health
    14
    Vous devriez voir un Score de Sécurité supérieur à 80/100. Si un module affiche un avertissement, la commande doctor vous indiquera exactement quoi corriger.

    ​
    Ce qui se passe ensuite (Automatiquement)

    Une fois /setup terminé, vous n’avez plus rien à faire. Guardian travaille silencieusement en arrière-plan :
    ÉvénementRéponse de Guardian
    Membre rejoint avec un compte < 24 hRôle quarantaine appliqué immédiatement
    Raid détecté (jointures rapides multiples)Verrouillage déclenché ; membres suspects signalés
    Membre poste un lien phishingMessage supprimé ; membre averti ou banni
    Membre soumet /report avec un lien confirméGlobal Ban instantané sur tout le réseau
    Admin supprime des salons rapidementSnapshot déclenché ; bouton de restauration envoyé au staff

    ​
    Permissions Minimales

    Après la configuration initiale, vous pouvez restreindre les permissions de Guardian à :
    PermissionPourquoi c’est nécessaire
    Gérer les RôlesAppliquer/retirer le rôle quarantaine
    Gérer les SalonsRestaurer les salons supprimés depuis les snapshots
    Bannir des MembresExécuter le Global Ban quand le phishing est confirmé
    Expulser des MembresRetirer les membres en quarantaine qui échouent la vérification
    Voir les SalonsSurveiller tous les salons pour détecter les liens phishing
    Envoyer des MessagesPoster les alertes et les embeds
    Intégrer des LiensEmbeds d’alerte enrichis
    Lire l’historique des messagesScanner les messages récents lors d’une jointure
    L’Administrateur n’est requis que pendant /setup pour créer la structure initiale de rôles/salons. Vous pouvez le retirer immédiatement après.

    ​
    Auto-Hébergement Docker (Optionnel)

    Si vous préférez héberger Guardian vous-même : 
    # 1. Cloner le dépôt
git clone https://github.com/your-org/guardianbot.git && cd guardianbot

# 2. Configurer l'environnement
cp .env.example .env
nano .env   # Remplissez au minimum DISCORD_TOKEN et DB_PASSWORD

# 3. Démarrer tous les services
docker compose up -d

# 4. Vérifier les logs
docker compose logs -f guardian-bot
    Définissez un REDIS_PASSWORD et un DB_PASSWORD forts dans votre .env avant de démarrer. Les valeurs par défaut dans .env.example sont des espaces réservés uniquement.
    Les seuls ports exposés sur Internet sont 80 et 443 (Nginx). Tout le reste — le bot, le dashboard, Redis, PostgreSQL — communique sur un réseau Docker interne isolé.