Glossaire : les mots techniques d'Agora, expliqués simplement

En bref. Voici, rangés par thème, les mots techniques que tu croiseras dans la documentation et dans Agora, chacun en une ou deux phrases. Tu n'as pas besoin de tout retenir : cherche le mot (Ctrl+F) quand tu en rencontres un que tu ne connais pas.

Agora et ses morceaux #

<!-- CAPTURE C-318 -->

• Agora : le nom du produit. Il a deux côtés : le Hub, que tu installes chez toi, et le site agorapanel.com, chez nous, où tu achètes, gères ta licence et télécharges tes fichiers d'installation.
• Hub : ton site Agora à toi. Il tourne sur ta machine ou chez ton hébergeur et réunit le forum, le MDT, les candidatures, les dons, la carte live et la console de ton serveur de jeu. C'est le mot officiel de cette documentation : « le Hub » désigne toujours ton site, jamais agorapanel.com. Voir Découvrir Agora.
• Mon espace (sur agorapanel.com) : ta zone personnelle sur le site d'Agora : tes licences, tes achats, tes fichiers d'installation et le support. À ne pas confondre avec Mon espace dans le Hub, qui montre ton personnage et la sécurité de ton compte. Voir Acheter une licence.
• Serveur de licences : le service d'Agora (lic1.agorapanel.com et lic2.agorapanel.com) que ton Hub contacte pour valider ta clé et télécharger les mises à jour. Dans les variables d'un panel, il porte le nom trompeur « Hub de licences » : ce n'est pas ton Hub, n'y touche pas.
• Amorçage (boot.mjs) : le petit programme fourni à l'installation. Au premier démarrage, il télécharge Agora contre ta clé, vérifie que le téléchargement est bien signé, prépare la base et lance le Hub. C'est pour cela que l'installation elle-même est très légère.
• Mise en route : l'écran qui s'ouvre tout seul au premier accès à ton Hub : clé de licence, application Discord, puis ton compte devient administrateur. Voir Premier démarrage et mise en route.
• Ressource FiveM agora : l'extension que tu déposes sur ton serveur de jeu. Elle ouvre la tablette et envoie au Hub qui est en ligne. Voir Installer la ressource FiveM agora.
• Tablette : le Hub ouvert à l'intérieur du jeu (commande /agora ou touche F2 par défaut), déjà connecté avec le personnage chargé. Voir Utiliser la tablette.
• MDT : l'ordinateur de bord des services (police, EMS, justice…) : fiches citoyens, mandats, arrestations, rapports. Voir Configurer le MDT.
• Dispatch : la file des appels 911 et des unités en service. Voir Dispatch et 911.

Où Agora tourne : machines, Docker et panels #

