Skip to main content

​
FAQ & Dépannage

​
Configuration & Permissions

Cela arrive quand le rôle de Guardian est en dessous de la position dont il a besoin pour gérer d’autres rôles. Discord exige que le rôle d’un bot soit plus haut dans la hiérarchie que tout rôle qu’il crée ou assigne.Correction :
  1. Allez dans Paramètres du serveur → Rôles
  2. Faites glisser le rôle Guardian Bot en haut de la liste (ou au moins au-dessus de tous les rôles qu’il doit gérer)
  3. Lancez /guardian doctor — il confirmera que la hiérarchie est correcte
Même avec la permission Administrateur, Discord applique la hiérarchie des rôles pour leur gestion. L’Administrateur ne contourne pas cette restriction.
Il s’agit généralement d’un override de permission au niveau du salon qui bloque Guardian dans un salon spécifique. L’Administrateur accorde des permissions à l’échelle du serveur, mais les overrides de salons individuels peuvent nier des permissions même aux admins.Correction :
  1. Allez dans le salon où Guardian est bloqué
  2. Ouvrez Paramètres du salon → Permissions
  3. Trouvez le rôle de Guardian et supprimez les overrides Refuser explicites
  4. Relancez /guardian doctor
Guardian a expiré, généralement parce que :
  • Il manque la permission de créer des salons ou des rôles
  • L’API Discord est lente (réessayez dans quelques minutes)
  • Un conflit de nom existe (un rôle Guardian-Quarantine ou un salon #guardian-logs existe déjà avec de mauvais paramètres)
Correction :
  1. Supprimez les éventuels rôles Guardian-Quarantine et salons #guardian-logs existants
  2. Confirmez que Guardian a la permission Administrateur
  3. Réessayez /setup

​
Anti-Raid & Quarantaine

Ouvrez #guardian-logs (ou votre salon de logs configuré). L’embed de notification de quarantaine a un bouton ”✅ Lever la Quarantaine” — cliquez dessus pour retirer immédiatement le rôle de quarantaine.Alternativement, tout membre du staff avec Gérer les Rôles peut lancer :
/quarantine release @membre
Envisagez d’épingler un message dans votre salon général expliquant que les comptes créés il y a moins de 24 heures seront brièvement en quarantaine. Cela réduit la confusion pour les vrais nouveaux utilisateurs.
Les événements qui attirent beaucoup de nouveaux membres (giveaways, collaborations, going viral) peuvent déclencher la détection de raid. Pour l’éviter :Avant l’événement :
/antiraid mode monitor
Cela maintient toute la détection et la journalisation active mais ne verrouille jamais automatiquement — le staff est alerté mais le serveur reste ouvert.Après l’événement :
/antiraid mode auto
Restaurez la protection automatique complète une fois l’afflux normalisé.
Deux causes fréquentes :
  1. Hiérarchie des rôles — Guardian-Quarantine doit être au-dessus de votre rôle membre par défaut pour pouvoir remplacer les accès aux salons. S’il est en dessous de @everyone, il n’a aucun effet.
  2. Overrides de permissions de salon — si les salons accordent explicitement à @everyone la permission de voir/écrire, le rôle quarantaine ne peut pas l’annuler.
Lancez /guardian doctor pour un diagnostic automatique et des instructions de correction spécifiques.

​
Anti-Phishing & /report

Vérifiez les points suivants :
  1. TrustScore — vous avez besoin d’un score minimum de 20 pour soumettre des signalements. Lancez /trustscore @vous-même pour vérifier votre score.
  2. Cooldown — il y a un délai de 10 minutes entre les signalements. Attendez et réessayez.
  3. Déjà blacklisté — si la cible est déjà dans la Blacklist Globale, vous verrez l’entrée existante plutôt qu’un nouveau signalement créé. C’est le comportement attendu.
  4. Aucun salon de signalement configuré — si /report-config set-channel n’a jamais été lancé, les signalements vont dans #guardian-logs par défaut. Vérifiez ce salon.
Guardian a peut-être signalé le domaine comme phishing dans l’une des trois bases de données. Pour le mettre en whitelist :
/antiphishing whitelist add votre-domaine.com
Si vous pensez qu’il s’agit d’un faux positif dans la base de données elle-même, vous pouvez le signaler directement à PhishTank ou Google Safe Browsing.
Guardian respecte la whitelist immédiatement — aucun redémarrage requis.
Guardian dispose de plusieurs couches de protection anti-abus :
  • TrustScore ≥ 20 — les comptes nouveaux ou peu fiables ne peuvent pas soumettre de signalements
  • Cooldown de 10 minutes — empêche les faux signalements en rafale
  • Exigence de scan de lien — les bans automatiques se déclenchent uniquement quand un lien est confirmé dans une base de données phishing, pas sur une simple accusation textuelle
  • Examen staff — les signalements non confirmés vont toujours au staff ; Guardian ne bannit jamais automatiquement sur la seule base de la description textuelle d’un membre
Un membre ne peut pas faire bannir quelqu’un simplement en le signalant — il doit y avoir un lien malveillant confirmé ou une autorisation du staff.

​
Sauvegarde & Restauration

Si Guardian a détecté la suppression du salon, un bouton de restauration sélective a été automatiquement posté dans #guardian-logs dans les secondes suivant la suppression. Cliquez sur “Restaurer les Salons” dans cet embed.Si le bouton de restauration automatique n’est plus disponible (plus de 60 minutes se sont écoulées) :
/backup list           # Trouver le snapshot le plus récent avant la suppression
/backup restore <id>   # Restaurer depuis ce snapshot
Restaurer une sauvegarde complète recréera salons et rôles depuis le snapshot. Les messages ne sont pas restaurés — seulement la structure du serveur (salons, catégories, rôles, permissions).
Vous avez besoin de la permission Administrateur pour créer des sauvegardes. /backup list est disponible pour quiconque ayant Gérer le Serveur. Vérifiez les permissions de votre rôle.
Guardian ne crée pas de sauvegardes automatiques planifiées — vous contrôlez quand les snapshots sont pris. Nous recommandons :
  • Après toute restructuration majeure de rôles/salons — créez un snapshot avec un label
  • Avant de donner des permissions élevées à un nouvel admin — filet de sécurité en cas de compromission
  • Hebdomadairement pour les communautés actives
Les comptes gratuits ont 3 slots de sauvegarde. Les comptes Pro ont un stockage illimité.

​
Auto-Hébergement

Le healthcheck Docker doit s’authentifier auprès de Redis. Vérifiez que votre docker-compose.yml utilise :
healthcheck:
  test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "ping"]
S’il utilise toujours redis-cli ping sans -a, le check échouera car requirepass est activé. Mettez à jour votre fichier compose et redémarrez le service Redis :
docker compose restart redis
PostgreSQL n’a pas fini de s’initialiser quand le bot démarre. Le depends_on: condition: service_healthy dans docker-compose.yml devrait gérer cela, mais si vous démarrez pour la première fois sur une machine lente :
docker compose up db redis -d    # Démarrer les dépendances d'abord
sleep 10                         # Attendre l'initialisation de PostgreSQL
docker compose up guardian-bot -d
Docker Compose ne recharge pas automatiquement les changements de .env. Redémarrez le service concerné :
docker compose up -d --force-recreate guardian-bot

​
Vous avez Encore Besoin d’Aide ?

Serveur Discord Support

Rejoignez notre serveur de support pour une aide en temps réel de l’équipe et de la communauté.

Issues GitHub

Signalez des bugs ou demandez des fonctionnalités sur GitHub.