Tous les tutoriels
ArchiveForge

Tutoriel

ArchiveForge

Version 1.5.0 · Mis à jour le 8 octobre 2026

ArchiveForge permet d'exporter un serveur Discord complet vers une archive consultable hors ligne, en HTML ou JSON. Le tutoriel décrit l'installation du service avec Docker, la création du premier compte et l'utilisation des principales fonctions d'export, de visualisation et de clonage. Vous apprendrez également à gérer les comptes et à récupérer une archive.

Site officiel

Ce qu'il faut

  • Docker et Docker Compose installés
  • Un bot Discord avec les intents Server Members et Message Content activés
  • Un domaine pointant vers le serveur (pour HTTPS)

Installation

Docker

  1. 1Cloner le dépôt : git clone https://github.com/Heiphaistos/ArchiveForge.git && cd ArchiveForge
  2. 2Copier le fichier d'exemple et le remplir : cp .env.example .env puis éditer les variables DISCORD_TOKEN, NEXTAUTH_SECRET, NEXTAUTH_URL et éventuellement SETUP_TOKEN
  3. 3Lancer les conteneurs : docker compose up -d
  4. 4Vérifier que le portail est accessible sur le port indiqué (par défaut 3009) en ouvrant http://localhost:3009

Premier lancement

  1. 1Ouvrir le navigateur à l'adresse du portail (ex. https://votre-domaine.com)
  2. 2Accéder à /setup, saisir le jeton affiché dans les logs du conteneur web et créer le compte administrateur
  3. 3Se connecter, activer la 2FA avec une application TOTP et noter les 10 codes de secours
ArchiveForge sur ordinateur
ArchiveForge sur ordinateur

exporter un serveur Discord

Cette opération crée une archive ZIP contenant les données du serveur.

  1. 1Dans le tableau de bord, cliquer sur « Nouvelle export ».
  2. 2Saisir l'ID du serveur Discord à archiver.
  3. 3Choisir le format d'export (SPA Viewer, HTML statique ou JSON).
  4. 4Lancer le job et suivre la progression via la barre qui se met à jour toutes les 3 s.
  5. 5Une fois terminé, télécharger le fichier ZIP depuis le bouton « Télécharger ».

visualiser l'archive en ligne

Le format SPA Viewer permet de parcourer l'archive sans serveur supplémentaire.

  1. 1Décompresser le ZIP téléchargé.
  2. 2Ouvrir le fichier index.html dans un navigateur.
  3. 3Utiliser la barre de recherche pour trouver des messages ou des pièces jointes.
  4. 4Cliquer sur un fil de discussion pour afficher les réponses imbriquées.

cloner un serveur vers ForgeChat

Le clone crée un nouveau serveur Discord avec les mêmes salons et rôles.

  1. 1Dans le tableau de bord, choisir « Cloner vers ForgeChat ».
  2. 2Sélectionner l'archive précédemment exportée.
  3. 3Indiquer le token du bot du serveur cible et valider.
  4. 4Attendre que le job de clonage se termine, le statut apparaît en vert lorsqu'il est fini.

importer une archive JSON dans le portail

L'import permet de réintégrer les données dans l'interface web pour les analyser.

  1. 1Cliquer sur « Importer » dans le menu.
  2. 2Uploader le fichier JSON brut de l'archive.
  3. 3Choisir le mode d'affichage souhaité (SPA ou HTML).
  4. 4Valider l'import et attendre le traitement (progression affichée).

gérer les utilisateurs

Les comptes sont créés par un administrateur et requièrent la 2FA.

  1. 1Dans le tableau de bord, ouvrir la section « Utilisateurs ».
  2. 2Cliquer sur « Créer un utilisateur », saisir un identifiant et un mot de passe provisoire.
  3. 3Le nouvel utilisateur se connecte, active la 2FA et change son mot de passe.
  4. 4En cas de perte du téléphone, utiliser un des codes de secours ou demander à un admin de réinitialiser la 2FA.

mettre à jour le service

Les mises à jour se font via Git et le redémarrage des conteneurs.

  1. 1Se placer dans le répertoire ArchiveForge sur le serveur.
  2. 2Exécuter git pull pour récupérer les dernières modifications.
  3. 3Redémarrer les conteneurs : docker compose up -d --force-recreate.

En images

ArchiveForge sur téléphone
ArchiveForge sur téléphone

Astuces

  • Utilisez un token de bot avec les intents privilégiés pour éviter les erreurs d'autorisation.
  • Surveillez les logs du conteneur web (docker compose logs web) pour récupérer le jeton de configuration initial.
  • Activez la vérification des liens CDN morts dans les paramètres du portail pour nettoyer les archives.

Questions fréquentes

Pourquoi les messages privés ne sont-ils pas exportés ?

L'API Discord ne permet pas d'accéder aux MP via un bot, c'est une limitation technique.

Combien de temps prend l'export d'un grand serveur ?

Pour plus de 500 000 messages, l'opération peut durer plusieurs heures selon la charge du serveur et les limites de taux.

Comment récupérer un jeton d'administration si je l'ai perdu ?

Redémarrez le conteneur web et consultez les logs : docker compose logs web | grep jeton.

Tutoriel rédigé automatiquement à partir de la documentation du projet, mis à jour à chaque évolution.