• Machine : l'ordinateur sur lequel tourne le Hub. À ne pas confondre avec le serveur de jeu (ton serveur FiveM), même s'ils peuvent être sur la même machine.
• VPS : « serveur privé virtuel », une machine Linux louée chez un hébergeur, que tu administres toi-même.
• NAS : boîtier de stockage réseau (Synology, Asustor…). Ceux qui savent faire tourner Docker peuvent héberger Agora.
• Docker : un outil qui fait tourner un programme dans une « boîte » isolée, identique partout. Voir Installer avec Docker.
• Conteneur et image : le conteneur est la boîte qui tourne ; l'image est le modèle à partir duquel on la crée. Agora n'utilise que des images publiques ordinaires : l'application elle-même est téléchargée au démarrage.
• Docker Compose : l'extension de Docker qui lit un fichier (compose.yml) décrivant plusieurs conteneurs, par exemple Agora et sa base, et les démarre ensemble. Il faut la version 2, dont la commande s'écrit docker compose avec une espace.
• Volume : un dossier géré par Docker où les données survivent aux redémarrages et aux mises à jour. Agora en utilise trois : agora_db, agora_app et agora_data.
• Panel (d'hébergement) : le site web que fournit un hébergeur de jeux pour gérer tes serveurs au clic : démarrer, arrêter, console, fichiers, réglages. Agora fonctionne avec Pterodactyl et Pelican, deux panels libres de la même famille et d'aspect proche, dont les fichiers d'œuf ne sont pas interchangeables.
• Œuf (egg) : un fichier qu'on importe dans un panel et qui lui explique comment installer et démarrer un type de serveur. L'œuf Agora existe en deux versions, une pour Pterodactyl et une pour Pelican : prends celle de ton panel. Voir Installer sur Pelican.
• Nest : dans Pterodactyl, le dossier de rangement des œufs. Pelican n'en a pas : ses œufs sont dans un menu Eggs.
• Nœud (node) : la machine qui fait vraiment tourner les serveurs d'un panel. Le panel n'est que la télécommande.
• Wings : le programme installé sur chaque nœud, qui exécute les ordres du panel. Agora n'exige aucune modification de Wings.
• Allocation : l'adresse IP et le port qu'un panel réserve à un serveur. Pour ouvrir un Hub hébergé sur un panel, tu tapes cette adresse dans ton navigateur. Voir Installer sur Pterodactyl.
• Serveur Node.js d'hébergeur : un serveur « Node.js » vendu par un hébergeur de jeux ordinaire. Tu y déposes un seul fichier, agora.mjs, et Agora installe le reste.
• Node.js : le moteur qui exécute les programmes JavaScript, dont Agora. Il est fourni par l'image ou par le serveur : tu n'as rien à l'installer toi-même.

Se connecter à une machine et déposer des fichiers #

• Terminal (ligne de commande) : une fenêtre où l'on tape des commandes. Sous Windows, ouvre PowerShell ou Terminal ; sous macOS, Terminal.
• SSH : une connexion sécurisée au terminal d'une machine distante, par exemple ssh root@ADRESSE. Ton hébergeur te donne l'adresse et l'identifiant. Sous Windows 10 et 11, la commande ssh est déjà disponible dans PowerShell.
• root et sudo : root est le compte administrateur total d'une machine Linux ; sudo est le préfixe qui lance une commande avec ses droits. Le script d'installation Docker demande l'un ou l'autre.
• SFTP : le transfert de fichiers sécurisé vers une machine, avec un programme comme FileZilla ou WinSCP. Agora peut s'en servir pour déposer la ressource FiveM.
• Gestionnaire de fichiers : l'explorateur de fichiers qu'un panel offre dans le navigateur, sans programme à installer.

Le réseau : adresse, port, HTTPS #

• Adresse IP : le numéro qui identifie une machine sur un réseau. Une adresse publique est joignable depuis Internet ; une adresse locale (souvent 192.168.… ou 10.…) ne marche que chez toi.
• Port : un numéro de « porte » sur une adresse IP, noté après deux-points : IP:3000. Avec Docker, Agora écoute sur le port 3000 par défaut.
• Pare-feu : le filtre qui autorise ou bloque les ports. « Ouvrir un port » veut dire autoriser les visiteurs à y entrer.
• HTTP et HTTPS : HTTPS est la version chiffrée (le cadenas du navigateur), HTTP la version en clair. Agora démarre en http://IP:PORT ; passe en HTTPS dès que le serveur sort des tests.
• Nom de domaine : une adresse lisible comme forum.monserveur.com. C'est facultatif : une adresse IP et un port suffisent pour démarrer.
• Reverse proxy (mandataire inverse) : un programme (Caddy, Nginx, tunnel Cloudflare) placé devant Agora, qui reçoit les visiteurs en HTTPS sur ton domaine et les passe au Hub. Voir Derrière un proxy.

Les bases de données #

• Base de données : le classeur numérique où un programme range ses informations de façon durable.
• PostgreSQL : le type de base qu'utilise le Hub. Agora la fournit et la gère seul. Voir Les deux bases d'Agora.
• MySQL et MariaDB : le type de base qu'utilisent ESX, QBCore et Qbox. MariaDB est une variante compatible de MySQL ; Agora sait lire les deux.
• Base du Hub et base du jeu : les deux bases de ton installation. La première est le carnet d'Agora, la seconde est celle de ton serveur de jeu. Voir Les deux bases d'Agora.
• SQL : le langage des bases de données. Tu n'en écris jamais pour le Hub ; pour la base du jeu, une courte commande à copier-coller crée un utilisateur dédié. Voir Brancher la base du jeu.
• Table : un tableau à l'intérieur d'une base (les personnages, les véhicules…). Les tables qu'Agora ajoute à la base du jeu commencent par agora_.
• Migration : une mise à jour de la structure de la base du Hub, appliquée automatiquement par Agora à chaque mise à jour. Une migration ne se défait pas, c'est pourquoi Agora sauvegarde la base avant.
• Sauvegarde (dump) : une copie de la base dans un fichier, souvent en .sql. Voir Sauvegardes et restauration.
• URL de connexion : l'adresse « tout-en-un » d'une base, de la forme postgresql://utilisateur:motdepasse@hote:5432/base. Seuls les utilisateurs avancés qui apportent leur propre base en ont besoin.<!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre) -->

Les réglages : variables, secrets, clés #

• Variable d'environnement : un réglage passé à un programme au démarrage, au nom en majuscules (AGORA_KEY). Dans un panel, elles s'éditent dans l'onglet Startup du serveur ; avec Docker, dans le fichier .env ; sur un serveur Node.js, dans agora.env. Voir Variables d'environnement.
• Fichier .env : un fichier texte, une variable par ligne. Il contient ta clé de licence : garde-le privé.
• agora.env : l'équivalent du fichier .env sur un serveur Node.js d'hébergeur, posé à côté de agora.mjs.
• Secret : une valeur confidentielle, comme un mot de passe. Ne la partage jamais.
• Token (jeton) : un secret généré par un service pour qu'un programme s'identifie, par exemple le token du bot Discord.
• Clé d'API : un jeton créé dans ton panel pour que d'autres programmes le pilotent. Agora en utilise une pour afficher la console du serveur et déposer la ressource. Voir Console, panel et explorateur de base.

FiveM et ton serveur de jeu #

• Serveur de jeu : ton serveur FiveM, celui où les joueurs se connectent.
• txAdmin : l'outil de gestion livré avec FiveM (redémarrer, voir les joueurs, sanctionner). Agora l'affiche dans Serveur → txAdmin. Voir txAdmin dans Agora.
• Framework : le socle de jeu de rôle de ton serveur, qui gère les personnages, l'argent et les jobs : ESX, QBCore ou Qbox. Agora lit ses données. Voir Frameworks pris en charge.
• Ressource (FiveM) : une extension de ton serveur de jeu : un dossier sous resources/, activé par une ligne ensure nom dans server.cfg.
• server.cfg : le fichier de configuration de ton serveur de jeu. Agora propose un éditeur dans Serveur → Éditeur .cfg. Voir Modifier server.cfg et les permissions.
• OneSync : le mode de FiveM qui gère beaucoup de joueurs et laisse le serveur connaître leurs positions. ESX Legacy, QBCore récent et Qbox l'exigent déjà ; la carte live s'en sert.
• ACE : le système de permissions de FiveM : une ligne add_ace donne un droit à un groupe, une ligne add_principal fait entrer un joueur ou un groupe dans un autre groupe.
• Licence FiveM et clé Cfx.re : trois « clés » existent et ne se confondent pas. La licence FiveM d'un joueur est son identifiant unique (license:…) : c'est elle qui sert à relier son jeu. La clé du serveur (sv_licenseKey) identifie ton serveur chez Cfx.re, l'éditeur de FiveM. La clé de licence Agora (AGORA-…) est celle de ton achat ou de ton essai.

Discord #

• Application Discord : ce que tu crées dans le portail des développeurs de Discord. Elle permet à tes membres de se connecter avec Discord et peut porter le bot. Voir Relier Discord.
• OAuth : la façon standard de « se connecter avec Discord » : Discord confirme à Agora qui tu es, sans mot de passe. Agora ne demande que ton identité et ton courriel.
• URL de redirection : l'adresse où Discord renvoie le membre après sa connexion. Elle doit être déclarée chez Discord au caractère près.
• Client ID et Client Secret : l'identifiant public de ton application (« Application ID » dans le portail) et son secret (« Reset Secret »).
• Bot : le compte automatisé de ton application. Il donne les rôles Discord de tes groupes et envoie les messages privés. Il est facultatif. Voir Créer et configurer ton bot Discord.
• Intent (Server Members Intent) : une case à activer dans le portail pour autoriser le bot à voir la liste des membres du serveur. Elle est nécessaire à la synchronisation des rôles.
• Serveur Discord (guild) et son ID : « guild » est le nom technique d'un serveur Discord. Son ID est un long nombre que tu copies avec le mode développeur de Discord activé.
• Webhook : une adresse secrète qui permet à un programme d'envoyer un message dans un salon Discord. Voir Webhooks sortants.
• 2FA (double authentification) : une vérification en plus du mot de passe, par exemple un code sur ton téléphone. Voir Exiger la double authentification du staff.

La licence #

• Clé de licence : le code AGORA-XXXX-… qui identifie ton achat ou ton essai. Agora la lit dès le premier démarrage. Voir Activer ou changer de clé.
• Essai : la clé gratuite de 14 jours, au palier Basic. Voir L'essai gratuit.
• Palier (Basic, Pro) : le niveau de ta licence. Basic ouvre le MDT et les outils de jeu de rôle ; Pro ajoute le panel, la console, l'explorateur de base et le canal bêta. Le forum reste toujours gratuit. Voir Les paliers Basic et Pro.
• Siège : la place qu'occupe une installation sur une clé. Une clé n'a qu'un siège : une seule installation à la fois. Voir Libérer un siège.
• Bail : l'autorisation signée, valable plusieurs jours, que le serveur de licences remet à ton installation. C'est lui qui permet de fonctionner sans contact permanent. Voir Sans accès au serveur de licences.
• Période de grâce et verrouillé : les deux états qui suivent la fin d'une licence. Pendant la grâce, tout fonctionne encore ; une fois verrouillé, seul le forum reste ouvert. Voir Comprendre l'état de ta licence.
• Jeton signé : un texte signé que le support peut te remettre pour qu'un serveur qui reste longtemps coupé du réseau garde sa licence.
• Signature et empreinte : la signature prouve qu'un fichier vient bien d'Agora ; l'empreinte est un résumé court du fichier, qui permet de vérifier qu'il n'a pas été modifié. Agora contrôle les deux avant d'installer quoi que ce soit.
• Canal (stable ou bêta) : le flux de mises à jour que tu suis. Le canal bêta, réservé au palier Pro, donne des versions de test.
• Mise à jour en un clic : le bouton de Administration → Agora qui sauvegarde, télécharge, vérifie, met à jour et redémarre. Voir Mettre à jour Agora en un clic.

Pour aller plus loin #

• Ton premier jour avec Agora range les étapes dans l'ordre.
• Les deux bases d'Agora explique ce que contient chaque base.